Files

gates / quality (push) Has been cancelled

Details

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.

2026-06-03 06:35:06 +02:00

3.0 KiB

Raw Blame History

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. 3–15 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)

Ready-Set aus ROADMAP.md lesen → einen Prompt aus session-prompts/ nehmen.
Frische Session, Modell setzen, dispatchen (Worker bzw. Theorist→Spike).
Nach Implement: Review-Gate (Opus, kalt) — Prompt-Block in session-prompts/TEMPLATE.md.
Merge → Item im Board auf ✅ → Dependents werden frei. Nach N Zyklen: Audit-Loop.

3.0 KiB Raw Blame History Unescape Escape

BOOTSTRAP — neues Projekt aufsetzen (Leader-Session)

Danach (laufender Betrieb)

3.0 KiB

Raw Blame History