docs(cli): split amy docs by responsibility + add amy-expert skill
Separate the single DEVELOPMENT.md into focused docs per audience:
- cli/README.md — trim agent/interop sub-sections; user-facing contract,
commands, data-dir, troubleshooting only.
- cli/DEVELOPMENT.md — pared down to architecture, how-to-add-a-command,
output conventions, testing, housekeeping.
- cli/ROADMAP.md (new) — north-star, parity matrix, ordered milestones,
non-goals. The live checklist for CLI feature parity.
- cli/plans/2026-04-21-cli-distribution.md (new) — packaging strategy
(Homebrew / winget / Scoop / deb / rpm / AUR / AppImage).
- commons/plans/2026-04-21-event-renderer.md (new) — cross-cutting
renderer design owned by commons, consumed by cli + desktop + android.
Agentic routing:
- .claude/skills/amy-expert/SKILL.md (new) — routing triggers + the
five hard rules (thin-layer, JSON contract, non-interactive,
data-dir-is-world, extract-before-adding).
- references/command-template.md, extraction-recipe.md,
output-conventions.md — bundled copy-paste references.
Root .claude/CLAUDE.md:
- Adds cli/ to the module list with its sharing rule.
- Registers amy-expert in the skills table.
- Documents per-module plans/ convention; freezes docs/plans/.
https://claude.ai/code/session_01BQ5ZHwa8BAgEQ9zeM4CKhW
Claude
9b9084ffaf