nw-buddy-project-reading
FeaturedHow to read a project's nWave state — detect document model, determine wave progress, find feature artifacts. For the buddy agent to give contextual advice.
AI & Automation 636 stars
68 forks Updated today MIT
Install
Quality Score: 95/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# 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` ...
Details
- Author
- nWave-ai
- Repository
- nWave-ai/nWave
- Created
- 9 months ago
- Last Updated
- today
- Language
- Python
- License
- MIT
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Featured
nw-buddy-ssot-knowledge
How the SSOT + Delta document model works — file locations, what each file contains, backward compatibility, migration. For the buddy agent to explain and navigate the document model.
636 Updated today
nWave-ai AI & Automation Featured
nw-buddy-wave-knowledge
How the 7-wave methodology works — wave graph, entry points, skip conditions, and handoff chain. For the buddy agent to explain methodology to users.
636 Updated today
nWave-ai AI & Automation Solid
nw-buddy
nWave concierge — ask any question about methodology, project state, commands, migration, or troubleshooting. Read-only, contextual answers.
636 Updated today
nWave-ai