docs: re-run the mods go/no-go after Claude Code 2.1.287 shipped mods #5768

Activity

1. github-actions

   added

   needs-triageNot yet classified. Floor until a type and one priority tier are set.Not yet classified. Floor until a type and one priority tier are set.

   on Oct 2, 2026
2. kyle-sexton

   added a commit that references this issue on Oct 2, 2026

   feat(playbooks): apply the Sonnet 5.5 prompting guide across the mark…

   ...

   43dd880
3. kyle-sexton commented on Oct 4, 2026

   

   kyle-sexton

   on Oct 4, 2026

   ContributorAuthor

   More actions

   This was generated by AI during triage.

   Decision defaulted: record the run and refresh the mods row and the source index, and leave ADR 0035 unamended while the verdict stays no-go — veto before merge
   Basis: verified, docs/upstream/claude-code-mods/go-no-go.md:325-327 ("ADR 0035: leave it alone while the verdict holds ... a runbook run does not amend an accepted ADR by itself"). The issue body asks for an ADR 0035 update; the repository's own runbook says otherwise, so the runbook rule is the default. Alternative (reversible): also correct ADR 0035's Context sentence that says the feature is named nowhere in the official docs.

   Routing: delegable, work class scoped (C3, docs evidence refresh). The verdict itself is not an open decision: go needs all five criteria, and criterion 3 fails today (anthropics/claude-code#92533 is OPEN, closedAt: null, checked 2026-10-04). Every criterion is agent-runnable headless; the Desktop, Team/Enterprise and interactive probes are optional and stay open if not run.

   Related chain (no blocked-by edges added): #5777 (mod producer pilot) cannot ship a modules key until this runbook reports go; #5778 starts after #5777 reports.

   Finding: the runbook's pin-bump quick check (criteria 1 to 3) did not run on the dependabot bumps to 2.1.287 (#5798) and 2.1.288 (#5998); the pin is now 2.1.288.

   Agent Brief

   Type: Task
   Summary: Re-run the mods go/no-go runbook on the pinned Claude Code (2.1.287 or later), record the run, and refresh the records that cite the mods docs.

   Current behavior:
   The mods records carry a 2026-09-19 baseline at Claude Code 2.1.278: five of five criteria fail. Since then Claude Code 2.1.287 shipped mods with official docs pages under the plugins "mods" section (overview, create, reference, test, admin, troubleshoot). The mods row in the plugin philosophy doc's "Recorded gate runs" table still says the feature has zero mentions in the official docs, and the upstream mods source index has no rows for the new docs pages.

   Desired behavior:

   • The go/no-go runbook is run top to bottom on the installed Claude Code (version recorded three ways, as the runbook says), with the five criteria and the headless experiments (E1 to E6). Criterion 4 is checked against the mods reference page.
   • The run is recorded with its date, versions and a per-criterion outcome table, in the form the runbook uses for its baseline.
   • The mods row in the plugin philosophy doc gets a new Verified date and a basis that states the current reason for the verdict (for example: the docs now mention the feature; criterion 3 still fails).
   • The upstream mods source index gains a row per newly relied-on docs page, each with an as-of date and a recheck trigger, and refreshed fetch dates for re-fetched rows.
   • ADR 0035 stays unamended while the verdict is no-go (see the defaulted decision above).
   • If the run finds all five criteria passing, do not apply a go verdict: stop, record the run, and escalate on this issue for a human decision, because a go needs a superseding ADR.

   Key interfaces:

   • The go/no-go runbook and its "After a run" rules are the procedure; follow them, do not restate them.
   • CLAUDE_CODE_ENABLE_FUNCTION_HOOKS must be genuinely unset for criterion 1 (check the user and local settings files' env blocks first, read-only).
   • The frozen research snapshot folder is never edited; a redone research pass gets a new dated folder.

   Acceptance criteria:

   • A recorded run exists with date, claude --version, npm latest and tag versions, and an outcome per criterion with its evidence.
   • The philosophy doc's mods row has the new Verified date and a basis that no longer claims zero docs mentions.
   • Every docs page the run relied on has a row in the source index with an as-of date and a recheck trigger.
   • ADR 0035 is unchanged, unless the maintainer vetoes the defaulted decision.
   • No probe output that contains instruction-file text, account details or other session content is committed; probe files live only in an OS temp directory.

   Out of scope:

   • Adding a modules key to any plugin, or any mod code under plugins/.
   • Changing the @anthropic-ai/claude-code pin.
   • The context-guard producer pilot (Pilot a mod producer for context-guard and rate-limit-guard #5777) and the mods adoption decision (Decide which plugin features should ship as mods #5778).
   • Installing anything at user scope (the Desktop probe needs that; leave it open).
4. kyle-sexton

   added

   priority: mediumReal value, no hard deadline; normal backlog flow.Real value, no hard deadline; normal backlog flow.

   agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.Fully specified and briefed; eligible for autonomous pickup from the frontier.

   work-class: scopedA briefed fix or small feature; blast radius bounded by the brief, tests exist.A briefed fix or small feature; blast radius bounded by the brief, tests exist.

   status: readyTriaged, unblocked, and fully specified; eligible to pick up.Triaged, unblocked, and fully specified; eligible to pick up.

   and removed

   needs-triageNot yet classified. Floor until a type and one priority tier are set.Not yet classified. Floor until a type and one priority tier are set.

   on Oct 4, 2026
5. kyle-sexton commented on Oct 4, 2026

   

   kyle-sexton

   on Oct 4, 2026

   ContributorAuthor

   More actions

   This was generated by AI during work-loop.

   Ratify autonomous dispatch of this C3 item?

   Classification: work-class: scoped (C3), task/bug-fix-shaped (re-run the go/no-go criteria and correct stale docs; triage defaulted "leave ADR 0035 unamended", veto before merge). Intended dispatch: the work-loop worker lane, through /work-items:work, to a draft PR the lane never merges. First drain is not complete and no item-level ratification exists, so it is queued here. Ratify through /work-items:attend-queue and it dispatches on a later cycle.

   Lane: work-loop, instance melo-worker-1, cycle 1.
6. kyle-sexton

   added

   needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.Human-in-the-loop required; autonomous sessions must not resolve items carrying this.

   and removed

   agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.Fully specified and briefed; eligible for autonomous pickup from the frontier.

   on Oct 4, 2026
7. kyle-sexton

   self-assigned this

   on Oct 4, 2026
8. kyle-sexton commented on Oct 4, 2026

   

   kyle-sexton

   on Oct 4, 2026

   Last edited by kyle-sexton

   ContributorAuthor

   More actions

   No description provided.
9. kyle-sexton commented on Oct 4, 2026

   

   kyle-sexton

   on Oct 4, 2026

   ContributorAuthor

   More actions

   This was generated by AI during attend-queue.

   Operator direction (2026-10-04): "go with the recommendations." This records that decision.

   Ratification declined: draft PR #6152 already holds the work. The go/no-go was re-run on 2026-10-02 at Claude Code 2.1.288. It is recorded on the feat/5778-mod-conventions branch in draft PR #6152, which says Closes #5768. Adopting mods despite criteria 3 (#92533 still open) and 5 (the early-access phrase is still in the mods README) is an owner decision recorded as an ADR supersession, not a C3 bug fix. The item stays needs-human until #6152 merges, which closes it, or is abandoned.

   Two blockers on #6152 as of 2026-10-04:

   • It conflicts with main.
   • Its ADR number 0049 now collides with 0049-run-ci-lanes-… on main (docs(conventions): add the pr-pipeline convention, config schema and lane ADRs #6139). The next free number is 0052.

   #6154, #6156 and #6157 cite paths and lines on that branch, so their citations will go stale when the ADR is renumbered.
10. kyle-sexton

    removed their assignment

    on Oct 4, 2026
11. kyle-sexton

    closed this as completedin #6152on Oct 4, 2026