nw-buddy-project-reading

# Project State Reading ## Step 1: Detect Document Model ``` Glob for docs/product/ -> SSOT model active Glob for docs/features/ -> new delta files present Glob for docs/feature/ -> old model features present Neither exists -> greenfield project (no waves run yet) ``` ## Step 2: List Features **SSOT model**: `ls docs/features/` -> each directory is a feature ID. **Old model**: `ls docs/feature/` -> each directory is a feature ID. **Both models**: features can coexist. ## Step 3: Determine Wave Progress Per Feature ### SSOT Model Detection | Wave | Complete When | |------|--------------| | DISCOVER | `docs/product/jobs.yaml` has a validated job for this feature | | DIVERGE | `docs/features/{id}/recommendation.md` exists | | DISCUSS | `docs/features/{id}/user-stories.md` exists | | DESIGN | `docs/product/architecture/brief.md` updated for this feature (check changelog) | | DEVOPS | `docs/product/kpi-contracts.yaml` has contracts for this feature | | DISTILL | `docs/features/{id}/acceptance-tests.feature` exists AND `tests/acceptance/{id}/` has feature files | | DELIVER | `docs/features/{id}/roadmap.json` with all steps at COMMIT/PASS | ### Old Model Detection | Wave | Complete When | |------|--------------| | DISCOVER | `docs/feature/{id}/discover/problem-validation.md` exists | | DIVERGE | `docs/feature/{id}/diverge/recommendation.md` exists | | DISCUSS | `docs/feature/{id}/discuss/user-stories.md` exists | | DESIGN | `docs/feature/{id}/design/architecture-design.md` ...