Tarik Moussa
696eddb5ef
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.
Worked Example — „DemoLinks" (ein URL-Shortener)
Eine befüllte Momentaufnahme des Betriebsmodells, damit man sieht wie der ausgefüllte Zustand aussieht — nicht nur die Platzhalter. Erfundene, generische Domäne; nichts davon muss man bauen.
Was hier passiert ist (Story)
- Bootstrap: Leader hat aus dem Brief „kleiner URL-Shortener" das Board
(
ROADMAP.md) mit vier Items + Abhängigkeits-DAG erzeugt. - Feature-Loop, Zyklus 1: Ready-Set war
{F-01}. Worker (Sonnet) hat die Storage-Schicht gebaut → Review-Gate (Opus) APPROVE → gemerged. Belegt im Session-Log (sessions/2026-06-03-S1.md) und als Entscheidung im ADR (docs/adr/0002-storage-keyvalue.md). - Jetzt: Ready-Set ist
{F-02, F-03}. Für F-02 (🔌 Port) liegt ein fertiger Session-Prompt bereit (session-prompts/F-02.md). F-03 (🔬 Research) muss zuerst durch das Spike-Gate. Live-Stand:STATE.md. - Audit-Loop, parallel: Ein kalter Auditor hat an F-01 ein „untested claim"
gefunden (
audits/2026-06-04-storage.md) und eine Korrektur-Task mit Model-Zuweisung eingestellt.
Worauf man achten sollte
- Board als DAG: F-04 ist
⏸weil sein Prereq F-02 noch nicht✅ist — der Leader dispatcht es gar nicht erst. F-03 zeigt die🔬-Spur (Spike vor Code). - Port vs. Research: F-02 hat eine Referenz-Impl (golden oracle) → Worker direkt. F-03 hat keine → Theorist → Spike → GO/NO-GO.
- Ownership-Tabelle in
STATE.md: jedes Paket hat disjunkte Pfade (mit Slash) — genau das prüftscripts/gate-ownership.sh. - Spuren-Vollständigkeit: ROADMAP (Plan) ↔ STATE (Live) ↔ Session-Log (was lief) ↔ ADR (warum) ↔ Audit (was driftet). Ein kalter Agent rekonstruiert daraus alles.