plugins/nw/skills/nw-buddy-command-catalog/SKILL.md
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.
npx skillsauth add nwave-ai/nwave nw-buddy-command-catalogInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
| 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 |
| 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 |
| 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 |
| 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.
| 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 |
testing
Acceptance test creation methodology for the DISTILL wave. Domain knowledge for the acceptance designer agent: port-to-port principle, prior wave reading, wave-decision reconciliation, graceful degradation, and document back-propagation.
development
Cross-agent collaboration protocols, workflow handoff patterns, and commit message formats for TDD/Mikado/refactoring workflows
development
Creates a phased roadmap.json for a feature goal with acceptance criteria and TDD steps. Use when planning implementation steps before execution.
testing
Acceptance test creation methodology for the DISTILL wave. Domain knowledge for the acceptance designer agent: port-to-port principle, prior wave reading, wave-decision reconciliation, graceful degradation, and document back-propagation.