![[ e-networld.de ]](/img/logo.png){kind=logo}
Squad-Spec-Repository-Template
Vorlage für spezifikationsgetriebene Entwicklung mit KI-Agenten: ein gemeinsames Squad, eine Regelbasis für Claude, Codex und Copilot, Profile für .NET, Go und Node.
Überblick
Das Squad-Spec-Repository-Template bündelt alles, was ein Repository für die Arbeit mit KI-Agenten braucht: ein Team aus festen Rollen, eine einheitliche Regelbasis und das Gerüst für Dokumentation und GitHub. Es besteht aus einem stackneutralen Kern und je einem Profil pro Technologie-Stack. Genutzt wird es nicht über GitHubs Schaltfläche „Use this template“, sondern über den Skill adopt-template, der die Vorlage auf ein bestehendes oder neues Repository anwendet und es später wieder auffrischt.
Das Squad arbeitet über die Skills squad-issue für Fehlerbehebungen und squad-spec für neue Funktionen. Der Ablauf: planen, hinterfragen, Sicherheitsprüfung, Tests zuerst, Umsetzung bis mindestens 80 % Abdeckung, Format- und Analyzer-Schranke, Review-Schleife, Freigabe durch den Lead und schließlich der Pull Request.
CLAUDE.md für Claude Code, AGENTS.md für Codex und .github/copilot-instructions.md für GitHub Copilot sind ab der ersten ##-Überschrift identisch. Dasselbe gilt für die Skills create-pr, review-pr, squad-issue und squad-spec, die in allen drei Umgebungen vorliegen.
Die Dateien im Ziel-Repository gehören zu drei Arten: verwaltete Dateien werden bei jeder Auffrischung überschrieben, markierte Dateien werden neu aufgebaut und behalten die Projektblöcke, Seed-Dateien werden nur einmal angelegt und danach nie wieder angefasst. So bleibt der Kern stackneutral, und projektspezifisches Wissen geht bei einer Auffrischung nicht verloren. Platzhalter der Form {{TODO: …}} lässt config-check.py so lange scheitern, bis sie ausgefüllt sind.