2eca418c9f162d214a75eeab89abbe90da19b61a

Message

docs: add plan and agent instructions

Diff

This diff is truncated to protect this page.

 1diff --git a/AGENTS.md b/AGENTS.md
 2new file mode 100644
 3index 0000000000000000000000000000000000000000..347bc583f7800d25363d126ec9fd2196b0638910
 4--- /dev/null
 5+++ b/AGENTS.md
 6@@ -0,0 +1,20 @@
 7+# Project instructions
 8+
 9+## Model services
10+
11+Model services are external, user-managed processes. GPU VRAM is normally almost fully allocated to the chat model.
12+
13+- Never start, stop, restart, kill, supervise, or reconfigure `llama-server`, `audiocpp_server`, or `whisper-server`.
14+- Never run `llama-cli`, download a model, or use a command that can load a model into VRAM.
15+- Do not add server-launcher or model-management code to this repository.
16+- The application is an HTTP client only. Configure endpoints with flags or environment variables and report unavailable services clearly.
17+- Automated tests must use fake HTTP services. Only the user may prepare live services for manual integration.
18+
19+See `PLAN.md` for the endpoint contract, expected externally managed models, and implementation sequence.
20+
21+## Product invariants
22+
23+- Render romaji only; never show kana or kanji in the TUI.
24+- NPCs behave as normal people, not language teachers. Grading stays separate from NPC dialogue.
25+- Persona-authoring prompts contain no game, player, NPC, quest, or scenario context.
26+- Keep the Bubble Tea event loop non-blocking.
27diff --git a/PLAN.md b/PLAN.md
28new file mode 100644
29index 0000000000000000000000000000000000000000..79c332864f320c3c62cbeb4fbd26d8936fa11383
30--- /dev/null
31+++ b/PLAN.md
32@@ -0,0 +1,186 @@
33+# Japanese learning RPG — implementation plan
34+
35+## Outcome
36+Create a lightweight local Japanese conversation game in Go. The player moves through a small ASCII city in a Bubble Tea TUI, speaks to workers through a microphone, hears Japanese responses, and gets separate fluency feedback.
37+
38+The first demo has three free-roam locations: a ramen shop, a station, and tourist information. There is no save, XP, unlock system, or model-server lifecycle management.
39+
40+## Fixed product rules
41+- UI text is romaji only. Never display kana or kanji in the TUI.
42+- NPC speech plays immediately, but its text stays hidden. `R` reveals romaji; `T` then reveals the already-generated English translation.
43+- Each player turn gets a separate score and short correction in romaji.