Waves / Commands

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.