Files
agent-swarm-repo/docs/adr/0004-modell-api-spike-first.md
Tarik Moussa b7b6766364 docs: bootstrap tg-bot-jetson — board, ADRs, state, session-prompts
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>
2026-06-03 23:24:13 +02:00

16 lines
969 B
Markdown

# 0004 — Modell-API-Format: erst Spike, dann Connector
- **Status:** accepted
- **Kontext:** Der Jetson Orin Nano Super hostet ein lokales Modell. Das
Endpoint-Schema ist nicht festgelegt (mögliche Backends: Ollama,
llama.cpp-HTTP-Server, vLLM, custom FastAPI). Kein golden oracle.
- **Entscheidung:** F-02 (🔬 Spike) läuft **vor** F-05 (🔌 Connector).
Der Spike bestimmt das tatsächliche API-Schema und erzeugt eine
Mini-Spec (`spike/model-api/spec.md`). F-05 portiert gegen diese Spec.
- **GO-Kriterium:** Python-Skript sendet eine Test-Nachricht und empfängt
eine nicht-leere Antwort vom lokalen Server. Latenz < 30 s akzeptabel.
- **NO-GO-Kriterium:** Kein Endpoint erreichbar oder Antwort-Format
vollständig undokumentiert Human-Entscheid, welcher Backend aufzusetzen.
- **Konsequenz:** F-05 bleibt bis Spike + GO. Wenn NO-GO: blocked-extern.
Spike-Branch `spike/model-api` wird nach GO verworfen; Spec bleibt in `docs/`.