Eidos: Git-Native AI Software Development Ecosystem

Eidos is an open, Git-native, agent-agnostic development framework designed to unify product definition, architectural invariants, and autonomous coding agents under executable living specifications.

This repository dogfoods the Eidos Specification Standard to define Eidos itself.

Quickstart

# Install with uv (recommended)
uv add --dev eidos-ai

# Or with pip
pip install eidos-ai

# Initialize Eidos in your repository
eidos init

# Synchronize knowledge graph index
eidos index sync

# Validate living specifications
eidos validate eidos

# Verify zero drift between code and living specs
eidos drift

# Launch interactive C4 architecture portal
eidos portal serve --path eidos --port 8080

# Install AI agent plugin (14 skills for Antigravity, Claude, Cursor, Copilot)
eidos plugin install --target all

Repository Architecture

eidos/
├── pyproject.toml                 # Modern Python package definition (eidos-ai on PyPI)
├── zensical.toml                  # Zensical documentation site configuration
│
├── src/eidos/                     # [THE ENGINE / SOLUTION]
│   ├── cli/                       # CLI commands (`eidos validate`, `eidos drift`, `eidos delta`, etc.)
│   ├── core/                      # AsciiDoc + YAML frontmatter parser & schema validator
│   ├── plugin/                    # Agent plugin packager, validator, and installer (14 skills)
│   ├── portal/                    # Interactive Living Architecture static portal generator
│   ├── vcs/                       # Git spec-to-code drift detection & reconciliation engine
│   └── schemas/v1/                # Portable JSON/YAML Schemas bundled as package data
│
├── eidos/                         # [THE LIVING SPECIFICATION / REAL USAGE]
│   ├── system.adoc                # Root system descriptor
│   ├── personas/                  # Human & AI actor roles
│   ├── policies/                  # Non-negotiable architectural invariants (POL-*)
│   ├── domains/                   # Bounded contexts & capabilities (CAP-*)
│   ├── architecture/              # System architecture, components, & contracts
│   └── deltas/                    # In-flight and applied mutations (DLT-*)
│
├── docs/                          # User documentation site (Zensical)
└── tests/                         # Engine & specification test suites

Key Distinctions from Existing Tools

Navigating the Specifications

• Root System: eidos/system.adoc
• Product Domains:
  • Spec Engine Domain
  • Agent Intelligence Domain
  • VCS Lifecycle Domain
  • Experience Portal Domain
• Policies:
  • POL-001: Git Source of Truth
  • POL-002: Invariant Test Enforcement
• Technical Architecture:
  • Global System Architecture
  • Containers Directory
  • Contracts Directory
• SpecDeltas:
  • SpecDeltas Directory

Documentation & Living Portal

• User Documentation: https://mchawa.github.io/eidos/
• Interactive Living Architecture Portal: https://mchawa.github.io/eidos/portal/
• PyPI Package: https://pypi.org/project/eidos-ai/
• AI Agent Plugin Guide: https://mchawa.github.io/eidos/guides/agent-plugin/

License

Licensed under the MIT License.