M2 core experiment. Server owns persona+knowledge (spoilers/IP, no DB); client owns live state and computes available_moves. Free text straight to the NPC prompt (no Adjudicator). Sibling NpcService + pure MoveValidator; moves validated against state, invalid dropped, prose always kept (§6). 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.