NCA Social Media
Aktualisiert:
Autor:
Roland Golla
Grüne Torbögen mit Builder Roboter und Codev Wegweiser

Was ist Codev?

Codev ist ein Open Source Werkzeug, das Coding Agents in einen festen Entwicklungsprozess setzt. Jede Aufgabe läuft über Spezifikation, Plan, Umsetzung und Review, getrennt durch Phase Gates, die ein Mensch freigibt.

Hinter Codev steht Cluesmith. Die Macher nennen es Codev OS und beschreiben es als Betriebssystem für die Zusammenarbeit von Menschen und Agenten. Kern ist die Idee, natürliche Sprache wie Code zu behandeln: Specs, Pläne und Reviews liegen versioniert im Repository und steuern die Arbeit der Agenten.

Codev ist eine der drei Umsetzungen, auf denen das Paper zur Software Engineering Factory von Ahmed E. Hassan und Kollegen aufbaut. Waleed Kadous von Cluesmith ist einer der Mitautoren. Eine zweite Umsetzung mit anderem Ansatz ist Swamp.

Inhalt
NCA KI Workshop für Developer

Agentic Coding im Team, nicht nur im Glossar

Ein Tag inhouse mit Benjamin Klein für Developer, Tester und Admins. Context Engineering, Harness, ADRs und zwei Hands on Blöcke mit KI Agenten in eurem Setup.

  1. 1
    Kostenloses Vorgespräch
    Stand, Rollen und Ziele klären
  2. 2
    Workshoptag bei euch
    Praxis am Vormittag, Hands on danach
  3. 3
    Praxistag optional
    Agenten im eigenen Projekt
Benjamin Klein
Benjamin Klein
Senior Consultant
Zum Workshop für Developer arrow_forward

Codev mit NCA einordnen

Wir arbeiten täglich mit Coding Agents. OpenCode mit Open Weight Modellen ist unser Werkzeug, dazu feste Gates aus PHPStan, Rector, PHPUnit und Cypress mit Cypress Cloud in GitHub Actions und GitLab CI. Codev ist nicht Teil unseres Production Stacks. Wir schauen uns solche Werkzeuge genau an, weil sie dieselbe Frage beantworten wollen wie wir: Wie bleibt KI Code auch bei hohem Tempo verantwortbar? Wir helfen Teams, Codev gegen ihren bestehenden Workflow einzuordnen.

In der NCA Vibe Coding Consulting prüfen wir, ob ein Protokoll Werkzeug zu deinem Team passt. Die NCA Agentic AI Coding Guardrails sichern Agenten mit Regeln, Rechten und Tests ab, egal welches Tool sie steuert. Wer seine Daten schützen will, findet Hilfe bei Vibe Coding Datenschutz und DSGVO Beratung. Im NCA KI Workshop für Developer üben Teams Agentic Coding mit festen Leitplanken, und die Vibe Coding Beratung begleitet den Weg danach.

Das SPIR Protokoll als Herzstück von Codev

SPIR ist das wichtigste Protokoll in Codev. Der Name steht für die vier Phasen, die jede Funktion durchläuft. Zwischen den Phasen liegen Gates. Ein Agent kann keine Phase überspringen. Daneben gibt es weitere Protokolle wie TICK, EXPERIMENT, MAINTAIN und LAUNCH, und Teams können eigene ergänzen.

Die vier Phasen von SPIR

Phase Was passiert Ergebnis im Repository
Specify Anforderungen, Randfälle und Erfolgskriterien klar beschreiben Spec Datei unter codev/specs
Plan Die Spec in ausführbare Phasen zerlegen, ein Mensch gibt den Plan frei Plan Datei unter codev/plans
Implement Code und Tests schreiben, Anforderungen pro Phase prüfen Code, Tests und Pull Request
Review Erkenntnisse festhalten und die Methode verbessern Review Datei unter codev/reviews

Architect, Builder und Agent Farm

Codev trennt zwei Rollen. Der Architect ist der Mensch zusammen mit einem Haupt Agenten. Er schreibt Specs und Pläne, gibt Gates frei und prüft die Ergebnisse. Die Builder sind autonome Agenten, die jeweils eine Spec umsetzen.

