INDEX.md

YAI Documentation Index

Official Reading Path

1. Documentation/README.md
2. Documentation/INDEX.md
3. Documentation/architecture/overview.md
4. Documentation/architecture/system-boundary.md
5. Documentation/architecture/repository-boundaries.md
6. Documentation/architecture/runtime-spine.md
7. Documentation/architecture/control-governance.md
8. Documentation/architecture/case-state-lineage.md
9. Documentation/reference/ownership-matrix.md
10. Documentation/reference/repository-map.md

Architecture

• architecture/overview.md
• architecture/system-boundary.md
• architecture/repository-boundaries.md
• architecture/runtime-spine.md
• architecture/control-governance.md
• architecture/case-state-lineage.md
• architecture/agency-orchestrator-capabilities.md
• architecture/knowledge-memory.md
• architecture/models-providers.md
• architecture/observability-analytics.md
• architecture/topology-deployment.md
• architecture/local-first-online-authorized-runtime.md

Runtime / Root Records

• internal/architecture/runtime/root-source-cutover-record.md

Contracts

• contracts/agent-contract.md
• contracts/delegation-contract.md
• contracts/case-binding-contract.md
• contracts/controlled-action-contract.md
• contracts/state-event-contract.md
• contracts/evidence-lineage-contract.md
• contracts/runtime-admission-contract.md
• contracts/system-call-record-contract.md

Manuals

• manuals/operator-manual.md
• manuals/deployment-manual.md
• manuals/runtime-service-operations.md
• manuals/provider-and-model-operations.md
• manuals/case-and-workflow-operations.md
• manuals/troubleshooting.md

Product, Reference, Papers, Decisions

• product/overview.md
• product/vision.md
• product/maturity.md
• product/distribution.md
• product/public-language-boundary.md
• reference/glossary.md
• reference/ownership-matrix.md
• reference/repository-map.md
• reference/plane-map.md
• reference/command-surface/provider-and-model-operations.md
• reference/legal/licensing.md
• reference/commercial/commercial-policy.md
• reference/governance/repository-governance.md
• reference/credits.md
• reference/action-terminology.md
• reference/product-taxonomy.md
• papers/README.md
• decisions/README.md
• decisions/adr-index.md
• decisions/active-decisions.md

Cross-Repo Pointers

• ../interfaces/Documentation owns protocol/API/SDK/conformance and developer-interface truth.
• ../console/Documentation owns terminal-client command UX, TUI, output, help, shell, build, and runtime attachment documentation.
• The old api repository name is historical and has been replaced by interfaces.
• The old standalone sdk repository is tombstone/historical only.