4 specs buddies you might need
In the repo (docs/specs/): Charter, PRD, ADD, WBS, Roadmap, CLAUDE.md, CHANGELOG
→ Version-controlled. AI reads these.
**CLAUDE.md :** the only doc AI loads automatically. It links to specs and says what to work on right now.
Charter (why) → PRD (what) → ADD (how) → WBS (work packages) → Roadmap (when) → CLAUDE.md (now)
Each document feeds the next. The Charter establishes why, the PRD defines what, the ADD defines how, the WBS breaks it into work packages, and CLAUDE.md is the living operational doc that AI reads automatically.
PRD → ADD → WBS → PRP (context for one work package) → Claude Code session
At milestone boundaries. Not mid-implementation. Bump the version, log the change, move on.
See the pages below for the full methodology.