Build software in disciplined waves.

New to nWave?

nWave is an AI-powered workflow framework that runs inside Claude Code. It orchestrates specialised agents through disciplined development waves — enforcing test-driven development, phase tracking, and deterministic validation at every step. The result: AI that ships features the way a senior team would, not ad-hoc vibe-coding.

The wave model, end to end:

DISCOVER → DISCUSS → DESIGN → DEVOPS → DISTILL → DELIVER

Each wave has a command (/nw-discover, /nw-design, /nw-deliver, …) and a specialist agent behind it. You don't need all of them on day one.

Install nWave into Claude Code:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/nWave-ai/nWave/main/scripts/install/install.sh)"

nWave installs globally but is opt-in per project: your first /nw- command activates the repo you're in (or run nwave-ai project enable). Check any repo with nwave-ai status — see Activating nWave in a Project →.

Then get productive in three steps:

1. Try your first delivery — open a project in Claude Code and run /nw-deliver. Watch it write tests, make them pass, and commit.
2. Follow the path — Your First Delivery → walks you through it in about 13 minutes.
3. Go wider — the Tutorials are ordered from zero to the full lifecycle.

Already using nWave?

• What changed — see What's New for per-project activation (the opt-in gate) and the documented nwave-ai CLI.
• Turn nWave on or off per repo — Activating nWave in a Project explains the opt-in gate and the nwave-ai project / mode / status commands.
• Look something up — the Reference has every agent, command, skill, and template.
• Upgrade a project — Migrating to the SSOT Model covers moving an existing project to the current document model.
• Switch versions — use the selector in the top-right to read the docs for the exact release you're running.

Tip: stuck on anything? Type /nw-buddy followed by your question in Claude Code for contextual help on methodology, commands, or project state.