Command Reference
All 16 Waves commands organized by phase. Each command supports fast mode (pass arguments) or interactive mode (guided step-by-step).
Define Before You Build
/waves:project-init
Setup
First-time setup. Configures your preferences (language, tone, explanation style) and project context. Creates user_pref.json.
/waves:feasibility-analyze
Sub-Zero
Data-backed go/no-go signals. Monte Carlo simulations, market analysis, Bayesian projections. Know if your idea works before you invest.
/waves:foundation-create
Sub-Zero
Compacts feasibility into an executive summary: validated problem, unit economics, SWOT, capabilities ranked by criticality. The bridge to product definition.
/waves:blueprint-create
Wave 0
Complete product architecture from the foundation: capabilities with acceptance criteria, user flows, design principles, traceable rules, success metrics, tech stack.
Plan, Implement, Track
/waves:roadmap-create
Any Wave
Organizes capabilities into phases with milestones and dependencies. W0 plans foundations; W1+ plans business features. Each wave gets its own roadmap.
/waves:roadmap-update
Any Wave
Report progress, record decisions, resolve open questions, transition phases, or restructure milestones. Keeps the roadmap as a living plan.
/waves:logbook-create
Any Wave
Breaks each task into objectives with completion guides referencing actual code. The agent implements, tracks progress, and preserves context across sessions.
/waves:logbook-update
Any Wave
Update progress entries, change objective status, add new objectives, record reminders. Includes automatic history compaction when entries exceed 20.
/waves:objectives-implement
Any Wave
The agent implements the next objective with automatic code auditing against your project rules. Code passes review on the first try.
Keep Everything Current
/waves:manifest-create
Setup
Analyzes your project and creates a structured manifest: architecture layers, features, dependencies, tech stack. Works for software, academic, creative, and business projects.
/waves:manifest-update
Ongoing
Detects changes since the last manifest update and intelligently updates features, architecture, and dependencies. Keeps the manifest in sync with code.
/waves:rules-create
Setup
Extracts coding rules and standards from your existing codebase. The agent analyzes patterns, conventions, and antipatterns to produce documented rules.
/waves:rules-update
Ongoing
Detects code changes since the last rules update and proposes new rules, modifications, or deprecations. Rules evolve with your codebase.
/waves:resolution-create
Closure
Generates a resolution document from a completed logbook. Summarizes what was accomplished, decisions made, challenges overcome, and technical learnings.
/waves:upgrade
Ongoing
Updates the Waves Agent Operating Protocol in CLAUDE.md to the latest version. Run after updating Waves via Homebrew.
/waves:user-pref-create
Setup
Creates complete user preferences with all available options. Advanced setup with full control over interaction settings.