ReddRadar
Agent skill
nw-buddy-command-catalog
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.
Install this agent skill to your Project
npx add-skill https://github.com/nWave-ai/nWave/tree/main/plugins/nw/skills/nw-buddy-command-catalog
SKILL.md
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 |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
nWave-ai/nWave
nw-research
Gathers knowledge from web and files, cross-references across multiple sources, and produces cited research documents. Use when investigating technologies, patterns, or decisions that need evidence backing.
nWave-ai/nWave
nw-distill
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.
nWave-ai/nWave
nw-review-output-format
YAML output format and approval criteria for platform design reviews. Load when generating review feedback.
nWave-ai/nWave
nw-ddd-tactical
Tactical DDD — aggregate design rules, entities, value objects, domain events, repositories, domain services, and anti-pattern detection
nWave-ai/nWave
nw-infrastructure-and-observability
Infrastructure as Code patterns (Terraform, Kubernetes), observability design (SLOs, metrics, alerting, dashboards), and pipeline security stages. Load when designing infrastructure, observability, or security scanning.
nWave-ai/nWave
nw-par-critique-dimensions
Platform design review critique dimensions and severity levels. Load when reviewing CI/CD pipelines, infrastructure, deployment strategies, observability, or security designs.
Didn't find tool you were looking for?