nWave/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
Runs feature-scoped mutation testing to validate test suite quality. Use after implementation to verify tests catch real bugs (kill rate >= 80%).
development
Canonical AT completeness gate — research-anchored 7-category taxonomy (C1-C7) + 15-item mechanical checklist. Paradigm-neutral. Drives acceptance-designer reviewer verdict deterministically.
development
Canonical AT completeness gate — research-anchored 7-category taxonomy (C1-C7) + 15-item mechanical checklist. Paradigm-neutral. Drives acceptance-designer reviewer verdict deterministically.
testing
Methodology for minimizing test count while maximizing behavioral coverage - behavior definition, anti-pattern catalog, consolidation patterns, stopping criterion, coverage-preserving validation