Plan the comprehension work from the nine-seat panel

This commit was merged in pull request #2.
This commit is contained in:
2026-09-24 21:02:10 +02:00
parent 9a2eff3005
commit c791fb3c2c
+12 -6
View File
@@ -2,9 +2,15 @@
## 0.1.0
- Delete `agent-shared/`: no agent carries its markers, and its memory system contradicts the agents' own no-private-memory rule.
- Keep the comment and prose bar in `CLAUDE.md` only, and point `agents/stability-reviewer.md` §10 and `skills/larv-review/SKILL.md` §7 at it.
- Replace `/home/lilleman/…` in `agents/*.md` and `settings.json` with a path that holds on another machine.
- Give the `CLAUDE.md` sections `skills/larv-review/SKILL.md` cites headings it can name.
- Give the README gate, the architecture gate, the merge gate and the stability reviewer four different words; today all four are "gate".
- Raise the comprehension panel above the 7.0 floor: the 2026-09-24 four-seat run scored 5 overall, capped at 4 by Locality and Self-sufficiency, on the items above.
Nine-seat comprehension panel, 2026-09-24, depth 1: Navigation 7.6, Locality 5.0, Shape 6.2, Self-sufficiency 5.3, overall 5.9. Every seat was capped by Locality or Self-sufficiency, and seven of nine named `bin/loop-claude`'s round loop as the unit they would least want to modify. The items below are ordered by how many seats named the place and how much of the cap it carries; each is one chunk.
- Delete `agent-shared/`: no agent carries its markers, its check passes over zero files, and its memory system contradicts the agents' own "do not keep private memory" rule. Named by all nine seats as the costliest wrong turn.
- Move the reviewer protocol into one file, `agents/review-protocol.md`, that the three agents and `skills/larv-review/SKILL.md` point at with a bare link: the verdict words (`BLOCK`, `ALIGN`, `APPROVE`, `APPROVE WITH NITS`), the severity glyphs, the 🔀 escalation, the decline rule, the round caps and the "Documenting decisions" section. Today those are four copies in five files and the loop exit depends on them agreeing.
- Cite `CLAUDE.md` by heading everywhere a skill or agent says "the global X rules", "the decline rule above" or "the global working loop", and delete the copies of the comment bar in `agents/stability-reviewer.md` §10 and `skills/larv-review/SKILL.md` §7 in favour of the link.
- Keep the pipeline order and the prose-only path in `skills/larv-review/SKILL.md` alone; its frontmatter, its §8 preamble, its §12 summary list and `CLAUDE.md`'s working loop each spell it today.
- State in `bin/loop-claude`'s docstring the Claude Code internals it rests on, with the version they were observed on (2.1.281): the transcript entry shapes `human_turns` reads, the `<id>.jsonl` file and its `.superseded-*`/`.orphaned-*` siblings, `~/.claude.json`'s `hasTrustDialogAccepted`, and `--json-schema` returning `structured_output`. Seven seats reconstructed these from the tests.
- Fix in `bin/loop-claude`: a judge failure re-judges after a minute instead of re-running the worker with "stopped before it was finished"; the failure counter survives a reload; `reload_if_edited` runs the new file with `--help` before exec so an import-time error keeps the old one; every directory `archive` creates is 0700, not only the leaf; `human_turns` states the list case positively; `project_path` and `session_name` share one branch; `sections` stops at any heading. Add a test for `run_round`'s resume decision against a stub `claude`.
- Replace `/home/lilleman` in `settings.json` (lines 9, 16, 59) and the three agents' principles pointers with a form that holds on another machine, and read the status line's time zone from the environment instead of `statusline.sh:65`.
- Give the four things called "gate" (README gate, architecture gate, green gate, stability reviewer) one word each, and stop "round", "session", "handoff" and "memory" from each meaning two things across `CLAUDE.md`, `bin/loop-claude` and the skills.
- Make `README.md`'s first line name every top-level entry (`AGENTS.md`, `statusline.sh`, `principles/`), make `principles/README.md` say who the principles are for instead of "Org-wide", and give the decision title "Merged under the comprehension floor" a subject.
- Re-run the four-seat scoring panel and record the score in `docs/decisions.md`; the target is every dimension at 7.0 or above.