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

969 B

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