Jeder Builder arbeitet in einem eigenen Git Worktree. So laufen mehrere Builds parallel, ohne sich gegenseitig zu stören. Die optionale Agent Farm mit dem Befehl afx startet und überwacht diese Builder. Das Dashboard Tower zeigt live, welcher Builder arbeitet, wo ein Gate wartet und welche Pull Requests offen sind. Laut Hersteller gibt es Tower auch als kostenlose Cloud Variante und als Erweiterung für VS Code.

Wer mehrere Agenten parallel steuern will, kennt das Problem aus anderen Tools. Vergleichbare Ansätze beschreiben wir bei T3 Code, Herdr und Gas City.

Multi Model Review mit mehreren KI Modellen

Mit dem Befehl consult lässt Codev an jedem Checkpoint mehrere Modelle gegeneinander prüfen. Standardmäßig sind das Claude, Codex und Gemini. Die Idee: Jedes Modell hat andere blinde Flecken.

Laut eigener Auswertung von Cluesmith fand Codex vor allem Randfälle und Sicherheitslücken, Claude eher Fehler im Laufzeitverhalten und Gemini Probleme in der Architektur. Kein einzelnes Modell fand alle 20 Fehler, die vor dem Merge auffielen. Man kann die Auswahl der Modelle anpassen, der Hersteller empfiehlt mindestens zwei.

Das passt zu einem Prinzip der Software Engineering Factory: Wer Code schreibt, sollte ihn nicht allein prüfen. Wie automatisierte Reviews in der Pipeline aussehen, zeigt KI Code Review automatisieren.

Codev installieren und starten

Codev braucht Node.js ab Version 18 und Git ab Version 2.5. Für die Agent Farm kommt die GitHub CLI dazu. Installiert wird über npm.

Code: 
          
npm install -g @cluesmith/codev
mkdir my-project && cd my-project
codev init
codev doctor
afx workspace start

Danach beschreibst du in einem GitHub Issue, was gebaut werden soll, und startest einen Builder mit der Nummer des Issues.

Code: 
          
afx spawn 42

Für bestehende Projekte gibt es codev adopt. Der Befehl analysiert die Struktur und legt die nötigen Kontextdateien an, ohne Migration. Die Agenten Regeln landen in AGENTS.md und CLAUDE.md. Wie man solche Dateien sauber aufbaut, steht bei rules.md und AGENTS.md.

Was die Zahlen von Cluesmith zeigen

Cluesmith baut Codev mit Codev und veröffentlicht die eigenen Werte. In einem Sprint über 14 Tage kamen laut Hersteller 106 gemergte Pull Requests zusammen, die mittlere Bauzeit pro Funktion lag bei 57 Minuten, und 22 von 26 Buildern liefen komplett autonom.

Dazu gibt es einen Vergleich: dasselbe Modell und dieselbe Aufgabe, einmal frei im Gespräch und einmal mit SPIR. Drei KI Modelle bewerteten die Ergebnisse blind. SPIR lag in vier Runden konstant vorne, mit deutlich mehr Testcode und besserer Deployment Reife. Der Preis: Der strukturierte Lauf dauerte rund 3,7 mal so lange und kostete laut Hersteller drei bis fünf mal so viel.

Diese Zahlen stammen vom Hersteller selbst und wurden von KI Modellen bewertet. Sie zeigen eine Richtung, ersetzen aber keinen eigenen Test im eigenen Projekt. Wie du den Nutzen von KI Coding sauber misst, erklären wir beim KI Coding ROI.

Codev mit OpenCode, Modellen und Datenschutz

Codev unterstützt mehrere Agenten Shells. Claude Code ist der Standard, Codex funktioniert für beide Rollen. OpenCode geht laut Dokumentation nur als Builder, nicht als Architect. Damit lassen sich die Builder mit vielen Anbietern betreiben, auch mit Open Weight Modellen.

