Repolode
Submit
nWave-ai

nWave-ai/nWave

A workflow framework of specialized AI agents that takes a feature from idea to tested code inside Claude Code, pausing for human review between each wave.

View on GitHubWebsite
Stars
633
Forks
67
Open issues
33
Last commit
3 hours ago

What is it?

nWave is a set of AI agents that runs inside Claude Code and organizes feature delivery into seven waves: discover, diverge, discuss, design, devops, distill, and deliver. Specialized agents produce a written artifact at each wave, such as requirements, architecture, or Given-When-Then acceptance tests, and the developer reviews and approves each one before the next wave starts.

The project installs an nwave-ai CLI that wires agents, commands, and hooks into ~/.claude/. Its DES hooks enforce TDD phase gates during implementation and can block edits made outside an active delivery session. Projects opt in per repository, and a /nw-rigor setting scales review depth and TDD strictness from lean to exhaustive. It also includes a feature-delta validator and an outcomes registry for catching duplicate rules at design time.

The installer supports Claude Code, OpenCode, and OpenAI Codex CLI, and it requires Python 3.10 or later. Windows users are directed to WSL.

Key features

  • 01Seven-wave workflow from discovery through TDD delivery, with review gates between waves.
  • 02Specialized agents for requirements, architecture, acceptance tests and implementation.
  • 03DES hooks enforce TDD phases and block source edits outside an active delivery session.
  • 04Rigor profiles (lean to exhaustive) control agent model, peer review and mutation testing.
  • 05Feature-delta validator and outcomes registry for design-time checks.
  • 06Supports Claude Code, OpenCode and Codex CLI.

Use cases

  • Adding a new feature to an existing codebase with written requirements and acceptance tests first.
  • Running a structured design review before any code is written.
  • Enforcing TDD discipline when multiple developers work on the same project with AI assistance.
  • Scaling review depth up or down depending on how risky a change is.

Quick start

  1. 1

    Check that Python 3.10+ and Claude Code are installed

  2. 2

    Run the official install script from the README

  3. 3

    Restart Claude Code when the installer finishes

  4. 4

    In Claude Code, ask the buddy what to do next

    /nw-buddy What should I do next?

Things to know

  • Requires Claude Code, which nWave runs inside.
  • Windows users must use WSL.
  • The plugin marketplace install is not supported because DES enforcement does not work there.
  • Known metadata correction issue #78 is not complete in v3.22.1.

In collections

Claude Code tools, skills & pluginsOpen-source AI agent frameworks & apps

Topics

#agentic-coding#claude-code#tdd#bdd#ai-agents#software-architecture#developer-workflow#agentic-ai#agentic-framework#agentic-workflow

FAQ

What is nWave?
A workflow framework of specialized AI agents that takes a feature from idea to tested code inside Claude Code, pausing for human review between each wave. nWave is a set of AI agents that runs inside Claude Code and organizes feature delivery into seven waves: discover, diverge, discuss, design, devops, distill, and deliver. Specialized agents produce a written artifact at each wave, such as requirements, architecture, or Given-When-Then acceptance tests, and the developer reviews and approves each one before the next wave starts.
Is nWave free to use? What license does it have?
nWave is open source under the MIT license. Check the license terms before using it in commercial products.
Is nWave still maintained?
Actively maintained. The last commit to nWave was on Nov 7, 2026.
What can I use nWave for?
Adding a new feature to an existing codebase with written requirements and acceptance tests first. Running a structured design review before any code is written. Enforcing TDD discipline when multiple developers work on the same project with AI assistance. Scaling review depth up or down depending on how risky a change is.
How do I install nWave?
Check that Python 3.10+ and Claude Code are installed Run the official install script from the README Restart Claude Code when the installer finishes In Claude Code, ask the buddy what to do next: /nw-buddy What should I do next?
Where can I get nWave?
The source code and installation instructions are on GitHub: https://github.com/nWave-ai/nWave

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects