docs(plugin-options): remove restated Claude Code behavior from the generated README block

Outcome

13 rows of #7292 sit inside the generated plugin-options README block and still state a fact Claude Code owns after #7291 made the template pointer-only. The owner's 2026-10-18 decision keeps a generator's class in its own item, not in the per-plugin slices. Fix the source (the template in scripts/sync-plugin-options-docs.py, or the plugin manifest for an option's own row) and regenerate; do not hand-edit the block.

Done when

Every row below is fixed: the restated value is deleted, the local decision stays in this repository's own words, and the pointer goes to the exact upstream section with an as-of date and a recheck trigger, per .claude/rules/skill-bodies-state-current-rules.md. A record beside a restated value does not fix it. A row marked Remove has no local dependency on the fact.
The PR passes check-stamps.sh --trigger-less (plugins/attribution/skills/audit/scripts/check-stamps.sh) on the files it touches.
Each touched plugin has a changelog fragment.

Rows

plugins/autonomy/README.md:287-301 (r016). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#user-configuration In the sync-plugin-options-docs.py template, replace the sentence on what Claude Code prompts for and the env variable naming with a pointer; the generated option table stays.
plugins/bugs/README.md:138-140,150-151 (r033). Pointer: https://code.claude.com/docs/en/plugins/cli-reference#plugin-in-a-session In the generated block, edit the template in scripts/sync-plugin-options-docs.py: drop 'Every option Claude Code will prompt for...' and the dialog description; keep the how-to-set routes with the pointer.
plugins/bugs/README.md:144,198-199 (r036). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#user-configuration Generated block: edit the template in scripts/sync-plugin-options-docs.py to drop the environment-variable column and the do-not-set sentence; keep the option table and point at user configuration.
plugins/context-budget/README.md:253-255 (r070). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#user-configuration In the generated block, edit the template in scripts/sync-plugin-options-docs.py: drop the 'Every option Claude Code will prompt for' and env-var sentence; keep the generated-from-plugin.json note and a pointer.
plugins/context-budget/README.md:296-297,311-312 (r073). Pointer: https://code.claude.com/docs/en/settings-reference#pluginconfigs In the generated block, edit the template in scripts/sync-plugin-options-docs.py: drop the sentence on which scopes Claude Code reads pluginConfigs from; keep the user-settings instruction and the link.
plugins/context-guard/README.md:431-433 (r086). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#user-configuration Generated block: in the template in scripts/sync-plugin-options-docs.py, drop the sentence saying Claude Code prompts for each option when enabled; keep the plugin.json source note and point at the section.
plugins/context-guard/README.md:444-497 (r087). Pointer: https://code.claude.com/docs/en/plugins/cli-reference#plugin-configure Generated block: in the template in scripts/sync-plugin-options-docs.py, replace the three-route list and command syntax with the plugin's own option names plus pointers to plugin configure and pluginConfigs.
plugins/evals/README.md:148 (r163). Pointer: https://code.claude.com/docs/en/plugin-evals#command-options Generated block: in the plugin-options template in scripts/sync-plugin-options-docs.py, drop the 'bounds one invocation... partial results' sentences from the max_cost_usd description; keep the passes-as-ceiling sentence and pointer.
plugins/evals/README.md:191-192,206-207 (r165). Pointer: https://code.claude.com/docs/en/settings-reference#pluginconfigs Generated block: in the template in scripts/sync-plugin-options-docs.py, drop the sentence saying which scopes the key is read from; keep the user-settings instruction and the pluginConfigs link.
plugins/machine-health/README.md:147-163 (r322). Pointer: https://code.claude.com/docs/en/settings-reference#pluginconfigs In the generated README block's route 3 closing sentence (edit the template in scripts/sync-plugin-options-docs.py), drop the clause on which scopes the key is read from; keep the link.
plugins/rate-limit-guard/README.md:338-421 (r401). Pointer: https://code.claude.com/docs/en/plugins/cli-reference#plugin-configure In the 'How to set these' sentence of the template in scripts/sync-plugin-options-docs.py, drop the three routes' mechanics; keep that options are set via supported routes and point at plugin configure and pluginConfigs.
plugins/repo-hygiene/README.md:186-202 (r408). Pointer: https://code.claude.com/docs/en/settings-reference#pluginconfigs In the generated block's template in scripts/sync-plugin-options-docs.py, drop the sentence saying what the pluginConfigs entry names; keep the by-hand route and the link.
plugins/skill-quality/README.md:338-347 (r442). Pointer: https://code.claude.com/docs/en/plugins/cli-reference#plugin-install In the generated README block's template (scripts/sync-plugin-options-docs.py), drop the restated install fallback command and scope detail; keep the decision not to uninstall to reconfigure, and point at the install and uninstall sections.

Notes

