Flip considering-state to done+merged+live-confirmed. Strike the streaming item — the considering-state reframes the wait and is tested/live; real streaming's transport rework + mid-stream failure surface isn't worth it for the POC. Streaming spec retained as a record (banner SHELVED). Includes the human's folded-in further-down roadmap ideas. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
/docs — cross-cutting docs
Anything affecting both client and api, plus planning and roadmap. Side-specific docs live in /api/docs and /client/docs.
Put here:
roadmap.md— phases, POC scope, what's nextadr/— Architecture Decision Records- Shared contracts — canon log schema, tag syntax, retry policy (§11, §12)
- Anything spanning the HTTP boundary
The charter itself — CLAUDE.md — stays at the repo root. It is the source of truth; these docs elaborate, they do not override it.