eidos-ai 0.1.0

= Eidos: Git-Native AI Software Development Ecosystem
:toc: left
:icons: font
:source-highlighter: highlight.js

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

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

== Repository Architecture

[source,text]
----
eidos/
├── pyproject.toml                 # Modern Python package definition (uv/hatchling)
│
├── src/eidos/                     # [THE ENGINE / SOLUTION]
│   ├── cli/                       # CLI commands (`eidos validate`, `eidos delta`, etc.)
│   ├── core/                      # AsciiDoc + YAML frontmatter parser & validator
│   ├── agent/                     # Pluggable agent adapters (agy, claude, codex)
│   ├── vcs/                       # GitHub & GitLab sync engine
│   └── schemas/v1/                # Portable JSON/YAML Schemas bundled as package data
│       ├── product/               # Product definition schemas
│       │   ├── system.schema.yaml
│       │   ├── domain.schema.yaml
│       │   ├── capability.schema.yaml
│       │   ├── policy.schema.yaml
│       │   ├── persona.schema.yaml
│       │   └── exploration.schema.yaml
│       ├── tech/                  # Technical architecture schemas
│       │   ├── architecture.schema.yaml
│       │   ├── component.schema.yaml
│       │   └── contract.schema.yaml
│       └── delta/                 # Mutation & evolution schemas
│           └── delta.schema.yaml
│
├── eidos/                         # [THE LIVING SPECIFICATION / REAL USAGE]
│   ├── system.adoc                # Root system descriptor
│   ├── personas/                  # Human & AI actor roles
│   ├── policies/                  # Non-negotiable architectural invariants
│   ├── domains/                   # Bounded contexts & capabilities
│   ├── architecture/              # System architecture, components, & contracts
│   └── deltas/                    # In-flight and applied mutations
│
└── tests/                         # Engine & specification test suites
----

== Key Distinctions from Existing Tools

[cols="1,2,2", options="header"]
|===
| Dimension | Traditional / Existing Tools | Eidos Approach
| **Scope** | Coding loop only (Aider, Claude Code) or monolithic bot (Devin) | Full SDLC: Exploration -> Product Baseline -> SpecDelta -> Code -> CI
| **Specifications** | Ephemeral Jira tickets, stale Confluence/Notion pages | Versioned YAML frontmatter + AsciiDoc living in Git
| **Change Management** | Narrative RFC essays that rot in archive folders | Declarative `SpecDelta` mutations applied automatically upon merge
| **Agent Support** | Vendor-locked to a single proprietary LLM | Pluggable adapter layer supporting `agy`, Claude Code, Codex, Copilot
| **VCS Support** | GitHub-only or closed web UI | Native bidirectional support for both GitHub and GitLab
|===

== Navigating the Specifications

* **Root System**: Link to link:file://eidos/system.adoc[`system.adoc`]
* **Product Domains**:
** Link to link:file://eidos/domains/product-core/domain.adoc[`Product Intelligence Domain`]
** Link to link:file://eidos/domains/agent-harness/domain.adoc[`Agent Harness Domain`]
** Link to link:file://eidos/domains/vcs-sync/domain.adoc[`VCS Sync Domain`]
* **Policies**:
** Link to link:file://eidos/policies/POL-001-git-as-single-source-of-truth.adoc[`POL-001: Git Source of Truth`]
** Link to link:file://eidos/policies/POL-002-invariant-test-enforcement.adoc[`POL-002: Invariant Test Enforcement`]
* **Technical Architecture**:
** Link to link:file://eidos/architecture/system-architecture.adoc[`Global System Architecture`]
** Link to link:file://eidos/architecture/components/engine.adoc[`Component: Eidos Engine`]
** Link to link:file://eidos/architecture/contracts/cli.adoc[`Contract: Eidos CLI`]

== License

Licensed under the link:LICENSE[MIT License].