Add AGENTS.md, ROADMAP.md, and CLAUDE.md symlink

Onboarding doc for fresh agent sessions: stack, commands, layout,
conventions, and an Always/Never list of gotchas hit during the AI
overhaul. Current state section tracks the 1.1.0:7 checkpoint.
ROADMAP.md holds the longer-term backlog. CLAUDE.md symlinks AGENTS.md
so Claude Code loads it. Secrets kept out — private registry/file-host
URLs and creds referenced by file location, not value.

ROADMAP.md

@@ -0,0 +1,25 @@
+# ROADMAP — Proof of Work
+
+Longer-term backlog. Near-term state + next steps live in `AGENTS.md` → Current state.
+
+## AI quality
+
+- Tiered prompt formatting (also the immediate next step): JSON-Schema output enforcement via Ollama `format` and OpenAI `response_format`; pipe-separated library rows; XML-tagged prompt sections; Ollama-only few-shot example; stable prefix first for prompt-cache hits.
+- Keep `MODEL_MENU` / `PRICES` current as providers ship new models.
+
+## Packaging / distribution
+
+- Diagnose and fix the `publish.sh` Step-3 registry-register silent no-op.
+- Build for `arm` / additional arches once StartOS 0.4 supports them on the host.
+- Consider submission to the Start9 community registry (use the start9-spec-checker agent first).
+
+## Product
+
+- Adherence tracking: compare logged workouts against the planned `ProgramDay` (the `programDayId` link already exists).
+- Per-user export/import polish and scheduled backups.
+- Charts/progress views over history (the data and 1RM estimates already exist).
+
+## Hygiene
+
+- Scrub `Co-Authored-By` trailers from git history.
+- Revisit `workout-planner/` scratch dir — remove if truly unused.