docs: align README with go-coding layout, drop the Status column

[sebastian-iancu]

Summary

Readability and AI-tell cleanup of the human-facing docs, with README.md restructured to follow the go-coding-plugin README.

README.md

• Section order now matches go-coding: intro (hosts and hook set named), Requirements, Features, Installation, Components, a grounding-sources paragraph, one plugin-specific section (How it decides), Development, Documentation, the AGENTS.md pointer, License.
• The Status column is gone from Components. Every row said shipped.
• The rule that defines it is folded into How it decides. The full rule still lives in references/claims-and-evidence.md.
• New: Routing and Cursor parity features, a references/vale.ini row, and a sentence on the agents' Bash-but-no-Write tool grant.
• Over-broad claims fixed after checking them against the tree:
  • Not every skill applies the claims rule; /docs-lint-setup does not.
  • The read-the-repo-first step lives in the router and the Cursor rule, not in each skill.
  • seo-auditor uses Bash for builds, greps, and fetches, not for linters.
  • doc-types.md §3 lists four inversions for agent-instruction files, not three.

docs/

• install.md:
  • Line edits.
  • The host differences now include the Cursor-only rule.
  • The _vale.ini alternative is now mentioned.
  • "Save hook" is now "prose-lint hook".
• testing.md:
  • CI runs scripts/validate.py directly and installs Python 3; it does not run validate.sh or pin a Python version.
  • A missing agent tools: key is also an error.
• authoring.md: ai-tells.md is added to the references list, and one sentence with stacked colons is rewritten.

CHANGELOG.md: new [Unreleased] bullets under Changed and Fixed.

Agent-instruction files (AGENTS.md, CLAUDE.md, skills, agents, rules) and references/ are untouched.

Verification

• ./scripts/validate.sh: OK, including Markdown links and anchors.
• claude plugin validate .: passed. Its two warnings are about unquoted ${CLAUDE_PLUGIN_ROOT} in hooks/hooks.json; they were already there and are not part of this change.
• Vale 3.18.0 with the plugin's references/vale.ini and the ai-tells style:
  • 329 alerts before, 315 after, over README, docs/, CHANGELOG, and the PR template.
  • No ai-tells alerts and no em dashes.
  • The only error left is the quoted, planted "simply" in a testing.md test recipe, plus Cadasto hits because the seed vocabulary does not list it.
• prose-reviewer agent pass over the diff; its findings are fixed in this PR.

Checklist

• ./scripts/validate.sh passes
• claude plugin validate . passes
• No unsourced claim added
• Inventories and counts in README verified against the tree
• Version bump: not needed (docs only; entries sit under [Unreleased])

🤖 Generated with Claude Code