feat: initial agent-swarm-repo template
Some checks failed
gates / quality (push) Has been cancelled
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:
39
CONVENTIONS.md
Normal file
39
CONVENTIONS.md
Normal file
@@ -0,0 +1,39 @@
|
||||
# CONVENTIONS.md — gemeinsamer Vertrag
|
||||
|
||||
Verbindlich für **alle** Aktoren. Änderungen nur per ADR.
|
||||
|
||||
## Ownership
|
||||
- **Kein Paket editiert Dateien eines anderen.** Integration & Konfliktlösung
|
||||
ausschließlich durch den Leader.
|
||||
- Jede Datei hat genau ein zuständiges Worker-Paket (siehe `STATE.md`).
|
||||
|
||||
## Git & Commits
|
||||
- Branch je Paket: `feat/<paket>`, `audit/<scope>`, `fix/<scope>`.
|
||||
- **Conventional Commits:** `feat:`, `fix:`, `docs:`, `test:`, `refactor:`,
|
||||
`chore:`. Der Git-Log ist Teil der Dokumentation.
|
||||
- **Model-Attribution:** jeder Commit eines Agenten enthält einen Trailer:
|
||||
`Co-Authored-By: Claude <Tier> <noreply@anthropic.com>`
|
||||
Tier = Capability-Bezeichnung des eingesetzten Modells, z. B. „Sonnet 4.6"
|
||||
für mittlere Kapazität oder „Opus 4.8" für maximale — nicht der interne
|
||||
Modell-Name. Gilt für das zum Commit-Zeitpunkt eingesetzte Modell.
|
||||
Ermöglicht nachträgliche Rückverfolgung welche Kapazitätsstufe was entschieden hat.
|
||||
|
||||
## Review-Gate
|
||||
- **Jede Implement-Session wird von einer separaten high-capacity-Session reviewed**
|
||||
(aktuell: Opus-Tier). Der Review läuft kalt (eigene Session, kein Vorkontext),
|
||||
prüft den Diff, und gibt APPROVE oder CHANGES-REQUESTED zurück.
|
||||
- Implement-Kapazitätsstufe ≠ Review-Kapazitätsstufe: ein Modell, das sich selbst
|
||||
reviewed, findet systematisch weniger als ein unabhängiger Pass auf höchster Stufe.
|
||||
- Konkrete Tier-Zuordnungen: `docs/roles/model-routing.md`.
|
||||
- Review-Gate-Checkliste: `docs/roles/reviewer.md`.
|
||||
|
||||
## Dokumentation
|
||||
- **Single Source of Truth** je Information — keine Duplikate über Docs hinweg.
|
||||
- Doku ist knapp: ein Dokument, das man nicht mehr liest, driftet. Größenbudget
|
||||
pro Doc beachten (Faustregel < 200 Zeilen).
|
||||
- Jede Code-Änderung passt das passende Doc + Manifest **in derselben Session** an.
|
||||
|
||||
## Definition of Done
|
||||
1. Manifest-Eintrag (`manifests/requirements.md`) mit Test + Status `done`.
|
||||
2. Tests grün. 3. Docs aktuell. 4. `STATE.md` aktualisiert.
|
||||
5. Session-Log geschrieben. 6. Quality-Gate `PASS`.
|
||||
Reference in New Issue
Block a user