Was ist nWave?

nWave ist ein quelloffenes agentisches Framework, das KI Agenten von der Idee bis zum fertigen Code führt und dabei einen Menschen an jedem Übergang im Review hält. Es läuft innerhalb von Claude Code und zerlegt die Entwicklung eines Features in sieben aufeinander folgende Wellen, in denen jeweils spezialisierte Agenten ein überprüfbares Artefakt erzeugen.

Die sieben Wellen heißen discover, diverge, discuss, design, devops, distill und deliver. Jede Welle hat einen eigenen Agenten und liefert ein Dokument, eine Architektur oder einen Testsatz, den du prüfst und freigibst, bevor die nächste Welle startet. Die Maschine läuft nie unbeaufsichtigt von der Idee bis zum Merge durch, der Mensch bleibt die tragende Kontrollinstanz an jedem Gate.

nWave steht unter der MIT Lizenz, ist überwiegend in Python geschrieben und wird von der Organisation nWave-ai gepflegt. Primäre Laufzeit ist Claude Code, daneben unterstützt das Framework OpenCode und die OpenAI Codex CLI. Damit gehört nWave in dieselbe Familie wie BMAD Method, Spec Kit oder OpenSpec, geht aber einen Schritt weiter, weil es seine Regeln nicht nur beschreibt, sondern zur Laufzeit über Hooks erzwingt.

Never Code Alone arbeitet täglich in genau den Runtimes, in denen nWave läuft. OpenCode und Claude Code sind fester Bestandteil unseres KI Coding Stacks, und die Disziplin, die nWave erzwingt, leben wir seit Jahren über Cypress E2E Tests, PHPUnit und RectorPHP. Wir wissen aus der Praxis, wo Test First, Acceptance Tests und Peer Review wirklich tragen und wo sie zu reinem Overhead werden.

Wenn du nWave für dein Team bewerten willst, helfen wir dir beim Einordnen statt beim blinden Übernehmen. Unser Vibe Coding Consulting klärt, welcher Grad an Prozess Strenge zu deinem Projekt passt. Im 1:1 Mentoring arbeiten wir mit dir am echten Code, der Guide Vibe Coding lernen ordnet die Grundlagen, und Exact Coding beschreibt den disziplinierten Gegenpol zum freien Vibe Coding, in dessen Logik nWave als Werkzeug fällt. Für das größere Bild lohnt unser Vergleich der Vibe Coding Tools 2026.

nWave ordnet die Lieferung eines Features in sieben Wellen. Jede Welle hat einen spezialisierten Agenten, einen Slash Befehl und ein Artefakt, das auf der Platte landet und von dir gelesen wird, bevor es weitergeht. Der Einstiegspunkt hängt vom Kontext ab: Ein Greenfield Projekt startet weit vorne, ein Bugfix springt direkt zu den Tests, ein Refactoring zum deliver Schritt.

• discover mit dem product-discoverer: Problemraum und Markt prüfen, bevor Code entsteht.
• diverge mit dem nw-diverger: strukturiertes Brainstorming, mehrere Lösungswege durchdenken statt vorschnell zu konvergieren.
• discuss mit dem product-owner: Anforderungen und User Journeys festhalten.
• design mit system-designer, ddd-architect und solution-architect: Architektur und Domänenmodell samt Entscheidungs Dokumenten.
• devops mit dem platform-architect: Infrastruktur und Deployment Pfad.
• distill mit dem acceptance-designer: Akzeptanztests im Given When Then Format, bevor Produktivcode existiert.
• deliver mit dem software-crafter: Umsetzung per Outside In TDD, jeder Akzeptanztest wird Schicht für Schicht grün.

Insgesamt bringt nWave vierzig Agenten mit, darunter zehn Wellen Agenten, einen Concierge, acht wellenübergreifende Spezialisten, vierzehn Peer Reviewer und sieben Business Agenten. distill und deliver sind immer das abschließende Paar, egal an welcher Stelle du einsteigst.

Nicht jede Aufgabe verdient die volle Prüftiefe. nWave kennt deshalb Rigor Profile, die Modellklasse, Review Tiefe und TDD Strenge an das Risiko der Aufgabe koppeln. Eine Konfigurationsänderung braucht weniger Strenge als ein sicherheitskritisches Feature. Das gewählte Profil bleibt über Sessions hinweg bestehen, du entscheidest also einmal pro Aufgabentyp statt bei jedem Lauf neu. Genau dieses Stufen Konzept macht die Token Kosten steuerbar.

