Command Catalog
Wave Commands (run in order per feature)
| Command |
Wave |
Agent |
When to Use |
/nw-discover |
DISCOVER |
product-discoverer (Scout) |
Validate problem exists, customer interviews, opportunity mapping |
/nw-diverge |
DIVERGE |
diverger (Flux) |
Evaluate multiple solution approaches before committing |
/nw-discuss |
DISCUSS |
product-owner (Luna) |
Define user stories, journeys, acceptance criteria |
/nw-design |
DESIGN |
system-designer, ddd-architect, solution-architect |
Route to the right architect — system (scalability), domain (DDD), or application (components) |
/nw-devops |
DEVOPS |
platform-architect |
CI/CD, infrastructure, observability, deployment strategy |
/nw-distill |
DISTILL |
acceptance-designer |
Create executable acceptance tests (Given-When-Then) |
/nw-deliver |
DELIVER |
software-crafter |
Full implementation: roadmap -> execute -> finalize |
Routing Commands
| Command |
Purpose |
When to Use |
/nw-new |
Guided wizard for new features |
Starting something new — asks what you're building, recommends starting wave |
/nw-continue |
Resume in-progress feature |
Returning to a feature — detects progress, starts at next wave |
/nw-fast-forward |
Run remaining waves without pausing |
When you trust the agents to proceed without review between waves |
DELIVER Inner Loop Commands (manual mode)
| Command |
Purpose |
When to Use |
/nw-execute |
Run single roadmap step |
Implementing one step at a time (learning mode) |
/nw-roadmap |
Create implementation plan |
Planning steps before execution |
/nw-review |
Expert review of artifacts |
Quality check on roadmap, code, or step output |
/nw-mutation-test |
Test suite effectiveness |
After implementation — verifies tests catch real bugs |
/nw-finalize |
Archive completed feature |
After all steps pass — creates evolution document |
Cross-Wave Commands (any time)
| Command |
Agent |
When to Use |
/nw-research |
researcher (Nova) |
Investigate technologies, patterns, decisions needing evidence |
/nw-document |
documentarist + researcher |
Create DIVIO-compliant documentation (tutorial, how-to, reference, explanation) |
/nw-diagram |
solution-architect |
Generate C4 architecture diagrams (Mermaid/PlantUML) |
/nw-refactor |
software-crafter |
Systematic refactoring using RPP levels L1-L6 |
/nw-bugfix |
troubleshooter + crafter |
Root cause analysis -> regression test -> fix via TDD |
/nw-root-why |
troubleshooter |
Root cause analysis (5 Whys) without fix |
/nw-hotspot |
(self) |
Git change frequency analysis — find most-changed files |
/nw-rigor |
(self) |
Set quality-vs-token profile (lean/standard/thorough/exhaustive) |
/nw-forge |
agent-builder (Zeus) |
Create new specialized agents |
/nw-mikado |
software-crafter |
Complex refactoring roadmaps with visual tracking (experimental) |
/nw-buddy |
buddy (Guide) |
Ask any question about nWave — methodology, commands, project state |
For the full authoritative command reference, read docs/reference/commands/index.md.
Common User Scenarios -> Command
| User Says |
Recommend |
| "I want to build something new" |
/nw-new (wizard) or /nw-discover (if problem unclear) |
| "I'm not sure which approach to take" |
/nw-diverge |
| "I need user stories for this feature" |
/nw-discuss |
| "How should I architect this?" |
/nw-design |
| "I need to set up CI/CD" |
/nw-devops |
| "I need acceptance tests" |
/nw-distill |
| "I'm ready to implement" |
/nw-deliver |
| "I want to continue my feature" |
/nw-continue |
| "I need to research X" |
/nw-research |
| "I need documentation" |
/nw-document |
| "Something is broken" |
/nw-bugfix or /nw-root-why |
| "My code needs cleanup" |
/nw-refactor |
| "How good are my tests?" |
/nw-mutation-test |