.skaro/
├── constitution.md # Project principles and constraints
├── config.yaml # LLM and project settings
├── secrets.yaml # API keys (⚠ in .gitignore)
├── state.yaml # Phase states, hashes, approval flags
├── token_usage.yaml # Token consumption tracking (in .gitignore)
├── usage_log.jsonl # Detailed usage log (in .gitignore)
│
├── architecture/
│ ├── architecture.md # System architecture document
│ ├── review.md # LLM architecture review results
│ ├── invariants.md # Rules that must always hold
│ ├── diagrams/ # Mermaid / PlantUML diagrams
│ └── adr-NNN-*.md # Architecture Decision Records
│
├── devplan/
│ └── devplan.md # Project development plan
│
├── milestones/
│ └── <milestone-name>/
│ └── <task-name>/
│ ├── spec.md # Task specification
│ ├── clarifications.md # Clarify phase Q&A
│ ├── plan.md # Implementation plan
│ ├── tasks.md # Task decomposition
│ └── stages/
│ ├── stage-01/
│ │ └── AI_NOTES.md
│ ├── stage-02/
│ │ └── AI_NOTES.md
│ └── ...
│
├── docs/
│ └── review-log.md # Cross-validation log
│
├── prompts/ # Custom prompt overrides (optional)
│ └── *.md # Override any built-in phase prompt
│
├── ops/
│ ├── devops-notes.md
│ └── security-review.md
│
└── templates/ # Artifact templates
├── constitution-template.md
├── architecture-template.md
├── spec-template.md
├── plan-template.md
├── devplan-template.md
├── ai-notes-template.md
├── adr-template.md
└── security-checklist.md