Das technisch Eigenständige an nWave ist die DES Schicht, das Delivery Enforcement System. Sie überwacht während der deliver Welle jeden Tool Aufruf des Agenten und erzwingt die TDD Schleife. Der Agent darf die rote Phase nicht überspringen, nicht mit fehlschlagenden Tests committen und keinen Test anpassen, nur damit er grün wird. Diese Regeln sind keine Empfehlung, sondern im Protokoll des Agenten fest verdrahtet.

Seit Version 3.15 ist der 3 Phasen Kanon RED zu GREEN zu COMMIT der Standard. DES weist außerdem unbegründete fertig Meldungen ab und blockiert Versuche, im Prozess vorzuspringen. Genau hier liegt der Unterschied zu reinen Prompt Sammlungen: Ein Prompt beschreibt einen Prozess, nWave erzwingt ihn. Prompts scheitern offen, wenn ein Agent die rote Phase überspringt, Hooks scheitern geschlossen und stoppen den Lauf.

nWave braucht Python 3.10 oder neuer und eine unterstützte Runtime. Die Installation läuft über die CLI und dauert wenige Minuten:

Primäre Laufzeit ist Claude Code, dort funktioniert der volle Funktionsumfang inklusive DES Enforcement. OpenCode deckt rund zwei Drittel der Funktionen nativ ab, die OpenAI Codex CLI wird seit Version 3.15 mit denselben Phase Gates unterstützt. Der Weg über den Plugin Marketplace wird ausdrücklich nicht empfohlen, weil dort die DES Hooks nicht greifen und damit der Kern von nWave fehlt.

nWave teilt die Grundidee mit anderen spezifikationsgetriebenen Ansätzen: erst denken, dokumentieren und prüfen, dann Code schreiben. BMAD Method, Spec Kit und OpenSpec verfolgen ein ähnliches Ziel. Der Unterschied liegt in der Durchsetzung. Diese Frameworks liefern primär Workflow Text und Prompt Strukturen, nWave ergänzt Laufzeit Gates, die das Überspringen von Schritten technisch verhindern.

nWave ist geeignet für Teams, die KI gestützte Entwicklung mit erzwungener Test und Review Disziplin verbinden wollen und bereit sind, dafür Token und Zeit zu investieren. nWave hat Stärken bei sicherheitskritischen oder langlebigen Features, bei denen ein generalistischer Einzelagent zu riskant ist. Die Kehrseite: Ein voller Greenfield Durchlauf mit allen Wellen und echten Reviews dauert für ein kleines Feature einen Tag, für ein mittleres eine Woche, und die Methode trägt nur, wenn ein Mensch die Artefakte wirklich liest. Wir helfen Teams, nWave gegen diese Kosten ehrlich einzuordnen, so wie wir es bei den Risiken KI generierten Codes und beim strukturierten Prompting tun.

Auch ohne nWave selbst in Produktion einzusetzen, deckt sich sein Kerngedanke mit unserer Arbeitsweise: KI generierter Code wird erst dann verlässlich, wenn der Prozess vorgegeben und durchgesetzt ist. Genau diese Haltung tragen wir in unsere Beratung. Wir richten für Teams Quality Gates ein, etablieren Acceptance Tests und automatisierte Prüfungen in der Pipeline und sorgen dafür, dass jeder KI Beitrag reviewt ist, bevor er live geht.

Wenn dein Team von freiem Vibe Coding zu kontrollierter, testgetriebener Entwicklung wechseln will, ordnen wir Werkzeuge wie nWave in deinen Kontext ein. Über das Vibe Coding Consulting klären wir Architektur und Tool Auswahl, das 1:1 Mentoring begleitet einzelne Entwickler, und Exact Coding beschreibt den disziplinierten Weg, auf dem solche Frameworks ihren Platz finden. Verwandte Open Source Werkzeuge aus unserem Glossar sind die Terminal Runtime OpenCode, der Editor Neovim und die Self Hosting Plattform Coolify.

Die wichtigsten Fragen und Antworten rund um nWave, von Installation und Plattform Support über die sieben Wellen bis zur Abgrenzung gegenüber anderen agentischen Frameworks.