David F GliddenandClaude Opus 5
9c826d1680
The amendment stated the rule in the body, but the frontmatter description — which is what recall matches on — still described only the July note. A rule that only exists below the fold is a note. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T1i5VRfHjD79hfaXjWsBXA
3.4 KiB
name, description, metadata
| name | description | metadata | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| feedback-governance-drafting-copy-paste-clean | Entries go over FENCED; whitespace or line-anchored REPAIRS go over as a COMMAND — a fence renders the whitespace and the whitespace is the payload. Verify by exact-string check with a negative control; the original 'by eye' clause is SUPERSEDED (2026-09-10), because a `##` with two leading spaces renders perfectly and parses as nothing. |
|
When drafting a PENDING/REVIEWED entry for the steward to place (the copy-paste draft in a package Addendum or in chat), format it as a clean, paste-ready block: plain ## REVIEWED-N — title header, standard field lines, no **bold** wrapping of the header and no > blockquote framing for display.
Why: the draft's display formatting leaks into the placed record. Cost (2026-07-16): REVIEWED-59's header landed in ~/REVIEWED.md as a bolded, blockquoted non-header — unrecognized as a section — because my drafts doc had styled it for display; the steward had to strip the ** by hand. The steward's paste action is mechanical by design; the draft must be byte-ready.
How to apply: in any REVIEWED draft (steward copy-paste) section, emit the block inside a fenced code block (markdown … ) so no styling is interpreted, headers are plain ##, and the steward can select-copy the interior verbatim. Verify the draft parses as intended by eye at the placed location's conventions, not the draft doc's.
Authorized at the 2026-07-19 harvest review (steward). Kin: feedback-checkable-claim-surfaces-bugs (the record's form is part of its correctness).
AMENDMENT — 2026-09-10. The last clause is superseded, and the remedy has a case where it is the cause.
Joined, not rewritten, so the original stays visible — the same discipline the register uses for a placed entry.
⚠ "Verify the draft parses as intended BY EYE" is SUPERSEDED. By eye is precisely what cannot catch the worst case. REVIEWED-138 was placed with two leading spaces before its ##. CommonMark permits up to three, so it rendered as a flawless heading and read as correct to everyone who looked at it — while grep -c "^## REVIEWED-13[89]" returned 1, not 2, making the ruling invisible to the wake digest, governance-drift-check.py, governance_item and every scan of that sitting. Replace with: verify by exact-string comparison against the draft, with a negative control proving the check can fail. Over four defects in one day, eye caught none; the check caught all four in minutes.
⚠ AND THE FENCED BLOCK IS THE CAUSE IN ONE NARROW CASE. Indentation is exactly what a fenced block in transit adds. For an ordinary entry this is harmless — prose reflows and a heading survives. For a whitespace-only or line-anchored repair, text-to-paste is the wrong instrument: hand the fix over as a COMMAND the steward runs, which never traverses the paste path at all. Proven the same day: the fenced replacement introduced the defect; the sed one-liner did not.
The rule, restated whole: fenced, paste-ready blocks for entries; a command for repairs; and an exact-string check with a negative control for both, in place of the eye.
Evidence: PENDING-181 ADDENDUM 1 and ADDENDUM 2 — six transit corruptions, three distinct mechanisms, of which only two are catchable by reading at all.