[MarcusJRLee]

Replaces the 63 numbered, append-only decision records with 15 topic records. Each one states the current decision; superseded history stays in git at 3ddc739.

Record	Former numbers
Platform and scope	0001, 0029
Portable Voice engine	0035, 0039, 0057
Inputs, Profiles, and Actions	0004, 0014, 0016, 0018, 0034
Visual design	0003, 0008, 0013, 0063
macOS text delivery	0002, 0005, 0006, 0007, 0009
macOS speech capture	0005, 0010, 0011, 0012, 0015, 0017, 0022
Local AI formatting	0020, 0021, 0053, 0054, 0058
Voice History	0030, 0031, 0032, 0036, 0038, 0043
Model packages	0037, 0041, 0061, 0062
Speech recognition runtime	0042, 0055, 0056, 0060
iOS capture	0040, 0046, 0050
iOS keyboard delivery	0044, 0045, 0047, 0048
Local-only boundary	0033, 0049
Identity and licensing	0024–0028
Builds and workflow	0019, 0023, 0051, 0052, 0059

• docs/decisions/README.md maps each former number to its topic record.
• All links in the docs and decision references in code comments now point at the topic records.
• The rule in CLAUDE.md/AGENTS.md changes from "never rewrite a superseded decision" to "edit the topic's record and say what changed". README and CONTRIBUTING are updated to match.
• The records total 1,354 lines, down from 4,569. They keep current rules, the deciding matrices, key measurements, and open evidence gates, and drop narrative, superseded options, and per-milestone test counts.

scripts/check.sh and scripts/check_fast.sh pass. The only code changes are comments.

🤖 Generated with Claude Code