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 |