Docs: "A Second Reader" — the fleet's first note on multi-model onboarding - #190
Conversation
…nboarding A short new chapter on docs/the-fleet/night-three/, opening honestly on the smallest true fact available: a Codex-based agent has left a git ref inside the agent-ready checkout while reading its conventions — no commit, no PR, nothing merged. Frames CLAUDE.md as this fleet's dialect and AGENTS.md as the model-agnostic constitution that made that reader possible, and adds one law to the running constitution. Reuses the-fleet's existing cultural theme switcher verbatim (same 7 keys, same localStorage["mm-theme"]). night-two gains a forward link to the new chapter. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
4f6cadf to
08b4684
Compare
docs/the-fleet/night-four/ narrates this week's real payoff to night-three's
opening: a second-vendor (Codex-based) agent, asked to land a finished green
PR, refused to bypass branch protection — the same rule a Claude worker would
have obeyed, holding on first contact with a different model. The required
orchestrator-approval status then had no automation left to post it, so the
PR sat green-but-blocked for two days: a gate built to keep merges deliberate
had, for a while, no one available to open it. One new incident-ledger entry
records the lesson ("a required check with no one to sign it is not a gate,
it's a wall"), and the closing section notes, honestly, that this very PR is
itself still waiting behind the same door as you read it.
night-three gains a forward nav link to this chapter. Reuses the existing
theme engine verbatim (same 7 keys, same localStorage["mm-theme"]) — verified
structurally identical to night-three's already-tested engine (title-only
diff in the head/style/svg/switcher block, whitespace-only diff in the script
tail) and HTML tag-balance checked.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
night-one's constitution ends at law V (5 laws, default counter-reset:
law = 0, incrementing to 1..5 = I..V, confirmed by rendering it). Night-
three adds one new law meant to continue that sequence as the 6th entry,
but its inline `counter-reset: law 6` plus the shared `.n { counter-
increment: law }` (by 1) produced 7, not 6 -- rendering "VII" and skipping
"VI" entirely. Confirmed empirically: headless-rendered before this fix,
the law-item read "VII"; the intended/correct numeral, given night-one's
I-V, is "VI".
Fix: counter-reset: law 6 -> law 5, so 5+1=6 renders "VI". Re-rendered
and confirmed. Single-line, single-file change -- night-one, night-four,
and night-five are separate documents with their own isolated counter
scope and are unaffected regardless (verified: neither has any law-item
content to shift).
🤖 Generated with Claude Code
Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
|
Fixed the constitution-numbering off-by-one on this branch @ e5e9fb9 (flagged earlier on PR #195 while reading this content for reference — investigated and confirmed before touching anything, per instruction). Verdict: real bug, not intentional. Evidence:
Fix: New head: |
…#195) * Docs: add "A Second Reader" — the fleet's first note on multi-model onboarding A short new chapter on docs/the-fleet/night-three/, opening honestly on the smallest true fact available: a Codex-based agent has left a git ref inside the agent-ready checkout while reading its conventions — no commit, no PR, nothing merged. Frames CLAUDE.md as this fleet's dialect and AGENTS.md as the model-agnostic constitution that made that reader possible, and adds one law to the running constitution. Reuses the-fleet's existing cultural theme switcher verbatim (same 7 keys, same localStorage["mm-theme"]). night-two gains a forward link to the new chapter. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> * Docs: add "The Door That Held Too Well" — night-four of the fleet story docs/the-fleet/night-four/ narrates this week's real payoff to night-three's opening: a second-vendor (Codex-based) agent, asked to land a finished green PR, refused to bypass branch protection — the same rule a Claude worker would have obeyed, holding on first contact with a different model. The required orchestrator-approval status then had no automation left to post it, so the PR sat green-but-blocked for two days: a gate built to keep merges deliberate had, for a while, no one available to open it. One new incident-ledger entry records the lesson ("a required check with no one to sign it is not a gate, it's a wall"), and the closing section notes, honestly, that this very PR is itself still waiting behind the same door as you read it. night-three gains a forward nav link to this chapter. Reuses the existing theme engine verbatim (same 7 keys, same localStorage["mm-theme"]) — verified structurally identical to night-three's already-tested engine (title-only diff in the head/style/svg/switcher block, whitespace-only diff in the script tail) and HTML tag-balance checked. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> * Docs: add "Who Verifies the Verifier" — night five of the fleet story The fleet's fourth chapter, following night four ("The Door That Held Too Well"). Grounded in what actually happened today: - The fleet chartered a fourth role, the Assayer (docs/the-fleet/ THE-ASSAYER.md, PR #192) -- an independent verifier that tests claims against evidence, never produces the work it judges, and voids its own verdict if it can't attach reproducible evidence. - Its first live run: it independently re-derived a worker's claim about agent-ready's code_coverage gate and confirmed it -- catching along the way that one cited "quote" was actually a paraphrase, not verbatim. - The same day, it was turned on the orchestrator's own legibility fix (PR #191) and found a real gap: --bone-faint was still failing WCAG AA in the terminal theme, propped up only by an unmeasured halo. Re-checked further, the gap was wider than first flagged -- all four fixed themes were short on the color math alone. That fix is what actually shipped as the hardening commit on #191. - The turn: a verifier that catches the people who built it, on its first outing, forces the obvious question about itself. The owner asked it and answered it in the same breath -- "I will." -- which is the charter's keeper clause (docs/the-fleet/THE-ASSAYER.md) in one sentence, and the exact fix night four's law asked for: a gate with teeth, and a keeper who actually holds the key. Matches the established chapters' voice, structure, and HTML/CSS exactly (copied night-four's template verbatim, edited content only) -- hero, 6-stat manifest, ledger with two .inc entries, a .callout for the emotional turn (mirroring night-two's use of the same component), standdown close, sig line. Wired into the existing prev/next footer chain: night-four now forward-links here, this page back-links to night-four. Note for whoever reviews this: this branch stacks on the still-unmerged docs/fleet-agents-md-chapter (PR #190, night-three + night-four) since this chapter's footer chain and voice-matching genuinely depend on that content existing. It also cross-links to docs/the-fleet/THE-ASSAYER.md from the still-open PR #192 -- that link won't resolve until #192 merges, same honest-forward-reference pattern night four already used for its own unmerged state. Sequencing: #190, then this, then (independently) #192. I also noticed a likely off-by-one in night-three's constitution numbering (`counter-reset: law 6` renders its new law as VII, not VI, skipping a numeral) while reading that file for reference -- flagging it, not fixing it, since it's PR #190's content and out of scope here. 🤖 Generated with Claude Code Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
Summary
agent-readyrepo.agent-readycheckout's git object store carries a freshrefs/codex/turn-diffs/...ref — a checkpoint artifact left by a Codex-based session, dated today. Not a commit, not a PR, nothing merged, no claim beyond what the ref itself proves. The chapter says exactly that and no more.CLAUDE.mdis this fleet's own dialect of its rules;AGENTS.md(fromagent-ready, MIT, published) is the model-agnostic constitution written specifically so a reader that isn't a Claude session can still find the same working agreement. One new law is added to the running constitution (VII, continuing night-two'sVI): "Write the rules for a reader who isn't you yet."default/arabic/japanese/indian/codex/andalus/terminal), same#theme=<id>hash, samelocalStorage["mm-theme"]key, same CSS-variable engine, ornament SVG, switcher markup/ARIA, and canvas hero animation asdocs/the-fleet/index.htmlandnight-two/index.html— copied structurally from night-two so a theme picked on any of the three pages carries to this one.→ what came next: a second reader). No other change.docs/architecture/index.htmluntouched. No ChessKit/server/iOS code touched — a new self-contained static HTML file plus a three-line footer edit, no build step, no new external requests. Does not touch Server: move the auth rate limiter to a shared sliding-window store (closes #79) #116.Verification
VIIrenders correctly viacounter-reset: law 6), and the closing section all render correctly under Default, Codex, Terminal, and Indian;#theme=hash andlocalStorage["mm-theme"]both correctly select and persist a theme; no console errors.get_page_textcross-check confirms all sections present and in order.agent-readyrepo directly (README,AGENTS.md,docs/principles.md,docs/scaling.md, andgit log/git for-each-reffor the ref claim) before writing — nothing in the chapter overstates what's verifiable.🤖 Generated with Claude Code