nw-buddy-ssot-knowledge

# SSOT + Delta Document Model ## Two-Tier Model **SSOT** (Single Source of Truth) in `docs/product/` — what the system IS now. Updated by each wave. Never duplicated per feature. **Delta** in `docs/features/{id}/` — what THIS feature changes. Max 6 files per feature. ## SSOT Directory Structure ``` docs/product/ vision.md Product vision + validated problems jobs.yaml All validated JTBD jobs + opportunity scores journeys/ {name}.yaml Current journey schema (updated by DISCUSS) {name}-visual.md Human-readable journey narrative architecture/ brief.md Current component boundaries (updated by DESIGN) adr-*.md Architectural decision records (permanent) kpi-contracts.yaml Active measurement contracts (updated by DEVOPS) ``` ## Feature Delta Structure ``` docs/features/{id}/ feature-brief.md Generated summary for human review (after DISTILL) recommendation.md Chosen direction (from DIVERGE) user-stories.md Stories for this feature (from DISCUSS) wave-decisions.md Decisions made across all waves (incremental) acceptance-tests.feature Executable specs (from DISTILL) roadmap.json Implementation plan (from DELIVER) ``` ## Which Wave Updates What | Wave | Reads SSOT | Produces Delta | Updates SSOT | |------|-----------|----------------|--------------| | DISCOVER | `jobs...