Editing pass over the docs and code comments before the v0.2.0 release

[MJohnson459]

Editing pass over the docs and code comments before v0.2.0, on branch task-458-docs-editing (4 commits, split as the task asked).

Commit 1 (7e41d40) is the rewrap alone: DESIGN.md hard-wrapped at 80 columns (byte length, so the acceptance awk passes under a byte-counting awk too). Verified as a no-op on the rendered text by mechanically rejoining the wrapped lines and comparing paragraph-by-paragraph against the original — 167 paragraphs, zero differences. Fenced code blocks and table rows byte-identical.

Commit 2 (3520b89) is the trim: cut passages narrating how a design point evolved, what it replaced, or what was rejected (fork-delivery story, the pre-repos migration narrative, the incomplete-report marker-placement history, the planning-session reversal story, the liveness-source rule-it-replaces, the not-done listing history, and the like), keeping rationale where the alternative is still live. Header block rewritten — no more "Status: Draft / Date: 2026-07-08"; it now states what the document is. §10 reframed as a record of the staged delivery (structure kept, second-person coaching removed). §11 shrunk to per-question resolution notes; headings 1–12 and the (a)/(b)/(c) anchors preserved, so all 646 §-references in code still resolve (checked §1–§12, §11a, §11c against the headings).

WORD COUNT, flagged for your judgement: 32,494 → 28,750, about 12% — short of the third the task named as a reasonable aim. Judged passage by passage, the rest of the doc is operative design plus still-live rationale of exactly the kind the task says to keep (much of it decision records you have previously asked to keep — scoring bonuses, the pr verb, the gutter rendering). Cutting to ~22k words means dropping recorded decision rationale wholesale; say the word and I will make that pass, but I did not want to do it silently. The task itself listed the word target under "where I was guessing".

Commit 3 (1b426d2) is the code-comment pass: all 76 task/PR citations removed across both crates (plus the bare #NNN forms the count missed), DESIGN.md §-pointers kept, and the handful of used-to/defect-N/corrected comments rephrased to state the invariant instead of the history. The diff is comment-only — verified mechanically that no added or removed line is a non-comment line.

Commit 4 (d120696) is the satellite docs: agent-integration.md trimmed where it restated DESIGN.md §8 and its over-long snippet lines wrapped; voro-cli SKILL.md fixed — it documented voro answer <id> TEXT, a verb that no longer exists (now voro resume, no answer text recorded); verify SKILL.md fixed — refresh is ctrl-r now that r refines, and the cap-phrase list it named (3 phrases) is superseded by CAP_SIGNATURES (8) in voro-core; README needed only a hyphen.

Also flagged, not fixed: §11's note (b) still claims a git diff --stat summary in the detail pane as one of the three diff paths — I kept the claim verbatim and did not verify that pane exists; if it never shipped, that sentence is a §10-style judgement call for you. The §6 state table rows and the agent-integration hook-table rows remain over 80/100 columns — tables cannot wrap without breaking, which the task exempts; the hook-table cells were shortened substantially instead.

Verified: cargo test --workspace (4 binaries, all ok), cargo clippy --workspace --all-targets -D warnings clean, cargo fmt --all --check clean, awk 'length>80' on DESIGN.md shows only fence contents and table rows, grep -rE 'task #[0-9]+' over crates returns nothing, CHANGELOG.md untouched.