Skip to content

docs: README describes the machinery; prose cap 540 -> 580 under review - #317

Merged
iselur merged 1 commit into
ready-for-mainfrom
docs/readme-human
Aug 11, 2026
Merged

iselur merged 1 commit into
ready-for-mainfrom
docs/readme-human

Conversation

@iselur

@iselur iselur commented Aug 11, 2026

Copy link
Copy Markdown
Owner

docs: README describes the machinery, not just the shape

Round-1 review of the promotion union found two material overclaims in the
first rewrite, and the owner's objection was the opposite of subtle: it read
as a dumbed-down summary of a system that is mostly machinery.

Both are fixed by the same rewrite. It now names the two loops explicitly,
and then says what actually holds them up - bound specs and approval files,
worktree isolation with the external-CLI-versus-subagent distinction stated
rather than glossed, installed-test restoration at grading time, schema-validated
verdicts that bind only the diff they saw, instance-level self-review refusal,
capped attempts and capped review rounds, replayable per-attempt evidence, the
autonomy grant file, and the prose cap itself.

The two review findings, specifically:

  • isolation is no longer promised uniformly; the subagent worker sharing the
    orchestrator trust domain is stated in the same sentence as the guarantee.
  • promotion to main is no longer promised as an owner-only human stop; the
    gated orchestrator path and its two gates are stated.

tests/prose_cap.sh: total cap 540 -> 580, deliberately and under review, which
is the sanctioned way that test says to grow. Per-file caps are untouched, so
the room is not general. README 88/100, total 568/580.

Co-Authored-By: Claude Opus 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01Qf23KhWPPDWVQZq8rAiGK5

Round-1 review of the promotion union found two material overclaims in the
first rewrite, and the owner's objection was the opposite of subtle: it read
as a dumbed-down summary of a system that is mostly machinery.

Both are fixed by the same rewrite. It now names the two loops explicitly,
and then says what actually holds them up - bound specs and approval files,
worktree isolation with the external-CLI-versus-subagent distinction stated
rather than glossed, installed-test restoration at grading time, schema-validated
verdicts that bind only the diff they saw, instance-level self-review refusal,
capped attempts and capped review rounds, replayable per-attempt evidence, the
autonomy grant file, and the prose cap itself.

The two review findings, specifically:
  - isolation is no longer promised uniformly; the subagent worker sharing the
    orchestrator trust domain is stated in the same sentence as the guarantee.
  - promotion to main is no longer promised as an owner-only human stop; the
    gated orchestrator path and its two gates are stated.

tests/prose_cap.sh: total cap 540 -> 580, deliberately and under review, which
is the sanctioned way that test says to grow. Per-file caps are untouched, so
the room is not general. README 88/100, total 568/580.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qf23KhWPPDWVQZq8rAiGK5
@iselur
iselur merged commit e888a8a into ready-for-main Aug 11, 2026
1 check passed
@iselur
iselur deleted the docs/readme-human branch August 11, 2026 22:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant