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 |