Files
agent-swarm-repo/docs/gates/quality-gates.md
Tarik Moussa 696eddb5ef
Some checks failed
gates / quality (push) Has been cancelled
feat: initial agent-swarm-repo template
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

27 lines
1.1 KiB
Markdown

# Quality-Gates
Laufen am Session-Ende und in CI. Jedes Gate: **PASS/FAIL** + Checkliste.
`FAIL` blockt den Merge bzw. erzeugt einen Korrektur-Task.
## 1. Session-Hygiene
- [ ] `STATE.md` in dieser Session aktualisiert.
- [ ] Session-Log unter `sessions/` angelegt (mit Token-Verbrauch).
- [ ] Working Tree sauber, Commits konventionskonform.
- [ ] **Clean-Start-Invariante** erfüllt (Orientierung allein aus
AGENTS/STATE/CONVENTIONS).
- Automatisierung: `scripts/gate-session-hygiene.sh`.
## 2. Kontext-Pflege
- [ ] Doku ist Single Source of Truth, keine Duplikate.
- [ ] Doc-Größenbudget eingehalten (Drift-Risiko bei überlangen Docs).
- [ ] Manifest deckt sich mit der Realität (Dateien/Tests existieren).
- [ ] Keine toten Verweise.
## 3. Token-Verbrauch
- [ ] Session-Log enthält input/output/total Tokens und Tokens-pro-Task.
- [ ] Budget nicht überschritten; auffälliges Re-Reading vermerkt.
- [ ] Trend über Sessions in `metrics/` fortgeschrieben.
→ Vollständige Tier-1/2/3-Anleitung (Session-Schnitt, Command-Disziplin,
Cache-Disziplin): **`docs/token-hygiene.md`** (Single Source of Truth).