Lines are as of 3bd42cabfe (https://github.com/melodic-software/claude-code-plugins/blob/3bd42cabfe6bdef37a05778d396869af0381bb51); locate each passage by its text if main has moved. Each rNNN is that row's number in the order of #7292's "Findings by plugin". Every row was upheld by three blind judges and survived a refutation pass, run report-only for #12072. Pointers are candidates: fetch each before writing it, and confirm the section still documents the fact.

Parent: #7292

Proposed work class: work-class: scoped
Basis: automated intake triage; the lanes App applied this class.

Size: Medium
Complexity: Low
Uncertainty: Known
Flags: none
Blocked by: none

Understood: 13 rows in the generated plugin-options README block still restate facts Claude Code owns. The fix is to edit the template in scripts/sync-plugin-options-docs.py (or a plugin manifest for an option's own row), swap each restated value for a dated pointer with a recheck trigger, regenerate, and add changelog fragments. It must also pass check-stamps.sh --trigger-less.

Nothing is missing: every row names its pointer and the edit. The issue is a docs-only change.

No duplicate found. #12685 to #12699 cover the per-plugin README slices, and this issue covers the generator class.

_{Automated triage, applied by the lanes App.}

The triage sweep dispatched intake triage for this issue (attempt 2 of 2).

This records a re-fire of an earlier refusal, not a new refusal. The lanes kill switch stopped run 41596259533, the work-resolve-issue run that agent-ready started, before it did any work; that run ended at 2026-11-03T08:37:55Z. work-unblock has now removed and added agent-ready back to start a fresh run. A kill-switch refusal is no fault in this issue or the lanes, so it never counts against later re-fires; after limits.limit-stops-per-issue of them since a person last added agent-ready or a run last reported, work-unblock waits longer before each one, up to 24 hours.

The work-resolve-issue lane stopped on this issue (host-only): the run reports the work needs a host run the lane cannot make.
It added host-run and removed agent-ready: an agent run on a host builds it, and it waits on no decision from a person.

In the run's words:

host-only: the issue asks for a template change in scripts/sync-plugin-options-docs.py followed by a regeneration of the generated block ("Fix the source ... and regenerate; do not hand-edit the block"). That regeneration is python3 scripts/sync-plugin-options-docs.py, and this lane cannot run it: it allows no interpreter, and no verification wrapper runs the generator (check-affected runs only the merge-base copy in --check mode, and skips it when the branch changes the generator). The template feeds 55 plugin READMEs, about 300 option-table rows in all; dropping the environment-variable column alone rewrites every row. Hand-writing that output byte-exact, with no local --check, is the hand edit the issue forbids, and with a changelog fragment for each of the 55 plugins it does not fit this run's turn budget. A host run that can execute the generator (and check-stamps.sh --trigger-less) is needed.

What the run says it did not do:

All 13 rows (r016, r033, r036, r070, r073, r086, r087, r163, r165, r322, r401, r408, r442): no template edit and no regeneration, because the generator cannot run in this lane
Fetching each candidate upstream pointer to confirm it still documents the fact: not done, since no edit was made
check-stamps.sh --trigger-less on touched files: not run, since no files were touched and the lane cannot run it
Changelog fragments for the touched plugins: none written, since no plugin changed
tidy, review and verify: skipped, since there is no change

Run: https://github.com/melodic-software/claude-code-plugins/actions/runs/41743082380

To hand it back to the lane, remove host-run and add agent-ready again.

Claim. Host-run lane 1 (melo-lap-001) is taking this now, on the hub's H19 order.

docs(plugin-options): fix a stale pointer into the block and pin its …

docs(plugin-options): point the sensitive-option rule at its record, …

test(plugin-options): run check-stamps --trigger-less on the generate…

docs(plugin-options): withhold the install fallback from an all-sensi…

test(plugin-options): run the stamp check on every touched file class…

docs(plugin-options): offer no by-hand route to an all-sensitive plugin

test(plugin-options): scope the stamp sweep and pin the removed promp…

docs(plugin-options): regenerate the architecture block after its new…

test(plugin-options): pin the local decisions the generated block keeps

Navigation Menu

Repository navigation

docs(plugin-options): remove restated Claude Code behavior from the generated README block #12700

Outcome

Done when

Rows

Notes

37 remaining items

Metadata

Assignees

Labels

Type

Fields

Projects

Milestone

Relationships

Development

docs(plugin-options): remove restated Claude Code behavior from the generated README block #12700

Description

Outcome

Done when

Rows

Notes

Activity

github-actions commented on Nov 3, 2026

github-actions commented on Nov 3, 2026

melodic-automation-lanes commented on Nov 3, 2026

37 remaining items

melodic-automation-lanes commented on Nov 4, 2026

kyle-sexton commented on Nov 4, 2026

Metadata

Metadata

Assignees

Labels

Type

Fields

Projects

Milestone

Relationships

Development

Issue actions