[Xuepoo]

Summary

• Rewrites the canonical user document (README.md) with the fixed top-level order: Overview, Install, Commands, Configuration, Keybindings, Troubleshooting. Existing scope, rules, non-goals, and compat sections remain below.
• Documents the five declared chord settings (open_chord, newline, submit, close, external_editor) with manifest types/defaults, all five commands, and the suggested/in-modal bindings.
• Extends tests/settings-declarations.test.ts with a README parity assertion backed by scripts/check-readme-settings.mjs: a declared key missing from the table, an extra documented key, or a type/default mismatch fails.
• Fixes stale prose that contradicted the manifest (bitty >=0.5,<1.0, old event list, SDK pin d5d117d). No behavior change.

Verification

• just check (fmt, markdownlint, metadata, hygiene, paths, manifest, Lua parse + control, 87 bun tests): pass.
• The parity test fails by construction on a removed or invented key.

Notes

• Repo has no P2 label; used the existing P1 priority label and area:architecture.

Docs

Priority: P2 | Area: plugins | Labels: docs, P1, area:architecture