This directory contains all project documentation organized by subdomain.
This project is developed by AI agents. See the root-level docs for agent-specific context:
| Document | Purpose |
|---|---|
| AGENTS.md | General agent index and reading order |
| CLAUDE.md | Claude Code instructions (Phase 0 - current) |
| GEMINI.md | Gemini orchestrator instructions (Phase II - planned) |
| Document | Purpose |
|---|---|
| NORTH_STAR.md | Immutable vision and requirements - the "why" |
| ARCHITECTURE.md | Subdomain map and implementation status |
| ROADMAP.md | Phased implementation plan and next steps |
| Folder | Description |
|---|---|
| monorepo/ | Vendor branch pattern, upstream sync workflow |
| agent_tooling/ | MCP tool extraction from ALAS |
| agent_orchestration/ | Gemini orchestrator and recovery |
| state_machine/ | Explicit state machine extraction |
| dev/ | Testing and logging philosophy |
| archive/ | Obsolete documentation |
- Vision alignment: All architectural decisions should reference NORTH_STAR.md
- Update on change: If structure or architecture changes, update docs immediately
- Link, don't duplicate: Reference other docs rather than copying content
- Keep it central: System-wide documentation lives here, not buried in subfolders
- New to the project? Start with NORTH_STAR.md
- Understanding the codebase? See monorepo/00_summary.md
- Working on tools? See agent_tooling/README.md