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.
38 lines
1.7 KiB
Markdown
38 lines
1.7 KiB
Markdown
# 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 in `STATE.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 }
|
|
```
|
|
1. Ready-Set bilden (Board unten lesen).
|
|
2. Ein Item ziehen; Modell aus `docs/roles/model-routing.md` setzen.
|
|
3. Session-Prompt aus `session-prompts/` ausfüllen (Template: `session-prompts/TEMPLATE.md`).
|
|
4. **🔌/🧱** → direkt Worker. **🔬** → erst durch das Spike-Gate (`docs/loops/spike-gate.md`).
|
|
5. 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 |
|
|
|----|------|---------|--------|
|
|
| _…_ | _…_ | _…_ | _…_ |
|