user2595/agent-swarm-repo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
874fcd2ea6f7ec0156de02948b078b62062b1450
agent-swarm-repo/docs/gates/observability-gates.md
Tarik Moussa 696eddb5ef
Some checks failed
gates / quality (push) Has been cancelled
Details
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

929 B
Raw Blame History

Observability-Gates

Überwachen das System, nicht ein einzelnes Feature. Speisen den Audit-Loop.

1. System-Effizienz (Metriken über Zeit)

  • Features pro Session · Rework-Rate (Commits, die frühere Arbeit korrigieren)
  • Test-Pass-Rate · Tokens pro Feature · Zykluszeit · Gate-Fehlerquote
  • Quelle: Session-Logs + Git-Log, aggregiert von scripts/metrics.sh nach metrics/.

2. Doku-Drift (automatisch erkennbar)

  • Jeder Manifest-Eintrag: referenzierte Datei existiert und Test grün?
  • STATE.md "Now" nicht älter als N Sessions (Stale-Signal).
  • Code ohne Doc-Änderung / Doc ohne Code-Änderung -> Drift-Verdacht (Heuristik aus git diff --name-only).
  • Tote Links / referenzierte, aber fehlende ADRs.
  • Quelle: scripts/gate-doc-drift.sh. Befund -> sofortiger Audit-Trigger.

Schwellen (anpassbar)

Rework-Rate > 20 %, Stale-State > 3 Sessions oder Drift-Treffer > 0 ⇒ Audit-Loop.