Explanation
Understanding-oriented material. These pages explain why nWave works the way it does — the concepts, models, and decisions behind the methodology. Read them when you want background and context, not a step-by-step task.
In the Divio documentation system, explanation is distinct from tutorials (learning), how-to guides (tasks), and reference (information). It is the discursive quadrant: it clarifies and illuminates a topic rather than instructing or specifying.
| Topic | What it explains | Level |
|---|---|---|
| Activating nWave in a Project | Why nWave hooks are opt-in per repo, and how the activation gate, marker, and global mode interact | Beginner |
| Understanding the SSOT Model | Why nWave's documentation structure changed and how the single-source-of-truth document model works | Intermediate |
| Wave Routing and Entry Points | The mental model for choosing which wave to start in, and how waves hand off to each other | Intermediate |
| Wave Directory Structure | How nWave organizes artifacts across the seven-wave pipeline, and why | Intermediate |
| Jobs To Be Done | The ODI/JTBD framing that maps real jobs to nWave workflows | Intermediate |
| What's New in v3.19 | Per-project activation (the opt-in gate) and the documented nwave-ai CLI |
All |
| What's New in v3.14 | Changes and additions in the v3.14 release | All |
| What's New in v3.5 | The DIVERGE wave, the SSOT model, the three DESIGN architects, and /nw-buddy |
All |
Where explanation sits in the docs
- Tutorials — learning-oriented. Start here if you are new.
- How-To Guides — task-oriented. Use these to get a specific job done.
- Reference — information-oriented. Look up precise specs for agents, commands, skills, templates, and config.
- Explanation (this page) — understanding-oriented. Read these for the why.