File Structure

.planning/
├── PROJECT.md              # project vision and context (always loaded)
├── REQUIREMENTS.md         # scoped v1/v2 requirements with IDs
├── ROADMAP.md              # phase breakdown with status tracking
├── STATE.md                # decisions, blockers, session memory
├── config.json             # workflow configuration
├── MILESTONES.md           # completed milestone archive
├── research/               # domain research from /gsd:new-project
├── todos/
│   ├── pending/            # captured ideas awaiting work
│   └── done/               # completed todos
├── debug/                  # active debug sessions
│   └── resolved/           # archived debug sessions
├── codebase/               # brownfield codebase mapping
└── phases/
    └── XX-phase-name/
        ├── XX-YY-PLAN.md       # atomic execution plans
        ├── XX-YY-SUMMARY.md    # execution outcomes and decisions
        ├── CONTEXT.md          # implementation preferences
        ├── RESEARCH.md         # ecosystem research findings
        └── VERIFICATION.md     # post-execution verification results