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.
Concepts and models
| Topic |
What it explains |
Level |
| Wave Routing and Entry Points |
The mental model for choosing which wave to start in, and how waves hand off to each other |
Intermediate |
| Understanding the SSOT Model |
Why nWave's documentation structure changed and how the single-source-of-truth document model works |
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 |
Release history
| Topic |
What it explains |
Level |
| 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, and config.
- Explanation (this page) — understanding-oriented. Read these for the why.