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

38
AGENTS.md Normal file
View File

@@ -0,0 +1,38 @@
# AGENTS.md — Einstiegspunkt für jede Session
> **Lies dies zuerst. Lies NICHT das ganze Repo.** Orientiere dich in dieser
> Reihenfolge und höre auf, sobald du genug Kontext für deine Aufgabe hast.
## Lese-Reihenfolge (klarer Start)
1. **Dieses Dokument** — wer macht was, wo steht was.
2. **`STATE.md`** — *wo wir gerade stehen* (Now / In Progress / Blocked / Next /
offene Audit-Findings). Die einzige Quelle für den aktuellen Stand.
3. **`CONVENTIONS.md`** — verbindliche Regeln (Naming, Pfade, Commits, Ownership,
Model-Attribution, Review-Gate).
4. **Deine Rollen-Datei**`docs/roles/{leader,worker,reviewer}.md`.
Welches Modell für welche Arbeit: `docs/roles/model-routing.md`.
5. **Die relevante Loop-Datei**`docs/loops/{feature,audit}-loop.md`.
Bei Research-Items: `docs/loops/spike-gate.md`.
6. **Dein Session-Prompt**`session-prompts/` (fertig ausgefüllter Prompt für
diese Session — kein Lesen des ganzen Repos nötig).
7. Nur bei Bedarf: `manifests/requirements.md`, betroffene ADRs, Code.
## Wo finde ich was?
| Frage | Datei |
|---|---|
| Aktueller Stand / nächster Schritt | `STATE.md` |
| Regeln & gemeinsamer Vertrag | `CONVENTIONS.md` |
| Plan / Board / Ready-Set (DAG) | `ROADMAP.md` |
| Befülltes Beispiel zum Lernen | `examples/walkthrough/` |
| Warum wurde X so entschieden | `docs/adr/` |
| Anforderung → Datei → Test → Status | `manifests/requirements.md` |
| Was hat die letzte Session getan | `sessions/` (neuester Eintrag) |
| Offene Prüf-Befunde + Model-Zuweisung | `audits/` |
| Welches Modell für welche Arbeit | `docs/roles/model-routing.md` |
| Kaltstartfähige Session-Prompts | `session-prompts/` |
| Token-Kosten kontrollieren | `docs/token-hygiene.md` |
## Pflicht am Session-Ende
- `STATE.md` aktualisieren · Session-Log aus `sessions/TEMPLATE.md` anlegen
(inkl. **Token-Verbrauch** + Model-Attribution) · betroffene Manifeste/Docs anpassen ·
Quality-Gate ausführen (`scripts/gate-session-hygiene.sh`).