Battle-tested in the Forge ecosystem. Every file answers a specific stakeholder question.
PROJECT.md
Quick-start overview. What is this? Developer reads first, codes immediately.
architecture.yaml
System layers, modules, APIs. The structural blueprint your AI assistant follows.
features.yaml
Every feature with exact acceptance criteria. No ambiguity, no gaps.
test_cases.yaml
Test scenarios with expected behavior. Verification before you write a line of code.
terminology.yaml
Domain terms defined. No confusion between “user” and “client” and “customer.”
milestones.yaml
Phased delivery plan. What to build first, what depends on what.
gotchas.yaml
What NOT to do. Battle-tested mistakes to avoid. Saves hours of debugging.
rationale.yaml
WHY each decision was made. When someone asks “why PostgreSQL?” — the answer is here.