feat: initial agent-swarm-repo template
Some checks failed
gates / quality (push) Has been cancelled

Generelles Git-Repo-Template fuer KI-Agenten-Arbeit (multi-agent swarm pattern).

Enthaelt:
- Rollen-System (Leader, Worker, Reviewer) mit Model-Routing-Matrix (Tier-basiert)
- Zwei komplementaere Loops: Feature-Loop (vorwaerts) + Audit-Loop (rueckwaerts)
- Spike-Gate fuer Research-Items (GO/NO-GO vor Produktionscode)
- Obligatorische Opus-Review-Gate nach jeder Implement-Session
- Drei ausfuehrbare Gates: session-hygiene, ownership (Cross-Edit-Schutz), doc-drift
  -- alle dormant bis zur ersten Initialisierung, dann automatisch aktiv
- Bootstrap: scripts/init.sh + session-prompts/BOOTSTRAP.md
- Worked Example (URL-Shortener-Domaene): Board, Session-Log, Audit-Finding, ADR
- Token-Hygiene (3-Tier: Session-Schnitt / Command-Disziplin / Cache-Disziplin)
- GitHub Actions CI (gates.yml) laeuft auf jedem Push/PR

Muster destilliert aus produktiv-bewaehrten Patterns des ConformalLabpp-Projekts.
This commit is contained in:
2026-06-03 06:35:06 +02:00
commit 696eddb5ef
40 changed files with 1310 additions and 0 deletions

View File

@@ -0,0 +1,61 @@
# BOOTSTRAP — neues Projekt aufsetzen (Leader-Session)
Kopiere den Block unten in eine **frische Session** (Modell: **Sonnet**) und hänge
deinen Projekt-Brief an. Der Leader füllt das Repo aus dem Brief — du musst keine
Datei von Hand anlegen.
> Voraussetzung: einmalig `bash scripts/init.sh "Projektname"` gelaufen.
---
```
Du bist der LEADER eines agent-swarm-Repos. Arbeite in _<absoluter Repo-Pfad>_.
Lies in dieser Reihenfolge und höre auf, sobald du genug Kontext hast:
AGENTS.md → STATE.md → CONVENTIONS.md → docs/methodology.md →
docs/roles/{leader,model-routing}.md → docs/loops/feature-loop.md →
ROADMAP.md (Board-Format) → examples/walkthrough/ (ein befülltes Beispiel).
## Mein Projekt-Brief
<<< HIER deinen Brief einfügen: Ziel, Tech-Stack, harte Constraints,
erste gewünschte Fähigkeit. 315 Zeilen reichen. >>>
## Deine Aufgabe (nur Planung, noch kein Feature-Code)
1. ROADMAP.md als Board befüllen: den Brief in Items zerlegen, jedes mit
Typ (🔌 port / 🔬 research / 🧱 infra), Status, Prereqs, Rolle·Modell, Aufwand.
Den Abhängigkeits-DAG explizit machen (was blockiert was).
2. CONVENTIONS.md projektspezifisch ergänzen, falls nötig: Build-/Test-Befehl,
Branch-/Remote-Konventionen, Sprache. Bestehende Regeln NICHT verwässern.
Tragende Entscheidungen als ADR unter docs/adr/ festhalten.
3. STATE.md auf den echten Startzustand setzen: die Header-Zeile mit einer echten
Session-ID/Datum füllen (ersetzt den '<id / datum>'-Platzhalter — DAS aktiviert
die Gates), Now/Next füllen, die Ownership-Tabelle für die ersten Pakete anlegen
(Verzeichnis-Pfade mit Slash beenden, z. B. `src/api/`).
4. Für jedes Item aus dem aktuellen READY-SET (Status 🔲, alle Prereqs ✅) einen
kaltstartfähigen Prompt unter session-prompts/<ID>.md aus
session-prompts/TEMPLATE.md erzeugen — Modell gemäß docs/roles/model-routing.md.
5. Ein Session-Log unter sessions/<datum>-bootstrap.md aus sessions/TEMPLATE.md
schreiben. Hygiene-Gate ausführen: bash scripts/gate-session-hygiene.sh.
## Wichtig
- Du PLANST und dispatcht — du baust die Features nicht selbst.
- Research-Items (🔬) müssen vor Produktionscode durch das Spike-Gate
(docs/loops/spike-gate.md). Markiere sie entsprechend im Board.
- Halte die Single-Source-of-Truth-Regel: keine Information doppelt ablegen.
- Conventional Commit + Trailer
`Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>`.
Am Ende: zeig mir das befüllte Board (ROADMAP.md) und das Ready-Set, und sag mir,
welche Session-Prompts du erzeugt hast und in welcher Reihenfolge ich sie dispatchen
sollte.
```
---
## Danach (laufender Betrieb)
1. Ready-Set aus `ROADMAP.md` lesen → einen Prompt aus `session-prompts/` nehmen.
2. Frische Session, Modell setzen, dispatchen (Worker bzw. Theorist→Spike).
3. Nach Implement: **Review-Gate** (Opus, kalt) — Prompt-Block in
`session-prompts/TEMPLATE.md`.
4. Merge → Item im Board auf ✅ → Dependents werden frei. Nach N Zyklen: Audit-Loop.