Wichtig für Teams in Europa: Code geht an die Anbieter, die man für Review und Builder konfiguriert. In der Standardeinstellung sind das US Anbieter. Unsere Regel ist deshalb klar. Coding Agents arbeiten gegen lokale Entwicklungsumgebungen mit anonymisierten Testdaten, etwa aus Faker. Echte Kundendaten haben dort nichts zu suchen.

Für autonome Builder setzt Codev Flags, die Rückfragen bei Datei und Shell Zugriffen abschalten. Das gehört nur in isolierte Entwicklungsumgebungen. Welche Modelle sich ohne US Anbieter eignen, zeigt welches KI Modell ohne US Anbieter.

Für wen Codev passt

Codev ist geeignet für Teams, die schon mit Coding Agents arbeiten und merken, dass freie Sessions zu viel Zufall erzeugen.

  • Stärken: klarer Ablauf von Spec bis Review, versionierte Entscheidungen im Repository, parallele Builder in Worktrees, Prüfung durch mehrere Modelle.
  • Grenzen: mehr Zeit und Tokens pro Funktion, Agent Farm vor allem für macOS getestet, Architect Rolle nur mit Claude Code oder Codex, Standard Setup mit US Anbietern.
  • Voraussetzung: gute Tests. Ohne harte Gates aus statischer Analyse und End to End Tests bleibt auch ein guter Prozess eine Empfehlung.

Wenn du den Spec Ansatz ohne neues Tool testen willst, starte mit Spec Driven Development und deinen bestehenden Quality Gates.

Protocols, not prompts.

Cluesmith, Team hinter Codev – Codev OS Website

Aus der NCA Praxis mit Protokollen für Agenten

Wir helfen Teams, Coding Agents in einen verlässlichen Ablauf zu bringen. Ob Codev, ein anderes Tool oder ein eigener Prozess: Am Anfang stehen immer die Gates. Statische Analyse, Unit Tests, funktionale Tests und Cypress End to End Tests laufen zuerst in der Pipeline. Danach bekommen Agenten mehr Freiraum.

Wie Agenten im Team zusammenarbeiten, erklären wir bei Agentic Coding und den Agentic Coding Patterns. Akzeptanztests als unabhängige Abnahme beschreiben wir bei agentischen Akzeptanztests, die Testbegriffe im NCA Cypress Glossar. Einen Überblick über weitere Werkzeuge gibt es bei den Top 10 Vibe Coding Tools.

CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.
NCA Vibe Coding Consulting

Roland Golla ist Entwickler aus Leidenschaft – seit über 20 Jahren. Er hat hunderte Projekte begleitet, von Legacy-Refactoring bis KI-Integration. Bei Vibe Coding verbindet er das Beste aus beiden Welten: Die Geschwindigkeit von KI-generiertem Code mit der Qualität professioneller Softwareentwicklung. Kein Bullshit, keine Agentur-Floskeln – direkte Hilfe von jemandem, der selbst täglich im Code steckt.

E-Mail Kontakt

Häufige Fragen zu Codev

Die wichtigsten Fragen rund um Codev, kurz und direkt beantwortet.

Was ist Codev 2026?

Codev ist ein Open Source Werkzeug von Cluesmith, das Coding Agents in einen festen Prozess setzt. Jede Funktion läuft über Spezifikation, Plan, Umsetzung und Review. Zwischen den Phasen liegen Gates, die ein Mensch freigibt. Autonome Builder setzen die Specs in eigenen Git Worktrees um, mehrere Modelle prüfen die Ergebnisse.

Ist Codev 2026 kostenlos?

Die Kommandozeile von Codev ist Open Source und laut Hersteller kostenlos nutzbar. Auch die Cloud Variante des Dashboards Tower ist laut Cluesmith kostenlos. Kosten entstehen über die KI Anbieter, deren Schlüssel man selbst einbringt. Weil mehrere Modelle prüfen, ist der Tokenverbrauch pro Funktion höher als bei einer einfachen Session.

Funktioniert Codev 2026 mit OpenCode?

