1---2name: nw-buddy-command-catalog3description: All /nw-* commands — what they do, when to use them, which agent they invoke. For the buddy agent to help users pick the right command.4---567# Command Catalog89## Wave Commands (run in order per feature)1011| Command | Wave | Agent | When to Use |12|---------|------|-------|-------------|13| `/nw-discover` | DISCOVER | product-discoverer (Scout) | Validate problem exists, customer interviews, opportunity mapping |14| `/nw-diverge` | DIVERGE | diverger (Flux) | Evaluate multiple solution approaches before committing |15| `/nw-discuss` | DISCUSS | product-owner (Luna) | Define user stories, journeys, acceptance criteria |16| `/nw-design` | DESIGN | system-designer, ddd-architect, solution-architect | Route to the right architect — system (scalability), domain (DDD), or application (components) |17| `/nw-devops` | DEVOPS | platform-architect | CI/CD, infrastructure, observability, deployment strategy |18| `/nw-distill` | DISTILL | acceptance-designer | Create executable acceptance tests (Given-When-Then) |19| `/nw-deliver` | DELIVER | software-crafter | Full implementation: roadmap -> execute -> finalize |2021## Routing Commands2223| Command | Purpose | When to Use |24|---------|---------|-------------|25| `/nw-new` | Guided wizard for new features | Starting something new — asks what you're building, recommends starting wave |26| `/nw-continue` | Resume in-progress feature | Returning to a feature — detects progress, starts at next wave |27| `/nw-fast-forward` | Run remaining waves without pausing | When you trust the agents to proceed without review between waves |2829## DELIVER Inner Loop Commands (manual mode)3031| Command | Purpose | When to Use |32|---------|---------|-------------|33| `/nw-execute` | Run single roadmap step | Implementing one step at a time (learning mode) |34| `/nw-roadmap` | Create implementation plan | Planning steps before execution |35| `/nw-review` | Expert review of artifacts | Quality check on roadmap, code, or step output |36| `/nw-mutation-test` | Test suite effectiveness | After implementation — verifies tests catch real bugs |37| `/nw-finalize` | Archive completed feature | After all steps pass — creates evolution document |3839## Cross-Wave Commands (any time)4041| Command | Agent | When to Use |42|---------|-------|-------------|43| `/nw-research` | researcher (Nova) | Investigate technologies, patterns, decisions needing evidence |44| `/nw-document` | documentarist + researcher | Create DIVIO-compliant documentation (tutorial, how-to, reference, explanation) |45| `/nw-diagram` | solution-architect | Generate C4 architecture diagrams (Mermaid/PlantUML) |46| `/nw-refactor` | software-crafter | Systematic refactoring using RPP levels L1-L6 |47| `/nw-bugfix` | troubleshooter + crafter | Root cause analysis -> regression test -> fix via TDD |48| `/nw-root-why` | troubleshooter | Root cause analysis (5 Whys) without fix |49| `/nw-hotspot` | (self) | Git change frequency analysis — find most-changed files |50| `/nw-rigor` | (self) | Set quality-vs-token profile (lean/standard/thorough/exhaustive) |51| `/nw-forge` | agent-builder (Zeus) | Create new specialized agents |52| `/nw-mikado` | software-crafter | Complex refactoring roadmaps with visual tracking (experimental) |53| `/nw-buddy` | buddy (Guide) | Ask any question about nWave — methodology, commands, project state |5455> For the full authoritative command reference, read `docs/reference/commands/index.md`.5657## Common User Scenarios -> Command5859| User Says | Recommend |60|-----------|-----------|61| "I want to build something new" | `/nw-new` (wizard) or `/nw-discover` (if problem unclear) |62| "I'm not sure which approach to take" | `/nw-diverge` |63| "I need user stories for this feature" | `/nw-discuss` |64| "How should I architect this?" | `/nw-design` |65| "I need to set up CI/CD" | `/nw-devops` |66| "I need acceptance tests" | `/nw-distill` |67| "I'm ready to implement" | `/nw-deliver` |68| "I want to continue my feature" | `/nw-continue` |69| "I need to research X" | `/nw-research` |70| "I need documentation" | `/nw-document` |71| "Something is broken" | `/nw-bugfix` or `/nw-root-why` |72| "My code needs cleanup" | `/nw-refactor` |73| "How good are my tests?" | `/nw-mutation-test` |7475---7677**Source:** [`nWave-ai/nWave`](https://github.com/nWave-ai/nWave) → `nWave/skills/nw-buddy-command-catalog/SKILL.md`7879**Also appears in:** `nWave-ai/nWave/plugins/nw/skills/nw-buddy-command-catalog/SKILL.md`
thedixitjain