Beschreibung
Spec-first Agentic Development führt einen strukturierten Ansatz zur Arbeit mit KI-Coding-Agenten ein, der sicherstellt, dass jede Änderung durch eine klar definierte und überprüfte Spezifikation initiiert wird. Diese Methodik zielt darauf ab, die Zuverlässigkeit und Wartbarkeit des von KI-Agenten entwickelten Codes zu verbessern, indem menschliche Aufsicht und automatisierte Prüfungen während des gesamten Entwicklungszyklus integriert werden.
Weiterlesen
Das Kernprinzip besteht darin, jede Entwicklungsaufgabe mit einer schriftlichen Spezifikation zu beginnen, die im Repository gespeichert ist. Diese Spezifikation umreißt das Ziel, relevante Fakten (einschließlich Datei- und Zeilenreferenzen), die durchzuführenden Schritte und präzise „done“-Kriterien. Bevor Code geschrieben wird, überprüft ein frischer Reviewer die Spezifikation im Vergleich zum bestehenden Code, um deren Genauigkeit und Durchführbarkeit zu verifizieren. Nach Genehmigung fährt ein KI-Agent fort, das Feature in seinem eigenen isolierten Branch und Arbeitsbereich zu erstellen. Der endgültige Commit darf erst im Hauptrepository landen, nachdem alle vordefinierten Prüfungen und Tests bestanden sind, um die Codequalität und die Einhaltung der Spezifikation sicherzustellen.
Dieses System unterscheidet sich erheblich von traditionellem „Vibe-Coding“, indem es ad-hoc Aufforderungen durch eine überprüfte, persistente Spezifikation ersetzt. Es protokolliert jede Entscheidung, die der Agent trifft, mit seiner Begründung, was eine klare Prüfspur bietet und die Notwendigkeit für nachträgliche Dokumentation reduziert. Spezifikationen sind so gestaltet, dass sie Absicht und Architektur festhalten, anstatt übermäßig präzise Code-Generatoren zu sein, wobei Tests und Commit-Gates die notwendige Präzision liefern. Alte Spezifikationen werden als unveränderliche Änderungsprotokolle behandelt, ähnlich wie Commits, und werden nicht aktualisiert, um Veralterung zu verhindern.
Spec-first Agentic Development unterstützt parallele Entwicklungen, sodass mehrere Agenten gleichzeitig an verschiedenen Spezifikationen arbeiten können, indem sie eindeutige Branch- und Arbeitsbereichs-IDs verwenden. Der Prozess ist ununterbrochen, da überprüfte Spezifikationen offene Fragen vorab beantworten, was es den Agenten ermöglicht, direkt zu den „done“-Kriterien zu arbeiten. Der gesamte Workflow ist strukturiert, wobei eine Spezifikation einem Branch und einem Commit entspricht, was Pull-Requests vereinfacht und Konsistenz gewährleistet. Der Zustand wird in `context.yaml` gespeichert, was die Arbeit auch nach Neustarts fortsetzbar macht.
Die Methode, Vorlagen und das Claude Code-Plugin sind alle MIT-lizenziert, was es zu einer kostenfreien Lösung macht. Während das Claude Code-Plugin Buchhaltungs- und Gate-Funktionen automatisiert, kann die Methodik auch mit anderen Agenten wie Codex, Cursor oder Copilot übernommen werden, indem `AGENTS.md` gefolgt und ein Git-Commit-msg-Hook für das Gate installiert wird. Dieser Ansatz wurde durch die Entwicklung von Agent Smith, einer Open-Source-agentischen Softwarefabrik, entwickelt und verfeinert, was seine praktische Anwendung und Effektivität demonstriert.
- KategorieKI-Programmierassistenten
- PreismodellKostenlos
- BereitstellungCloud
- PlattformenWeb
Spec-first Agentic Development's Kernfunktionen
Spezifikationsgetriebene Entwicklung für KI-Coding-Agenten
Überprüfte Spezifikationen, die vor dem Erstellen mit dem Code abgeglichen werden
Isolierte Arbeitsbereiche für jede Entwicklungsaufgabe
Gesperrte Commits, die das Bestehen aller Prüfungen erfordern
Persistente Spezifikationen, die im Repository gespeichert sind
Entscheidungsprotokollierung mit Begründung für Nachvollziehbarkeit
Unterstützung für parallele Entwicklungen mit eindeutigen Branch-IDs
Fortsetzbare Workflows mit im context.yaml gespeicherten Zuständen
MIT-lizenzierte Methode, Vorlagen und Claude Code-Plugin
Kompatibilität mit Codex, Cursor, Copilot und Terminal
Git-Commit-msg-Hook zur Durchsetzung von Commit-Gates
Automatisierte Nachweisprüfung für Spezifikationszitationen
Strukturierte Pull-Requests für einzelne oder Serien von Spezifikationen
Kontexte und Regeln, die aus dem bestehenden Code generiert werden
Kein handgeschriebener Code erforderlich für den Build-Prozess von Agent Smith
Wie verwendet man Spec-first Agentic Development?
Plugin/Hook installieren: Installieren Sie das Claude Code-Plugin oder den Git-Commit-msg-Hook in Ihrem Projekt-Clone.
Projekt einrichten: Führen Sie /spec-first:bootstrap-project aus, um Kontexte und Regeln aus Ihrem bestehenden Code zu generieren.
Spezifikation erstellen: Definieren Sie eine neue Aufgabe mit einem Ziel, Schritten, Fakten und „done“-Kriterien unter Verwendung der create-spec-Fähigkeit.
Spezifikation überprüfen: Lassen Sie einen frischen Reviewer die Spezifikation mit dem Code auf Genauigkeit und Durchführbarkeit überprüfen.
Spezifikation anwenden: Der Agent erstellt die Spezifikation in seinem eigenen Branch und Arbeitsbereich, gemäß den Projektregeln.
Spezifikation liefern: Committen Sie die Änderungen durch das Gate, stellen Sie sicher, dass alle Prüfungen bestanden werden, und öffnen Sie einen Pull-Request.
Serie liefern: Für größere Änderungen verwenden Sie /spec-first:deliver-series, um mehrere voneinander abhängige Spezifikationen zu verwalten und zu liefern.
Spec-first Agentic Development's Anwendungsfälle
- Entwicklung von KI-Agenten-Code
- Sicherstellung der Codequalität
- Verwaltung komplexer Projekte
- Verbesserung der Code-Nachverfolgbarkeit
- Erleichterung von Code-Reviews
- Automatisierung von Entwicklungs-Workflows
- Einarbeitung neuer Entwickler
- Integration mit bestehenden Tools