Ja, aber nur als Builder. Laut Dokumentation lässt sich OpenCode als Shell für die autonomen Builder einsetzen. Für die Rolle des Architects braucht Codev Claude Code oder Codex. So können die Builder mit vielen Anbietern und auch mit Open Weight Modellen laufen, während die Steuerung bei einem der beiden unterstützten Tools liegt.

Was ist das SPIR Protokoll 2026?

SPIR ist das wichtigste Protokoll in Codev und steht für Specify, Plan, Implement und Review. Jede Funktion beginnt mit einer Spec, wird in einen Plan zerlegt, umgesetzt und am Ende ausgewertet. Die Erkenntnisse aus dem Review fließen zurück in die Methode. Agenten können keine Phase überspringen.

Für welche Teams lohnt sich Codev 2026?

Codev ist geeignet für Teams, die schon mit Coding Agents arbeiten und mehr Struktur wollen. Wer viele Funktionen parallel bauen lässt und Entscheidungen nachvollziehbar im Repository haben möchte, profitiert am meisten. Für kleine Experimente ist der Aufwand meist zu hoch. Gute Tests sind in jedem Fall die Voraussetzung.

Was ist die Agent Farm in Codev?

Die Agent Farm ist ein optionaler Teil von Codev, gesteuert über den Befehl afx. Sie startet mehrere Builder parallel, jeweils in einem eigenen Git Worktree, und zeigt ihren Status in einem Web Dashboard. Laut Hersteller ist sie vor allem für macOS getestet. Die Protokolle funktionieren auch ohne Agent Farm.

Welche Modelle prüfen in Codev den Code?

Standardmäßig prüfen Claude, Codex und Gemini jeden Checkpoint. Laut Cluesmith findet jedes Modell andere Fehler, kein einzelnes fand in ihrer Auswertung alle. Die Auswahl lässt sich anpassen, empfohlen werden mindestens zwei Modelle. Wer keine US Anbieter nutzen will, muss die Konfiguration entsprechend ändern.

Wird mein Code bei Codev an Dritte geschickt?

Ja. Code geht an die KI Anbieter, die man für Builder und Review konfiguriert. In der Standardeinstellung sind das Google, OpenAI und Anthropic. Laut Hersteller läuft die Übertragung verschlüsselt, und Modelle lassen sich auch selbst hosten. Wir empfehlen lokale Entwicklungsumgebungen mit anonymisierten Testdaten.

Kann ich Codev in einem bestehenden Projekt nutzen?

Ja. Mit dem Befehl codev adopt analysiert Codev die vorhandene Struktur und legt die nötigen Kontextdateien an. Eine Migration ist laut Hersteller nicht nötig. Danach schreibst du die erste Spec und startest einen Builder. Bei Legacy Projekten raten wir trotzdem dazu, zuerst Quality Gates aufzubauen.

Was hat Codev mit der Software Engineering Factory zu tun?

Codev ist eine der drei Umsetzungen, auf denen das Paper zur Software Engineering Factory von Ahmed E. Hassan und Kollegen aufbaut. Waleed Kadous von Cluesmith ist Mitautor. Phase Gates, versionierte Specs und unabhängiges Review mehrerer Modelle sind Bausteine, die das Paper als Prinzipien beschreibt.

Was ist der Unterschied zwischen Codev und Spec Kit?

Beide setzen auf Specs vor dem Code. Codev geht weiter und bringt mit Agent Farm, parallelen Buildern in Worktrees, Multi Model Review und Phase Gates einen ganzen Ablauf mit. Spec Kit konzentriert sich stärker auf das Erstellen und Pflegen der Spezifikation. Welche Lösung passt, hängt von Teamgröße und vorhandenem Workflow ab.

Wie hilft NCA bei der Einordnung von Codev?

Wir starten mit einem kostenlosen Kennenlernen und schauen uns euren Workflow mit Coding Agents an. Danach schätzen wir den Aufwand und rechnen transparent minutengenau ab. Wir prüfen, ob ein Werkzeug wie Codev passt, und bauen vorher die nötigen Gates aus statischer Analyse, Tests und Cypress End to End Tests auf.