nw-buddy-command-catalog

name	nw-buddy-command-catalog
description	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.
user-invocable	false
disable-model-invocation	true

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