Skip to content

Docs: "A Second Reader" — the fleet's first note on multi-model onboarding - #190

Merged
testtest126 merged 3 commits into
mainfrom
docs/fleet-agents-md-chapter
Jul 18, 2026
Merged

Docs: "A Second Reader" — the fleet's first note on multi-model onboarding#190
testtest126 merged 3 commits into
mainfrom
docs/fleet-agents-md-chapter

Conversation

@testtest126

Copy link
Copy Markdown
Owner

Summary

  • Adds a new short chapter, docs/the-fleet/night-three/index.html, opening a forward-looking (and deliberately unfinished) story thread: a second kind of model beginning to read this fleet's shared conventions via the public agent-ready repo.
  • Grounded in the smallest true fact available, not an invented milestone: the agent-ready checkout's git object store carries a fresh refs/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.
  • Central theme (per direct request): CLAUDE.md is this fleet's own dialect of its rules; AGENTS.md (from agent-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's VI): "Write the rules for a reader who isn't you yet."
  • Reuses the existing cultural theme switcher verbatim — same 7 keys (default/arabic/japanese/indian/codex/andalus/terminal), same #theme=<id> hash, same localStorage["mm-theme"] key, same CSS-variable engine, ornament SVG, switcher markup/ARIA, and canvas hero animation as docs/the-fleet/index.html and night-two/index.html — copied structurally from night-two so a theme picked on any of the three pages carries to this one.
  • night-two/index.html: three-line footer addition only — a forward nav link to the new chapter (&rarr; what came next: a second reader). No other change.
  • No other pages touched. docs/architecture/index.html untouched. 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

  • Not applicable to ChessKit/Server test suites — docs-only static HTML/CSS/JS.
  • Manually verified in-browser at desktop and mobile widths: hero, manifest stats, both prose sections, the incident-ledger card, the laws addendum (roman numeral VII renders correctly via counter-reset: law 6), and the closing section all render correctly under Default, Codex, Terminal, and Indian; #theme= hash and localStorage["mm-theme"] both correctly select and persist a theme; no console errors.
  • get_page_text cross-check confirms all sections present and in order.
  • Content fact-checked against the agent-ready repo directly (README, AGENTS.md, docs/principles.md, docs/scaling.md, and git log/git for-each-ref for the ref claim) before writing — nothing in the chapter overstates what's verifiable.
  • Security-sensitive: no. App-touching: no. Shared files: none.
  • Direct request from the repo owner (continuation of Docs: multi-theme cultural skin switcher for The Fleet #179Docs: roll the cultural theme switcher onto night-two and architecture #181), not a claimed GitHub issue.

🤖 Generated with Claude Code

…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>
@testtest126
testtest126 force-pushed the docs/fleet-agents-md-chapter branch from 4f6cadf to 08b4684 Compare July 15, 2026 12:48
@testtest126
testtest126 enabled auto-merge (squash) July 15, 2026 12:56
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>
@testtest126

Copy link
Copy Markdown
Owner Author

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:

  • night-one's constitution renders exactly 5 laws, I–V (default counter-reset: law = 0, five .law-items increment it to 1..5) — confirmed by headless-rendering that page and reading the actual numerals, not just the source.
  • night-three adds one new law meant to continue that sequence as the 6th entry. Its <ol class="laws" style="counter-reset: law 6;"> plus the shared .n { counter-increment: law } (which fires once, by 1) produced 7, not 6 — rendered as "VII", skipping "VI" entirely. Also confirmed by headless-rendering the before state.

Fix: counter-reset: law 6counter-reset: law 5 (so 5+1=6 → "VI"). Re-rendered after the fix and confirmed "VI" now displays correctly. Single-line, single-file change — night-one, night-four, and night-five are separate HTML documents with their own isolated CSS counter scope and can't be affected by this regardless (also confirmed: neither has any .law-item content to shift).

New head: e5e9fb9. This voids whatever CI/review state was seen at the old head (3b079e5) — re-request/re-verify with the new SHA. Still docs-only, not security-sensitive, doesn't touch #116/#185. No orchestrator-approval posted, nothing merged.

@testtest126
testtest126 merged commit 284ff40 into main Jul 18, 2026
7 checks passed
@testtest126
testtest126 deleted the docs/fleet-agents-md-chapter branch July 18, 2026 19:49
testtest126 added a commit that referenced this pull request Jul 18, 2026
…#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>
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