FullSpec-Framework für die KI-Entwicklung mit Claude Code und Spezifikationen

FullSpec: KI-gestütztes Entwicklungsframework mit Claude Code

KI-unterstützte Entwicklung gerät ohne einheitliche Architekturdokumentation oft ins Chaos. FullSpec löst das, indem es den gesamten Lebenszyklus von der Idee bis zum Release durch eine Kette von Spezifikationen formalisiert, die KI-Agenten generieren und pflegen.

Das Problem: KI ohne architektonisches Gedächtnis

Die Kernherausforderung bei LLMs wie Claude Code ist der fehlende Kontext für Architekturentscheidungen. Die KI spuckt Code schnell aus, vergisst aber, warum das System so aufgebaut ist. In einem Projekt mit 25 Microservices führt das zu massiven Konflikten:

• Inkonsistente Verschlüsselungsalgorithmen zwischen benachbarten Services
• Nicht passende API-Verträge
• Widersprüchliche Entscheidungen aus parallelen Sessions

Traditionelle Dokumentationen hinken hinterher: Sie sind entweder veraltet oder in Bürokratie versunken. KI braucht frische, vollständige, widerspruchsfreie Specs – und FullSpec schafft genau diese Umgebung.

FullSpec-Architektur: 23 Agenten und 8 Phasen

Das Framework strukturiert die Entwicklung über formale Dokumente, die KI-Agenten generieren und validieren. Nutzer starten mit /chain und einer Aufgabenbeschreibung wie „OAuth2-Authentifizierung implementieren“, was eine 8-phasige Sequenz auslöst.

Spec-Stufen

Die Kette erzeugt vier Dokumentationsstufen mit obligatorischen Reviews bei jeder:

• Diskussion – Anforderungen, Erfolgskriterien, Umfang und Risiken
• Design – Systemänderungen: Services, API-Verträge, Datenmodelle
• Testplanung – Test-Szenarien vor dem ersten Code
• Entwicklungsplan – Aufgaben, Abhängigkeiten und Ausführungsblöcke

Nach Freigabe der Specs generiert das System automatisch Dokumente, erstellt GitHub-Issues, schreibt Code und Tests, führt Code-Reviews durch und baut Pull Requests.

Wichtige Framework-Mechanismen

Parallele Agenten-Workflows

Statt einem Claude, der Aufgaben sequentiell bearbeitet, setzt FullSpec 23 spezialisierte KI-Agenten ein:

• Design-Generator
• Test-Planer
• Coder für verschiedene Sprachen
• Reviewer auf jeder Ebene
• Doc-Sync-Agenten

Bei Synchronisationen startet es N Agenten parallel – einen pro Service.

Auto-Validierung und Regeln

Das System enthält über 80 Validierungsskripte und 30 Pre-Commit-Hooks, die prüfen:

• Dokumentenformate
• Strukturelle Konsistenz
• Keine Secrets im Code
• Commit-Nachrichten-Standards

16 kontextuelle Regeln laden automatisch je Dateityp: .ts → TypeScript-Standards, .py → FastAPI-Standards. Regeln liegen in .claude/rules/ und greifen nahtlos ohne Extra-Prompts.

Lebende Specs und Konfliktprüfung

Was es von Konkurrenz abhebt: Das System erkennt und behebt Code-Spec-Widersprüche. Nach Commit läuft CONFLICT-CHECK:

• Stoppt bei Widersprüchen
• Lokalisiert Konfliktstufe (Design, Entwicklungsplan etc.)
• Kaskadiert Spec-Updates von oben nach unten
• Hält Docs frisch über alle Entwicklungsstadien

Vergleich mit Alternativen

| Kriterium | FullSpec | Spec Kit (GitHub) | Kiro (AWS) | OpenSpec (Fission AI) |

|----------|----------|-------------------|------------|-----------------------|

| Typ | Prozess-Framework | CLI-Toolkit | IDE (VS Code Fork) | CLI-Framework |

| Anforderungsformalismus | Diskussion mit Kriterien | Constitution + Spec | Anforderungen (EARS) | Vorschlag |

| Architekturdesign | Design mit API-Verträgen | Plan | Design (Markdown) | Design |

| Testplanung vor Code | Testplan mit TC-N-Nummerierung | Nein | Nein | Nein |

| Konflikterkennung | Automatisch + kaskadierende Updates | Nein | Nein | Nein |

| Lebende Docs | Auto-Sync aus Specs | Nein | Nein | Nein |

| GitHub-Automatisierung | Issues, PRs, Reviews, Releases | Nein | Nein | Nein |

| KI-Agenten | 23 parallel | 0 | 1 (integriert) | 0 |

| Validierung | 80+ Skripte, 30 Pre-Commit-Hooks | 0 | 0 | ~5 |

| Brownfield-Support | Noch nicht | Ja | Ja | Ja (Fokus) |

FullSpec deckt den gesamten Entwicklungszyklus ab, ist aber an Claude Code gebunden und fehlt vorerst Brownfield-Integration.

Technische Specs

• 71 Skills – Slash-Befehle für jeden Prozessschritt
• 23 KI-Agenten – Parallelarbeiter mit Spezialgebieten
• 80+ Validierungsskripte – Prüfungen in allen Phasen
• 30 Pre-Commit-Hooks – Automatisierte Qualitätskontrolle
• 16 kontextuelle Regeln – Erweiterbar für neue Tech
• 8 Prozessphasen – Von Idee bis Produktionsrelease
• Rekursive Standardisierung – Baut sich selbst nach eigenen Regeln

Wichtige Erkenntnisse

• Niedrige Einstiegshürde – Komplex im Inneren, Nutzer drücken nur /chain und bestätigen per Chat
• Nur Claude Code – Speziell dafür gebaut; andere ungetestet
• Russische Docs – Anleitungen und Specs auf Russisch, Claude meistert das
• Nur Greenfield – Als Template für Neuprozjekte; Brownfield in Arbeit
• Open Source – MIT-lizenziert auf GitHub

Dieses Projekt bringt einen Ansatz zum Leben, in dem KI nicht nur Code ausspuckt – sie gedeiht in einem formalisierten Prozess mit lebenden Docs. Es minimiert architektonische Risiken und steigert Vorhersagbarkeit für KI-nutzende Teams.

— Editorial Team