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