neuwirth
/
pmacs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: record discovery Stage 2 framing approval 

Revision 3 was approved 2026-08-09 at 6a9a25d, after the three stale
internal references were cleared. The lane heading and the framing
status line both still said "in review", which is the kind of
contradiction that makes a reader trust whichever line they hit first.

The lane entry now also records WHAT the three review rounds found,
rather than only how many there were. A count says the doc was
reviewed; the list says what class of error it was reviewed for, which
is the part a later reader can act on.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016bqGA6s9tTUFzYpbeW3tai
This commit is contained in:
Levi Neuwirth 2026-08-09 14:00:53 +02:00
parent 0e260e0377
commit 6eecbfcca1
No known key found for this signature in database
2 changed files with 11 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/active-work.md
View File

@ -265,7 +265,7 @@ also removed: this branch's "R8 NEEDS A LANE" investigation block, and
durable facts are in the retired registry row and the handoff §6 durable facts are in the retired registry row and the handoff §6
census. census.
## Discovery Stage 2 — BRANCHED, framing in review ## Discovery Stage 2 — BRANCHED, pre-implementation
**Written with the lane's first commit**, per the standing correction **Written with the lane's first commit**, per the standing correction
from #171 and #215. from #171 and #215.
@ -275,8 +275,14 @@ from #171 and #215.
tip** — the ref, not a SHA. Recover with tip** — the ref, not a SHA. Recover with
`git fetch githubsucks && git checkout discovery-stage2`. `git fetch githubsucks && git checkout discovery-stage2`.
- **Framing `docs/discovery-stage2-framing.md`, revision 3**, in - **Framing `docs/discovery-stage2-framing.md`, revision 3, APPROVED
review. Scope: `COHERENCE.md` §5's "M-x rows are still bare names". 2026-08-09** after three review rounds. Each round found the previous
one reasoning about a mechanism instead of reading it — an in-place
field change that postcard cannot make compatible, a TUI that never
reads the message at all, a round-trip test that freezes nothing, a
cache hazard the per-peer render state makes impossible, and a
clipping rule unachievable at narrow widths.
Scope: `COHERENCE.md` §5's "M-x rows are still bare names".
Descriptions already exist on `Command` and are already rendered by Descriptions already exist on `Command` and are already rendered by
`help.list-commands`; they are missing at the one moment they would `help.list-commands`; they are missing at the one moment they would
change a decision. change a decision.

4
docs/discovery-stage2-framing.md
View File

@ -1,7 +1,7 @@
# Discovery Stage 2 — M-x rows stop being bare names # Discovery Stage 2 — M-x rows stop being bare names
**Status: framing pass, revision 3. Pre-implementation. Awaiting **Status: revision 3, APPROVED 2026-08-09. Implementation may
approval.** proceed.**
**Revision 3 fixes three things revision 2 asserted without checking **Revision 3 fixes three things revision 2 asserted without checking
the mechanism it was reasoning about**: a "frozen-shape" test that the mechanism it was reasoning about**: a "frozen-shape" test that