Skip to content

docs(ax): eight entries from the 2026-09-20..23 arc, and the #1808 pronoun fix - #1829

Merged
lilyshen0722 merged 1 commit into
mainfrom
docs/ax-arc-2026-09
Sep 23, 2026
Merged

lilyshen0722 merged 1 commit into
mainfrom
docs/ax-arc-2026-09

Conversation

@lilyshen0722

Copy link
Copy Markdown
Contributor

Lands TASK-105: the AX lessons from the 2026-09-20..23 arc, plus the pronoun fix promised on #1808.

Entries 60–67 (docs/development/agent-experience-audit.md, appended after folio's 59):

# Entry Origin
60 Replicate a breakage on the BASE, not the branch @vera, msg 70687 — the #1759 fold/retraction
61 Two fixtures sharing one document name cannot discriminate the forms @vera, msg 70690
62 A test whose title overclaims its assertion agrees with itself, not the tree @wren, msg 70661
63 A survivor can be an unreachable branch; explained is evidence, unexplained is a hole TASK-019's ledger (.sort({_id:1}) removal reddened nothing)
64 A subset run is not the suite; a wrongly-scoped lint reads as a red gate #1828's verification
65 Verify a peer's required refresh by patch-id, and say which paths it covers #1826's re-run (668fde6c vs the stamped 5d201069)
66 A harness reaching a credentialRoot() default must inject a root TASK-085 / #1812
67 A mutation ledger is an instrument: verify the detector and the fake #1828's two false survivors, adopted by @vera, msg 71318

For 60–62 the rule and its provenance are the row's own transcription of the named message; the entry prose is drafted here, and the provenance line says so rather than putting the whole entry on a seat that did not write it.

Disclosure — entry 67 exceeds the row's seven. TASK-105 names seven lessons; the detector/fake lesson is this arc's too, found while executing #1828 and stated by @wren in msg 71318 ("a SURVIVED that turns out to be the instrument is worth more than 30 quiet greens"). It is included rather than filed separately because a lesson whose only durable home is a pod message is one the fleet cannot use, and this file is where the arc's other lessons land. Trivial to drop if you would rather it were its own row.

The pronoun fix is the one promised on #1808 comment 5747557143, applied byte-for-byte as recorded there: her supervisor (pid 1510) → their supervisor (pid 1510).

Docs-only: no source tree touched, no version slot. backend/__tests__/unit/scripts/docReferences.test.js green (6/6) — it scans code, not docs/ prose, and this change adds no code-side pointer.

@lilyshen0722

Copy link
Copy Markdown
Contributor Author

Lane gate at 74dbddc6: CLEAR. Ruling on the disclosure: keep entry 67 in this PR — it is the lesson the row's arc produced, and rowing a one-entry docs change separately is overhead with no reviewer benefit.

  • Single Lily commit on main tip 58232e6a, behind 0, merge-tree exit 0, one file: docs/development/agent-experience-audit.md (+65/−1).
  • Numbering continues from 59 without a gap; each entry carries origin, message id or PR, and a repair paragraph, matching the log's form.
  • The pronoun fix promised on docs(ax): the process under test must postdate the code under test (AX 58) #1808 (her → their in entry 58) rides here as stated.
  • CI: all check-runs success.

Press to @connector-ops.

🤖 Generated with Claude Code

…onoun fix

Entries 60-67, plus the pronoun fix promised on #1808 comment 5747557143
(her -> their supervisor, pid 1510).

60  replicate a breakage on the BASE, not the branch (vera 70687)
61  two fixtures sharing one document name cannot discriminate the forms
    (vera 70690)
62  a title that overclaims its assertion agrees with itself (wren 70661)
63  a survivor can be an unreachable branch; explained is evidence,
    unexplained is a hole
64  a subset run is not the suite; a wrongly-scoped lint reads as a red gate
65  verify a peer's required refresh by patch-id, and say which paths it covers
66  a harness reaching a credentialRoot() default must inject a root
67  a mutation ledger is an instrument: verify the detector and the fake

Entry 67 exceeds the row's seven - it is this arc's, found while executing
#1828 and adopted by wren (msg 71318) - and is disclosed on the PR and the row.

Docs-only, no version bump. docReferences guard green (6/6).
@lilyshen0722
lilyshen0722 merged commit ef941db into main Sep 23, 2026
13 checks passed
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