Files
agent-swarm-repo/ROADMAP.md
Tarik Moussa 93e17488a5 docs: F-03/04/05 done — board aktualisiert, alle requirements done
11 Tests grün. F-06 (Integration) ist jetzt Ready-Set.
Session-Prompts für F-03/04/05 archiviert.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-03 23:42:13 +02:00

3.2 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 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.

Abhängigkeits-DAG (Projekt: tg-bot-jetson)

F-01 (Skeleton) ──┬──► F-03 (Whitelist)      ──┐
                  ├──► F-04 (Bot-Handler)     ──┼──► F-06 (Integration) ──► F-07 (Deploy)
                  └──► F-05 (Model-Connector) ──┘

Nach F-01 werden F-03, F-04 und F-05 gleichzeitig frei — alle drei können parallel dispatcht werden. F-06 bleibt ⏸ bis F-03 + F-04 + F-05 alle sind.

Board

ID Item Typ Status Prereqs Rolle · Modell Aufwand
F-01 Projekt-Skeleton (pyproject.toml, Paketstruktur, CI-Stub) 🧱 Worker · Sonnet ~0.5 d
F-03 Whitelist-Middleware (User-ID-Allowlist, Env-Var-Config) 🧱 F-01 Worker · Sonnet ~0.5 d
F-04 Telegram-Bot-Handler (Polling-Loop, /start, /help, Nachricht-Relay) 🔌 F-01 Porter · Sonnet ~1 d
F-05 Modell-HTTP-Connector (httpx-Client gegen konfigurierbaren OpenAI-compat Endpoint) 🔌 F-01 Porter · Sonnet ~0.5 d
F-06 Integration & Smoke-Test (Whitelist + Handler + Connector verdrahtet, E2E-Test) 🧱 🔲 F-03, F-04, F-05 Worker · Sonnet ~1 d
F-07 Deployment-Config (.env.example, Docker oder systemd-Unit) 🧱 F-06 Worker · Haiku ~0.5 d

F-04 ist 🔌: Referenz-Impl = python-telegram-bot-v21-Dokumentation (golden oracle vorhanden). F-05 ist 🔌: Referenz-Impl = OpenAI Chat Completions API (de-facto-Standard für selbst gehostete Modelle; Endpoint-URL ist reine Config, kein Forschungsproblem). ADR-0004 begründet, warum kein Spike nötig ist.

Done

ID Item Session Commit
F-01 Projekt-Skeleton F-01 (2026-06-03) 82eb6a6
F-03 Whitelist-Middleware F-03/04/05 (2026-06-03) de34c34
F-04 Telegram-Bot-Handler F-03/04/05 (2026-06-03) de34c34
F-05 Modell-HTTP-Connector F-03/04/05 (2026-06-03) de34c34