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>
This commit is contained in:
15
docs/adr/0004-modell-api-spike-first.md
Normal file
15
docs/adr/0004-modell-api-spike-first.md
Normal file
@@ -0,0 +1,15 @@
|
||||
# 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/`.
|
||||
Reference in New Issue
Block a user