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.
1.7 KiB
1.7 KiB
ROADMAP — Board & Ready-Set
Eingang des Feature-Loops und der Abhängigkeits-DAG: jedes Item kennt seine Prerequisites. Der Leader berechnet jeden Zyklus das Ready-Set und dispatcht nur daraus.
ROADMAP vs. STATE: ROADMAP = der ganze geplante Graph (Planungsebene).
STATE.md= was gerade jetzt läuft (Live-Ebene: Now / In Progress / Blocked). Ein Item wandert: ROADMAP-🔲→ beim Dispatch inSTATE.md„In Progress" → bei Merge zurück als ROADMAP-✅in „Done".
Legende
- Typ: 🔌 port (Referenz-Impl/golden oracle) · 🔬 research (nur Paper-Formeln) · 🧱 infra
- Status: ✅ done · 🔲 ready · ⏸ blocked-by-prereq · ⛔ blocked-extern (Lizenz/Mensch-Entscheid)
Ready-Set-Regel (so dispatcht der Leader)
Ready-Set = { Items mit Status 🔲, deren Prereqs ALLE ✅ sind }
- Ready-Set bilden (Board unten lesen).
- Ein Item ziehen; Modell aus
docs/roles/model-routing.mdsetzen. - Session-Prompt aus
session-prompts/ausfüllen (Template:session-prompts/TEMPLATE.md). - 🔌/🧱 → direkt Worker. 🔬 → erst durch das Spike-Gate (
docs/loops/spike-gate.md). - Nach Implement: Review-Gate (Opus) → Merge → Item hier auf ✅, Dependents werden frei.
Board
| ID | Item | Typ | Status | Prereqs | Rolle · Modell | Aufwand |
|---|---|---|---|---|---|---|
| F-01 | <Feature/Paket> | 🔌 | 🔲 | — | Porter · Sonnet | … |
| F-02 | <Feature/Paket> | 🔬 | ⏸ | F-01 | Theorist · Opus | … |
Ein durchgespieltes, befülltes Board:
examples/walkthrough/ROADMAP.md.
Done
| ID | Item | Session | Commit |
|---|---|---|---|
| … | … | … | … |