user2595/agent-swarm-repo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: bootstrap tg-bot-jetson — board, ADRs, state, session-prompts

Browse Source 
ROADMAP mit 7 Items (F-01…F-07) und DAG. STATE aktiviert. CONVENTIONS
projektspezifisch ergänzt. ADRs 0002-0004 (Stack, Whitelist, Spike-Gate).
Kaltstartfähige Prompts für F-01 (Skeleton) und F-02 (API-Spike) erzeugt.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Tarik Moussa
2026-06-03 23:24:13 +02:00
parent 49cbd00677
commit b7b6766364
10 changed files with 288 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
ROADMAP.md
View File

@@ -23,15 +23,38 @@ Ready-Set = { Items mit Status 🔲, deren Prereqs ALLE ✅ sind }
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) ──┘
F-02 (API-Spike) ──► F-05
```
> F-02 ist 🔬: Spike-Gate muss durch, bevor F-05 dispatcht wird.
> F-05 bleibt ⏸ bis F-01 **und** F-02 ✅ sind.
> F-06 bleibt ⏸ bis F-03, F-04 **und** F-05 ✅ sind.
> F-07 bleibt ⏸ bis F-06 ✅ ist.
## Board
| ID | Item | Typ | Status | Prereqs | Rolle · Modell | Aufwand |
|----|------|-----|--------|---------|----------------|---------|
| _F-01_ | _<Feature/Paket>_ | 🔌 | 🔲 | — | Porter · Sonnet | _…_ |
| _F-02_ | _<Feature/Paket>_ | 🔬 | ⏸ | F-01 | Theorist · Opus | _…_ |
| F-01 | Projekt-Skeleton (pyproject.toml, Paketstruktur, CI-Stub) | 🧱 | 🔲 | — | Worker · Sonnet | ~0.5 d |
| F-02 | Spike: Modell-API-Format (welches Endpoint-Schema exponiert der Jetson-Server?) | 🔬 | 🔲 | — | Theorist · Opus → Spike | ~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 (async httpx-Client zum lokalen Modell-Server) | 🔌 | ⏸ | F-01, F-02 | 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ür Jetson) | 🧱 | ⏸ | F-06 | Worker · Haiku | ~0.5 d |
> Ein durchgespieltes, befülltes Board: `examples/walkthrough/ROADMAP.md`.
> F-02 ist `🔬`: vor Produktionscode erst **Spike** (`docs/loops/spike-gate.md`) —
> Nachweis, dass wir den Modell-Server erfolgreich ansprechen können (Connectivity-GO).
> F-04 ist `🔌`: Referenz-Impl = python-telegram-bot-v21-Doku (golden oracle vorhanden).
> F-05 ist `🔌`: Referenz-Impl entsteht aus F-02-Spike-Spec.
## Done
| ID | Item | Session | Commit |
|----|------|---------|--------|
| _…_ | _…_ | _…_ | _…_ |
| — | — | — | — |