docs: replace restated upstream facts with pointers in repository docs, bugs #12690

Refs: #7292

Outcome

28 passages in 12 files state a fact an external source owns. Rewrite each as a pointer to the live upstream section, or remove it, so the next upstream change cannot leave a stale copy here. Plugins: repository docs, bugs.

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

repository docs

• docs/contracts/hook-budget/README.md:62-64,74 (r508). Pointer: https://code.claude.com/docs/en/plugins/mods/reference#limits Drop the descriptions of how mod hooks run and the time-limit skip; keep the k = 0 budget decision for always-on mod hooks and point at the section.
• docs/contracts/hook-input-rewriting/README.md:50-55 (r510). Pointer: https://code.claude.com/docs/en/hooks#pretooluse-decision-control Drop the claim about how denial reasons reach Claude and that JSON and exit 2 route identically; keep the advice to deny with an instruction and point at the section.
• docs/contracts/hook-input-rewriting/README.md:83-85 (r511). Pointer: https://code.claude.com/docs/en/hooks#pretooluse-decision-control Drop the parenthetical on how deny routes and what Claude sees; keep which guards deny and which two ask with no rewrite, and point at the section.
• docs/contracts/hook-telemetry/README.md:42-45 (r512). Pointer: https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcpjson Drop the claim about how settings.json env values are injected and where expansion exists; keep the relative-path wiring decision and wrap-in-script instruction, and point at the section.
• docs/contracts/hook-telemetry/README.md:72 (r513). Pointer: https://code.claude.com/docs/en/monitoring-usage#event-correlation-attributes Drop the statement of what prompt.id is on OTel events and the version floor; keep prompt_id as the local correlation key and point at the section.
• docs/contracts/hook-telemetry/README.md:86-90 (r514). Pointer: https://code.claude.com/docs/en/hooks#common-input-fields Drop the claim about which fields lead the payload and which follow tool_input; keep the large-payload fallback decision and absent-means-absent rule, and point at the section.
• docs/contracts/plugin-reconfiguration/README.md:35-45 (r515). Pointer: https://code.claude.com/docs/en/plugins/cli-reference#plugin-install Drop the description of what install prints and writes for an already-installed plugin; keep the headless-fallback rerun decision and point at the plugin install section.
• docs/contracts/plugin-reconfiguration/README.md:84-87,108 (r516). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#where-values-are-stored Drop the statement of which settings file receives the value and what -s governs; keep the scope rule's reference for readers and point at the where-values-are-stored section.
• docs/contracts/plugin-reconfiguration/README.md:104-107,69-70 (r517). Pointer: https://code.claude.com/docs/en/plugins/cli-reference#what-an-uninstall-deletes-and-keeps Drop the list of what uninstall removes; keep the rule never to uninstall to reconfigure and point at the section.
• docs/contracts/plugin-reconfiguration/README.md:116-120 (r518). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#reference-a-saved-value Drop the description of when values are injected into skills and hooks; keep the rule to verify in a fresh session and never claim an unobserved change, and point at the section.
• docs/contracts/plugin-reconfiguration/README.md:121-125 (r519). Pointer: https://code.claude.com/docs/en/plugins/cli-reference#plugin-install Drop each route's exit-code and rejection behavior; keep the rule to check each route's own failure signal, and point at the plugin install and configure sections.
• docs/contracts/prerequisites/README.md:21-23 (r500). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#dependencies Drop the descriptions of what Claude Code resolves, stores and installs; keep each need-to-mechanism mapping row and point at the manifest sections for dependencies and user configuration.
• docs/contracts/prerequisites/README.md:21-22 (r503). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#user-configuration Drop the statements that Claude Code resolves dependencies and stores sensitive options in the credential store; keep the mapping rows and point at the manifest sections.
• docs/contracts/prerequisites/README.md:174 (r501). Pointer: https://pubs.opengroup.org/onlinepubs/9799919799/utilities/V3_chap02.html#tag_19_05_03 (confirm the section) Drop the claims that every POSIX shell sets PPID and that PowerShell has no sh; keep which branch of the command runs where and point at the shell docs.
• docs/contracts/prerequisites/README.md:174 (r505). Pointer: https://code.claude.com/docs/en/hooks#windows-powershell-tool Drop the statement about the Windows default shell and the lack of sh; keep the two-command fallback design and point at the hooks Windows PowerShell section. Same text also at: docs/contracts/hook-budget/README.md:25; a row of its own covers it only if listed.
• docs/contracts/prerequisites/README.md:192-197 (r502). Pointer: https://code.claude.com/docs/en/hooks#sessionstart Drop the list of SessionStart sources and the compaction session-id inference; keep the decision on which matcher these groups use and the latch rule, pointing at the section.
• docs/contracts/prerequisites/README.md:196 (r506). Pointer: https://code.claude.com/docs/en/hooks#sessionstart Drop the claim about session id behavior across compaction; keep the decision that a re-fire after compaction prints nothing because of the latches and point at the section.
• docs/contracts/routing-as-data/README.md:83-84 (r520). Pointer: https://code.claude.com/docs/en/plugins/cli-reference#plugin-list Drop the explanation of which name list ids and skill namespaces use; keep the rule that entry name must equal manifest name and point at the section.
• docs/upstream/claude-code.md:133 (r524). Pointer: https://code.claude.com/docs/en/sub-agents#run-every-subagent-on-one-model Drop the descriptions of what FORCE overrides and what the single-model variable leaves alone; keep the declined decision and its owner date, and point at the section.
• docs/upstream/opus-5-5-task-cost.md:224-226 (r525). Pointer: https://code.claude.com/docs/en/model-config#model-aliases Drop the claim about how providers resolve the sonnet alias; keep the decision that dispatch falls back to implementer where the alias is not trusted, and point at the section.

bugs

• plugins/bugs/README.md:92-94 (r031). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#where-each-variable-resolves Drop the claim that the data directory does not outlive a cloud container; keep the instruction to pass --track on cloud or scheduled runs and point at the section.
• plugins/bugs/README.md:100,106-110 (r032). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#user-configuration Drop 'prompted at enable time' and the settings-file sentence; keep the output_dir option and that changes go through Claude Code's configuration, pointing at user configuration.
• plugins/bugs/README.md:220-224 (r037). Pointer: https://cli.github.com/manual/gh_issue_create#options Drop the explanation of what --type sets; keep the filing command and the label fallback for repos without Issue Types, and point at gh issue create options. Same text also at: plugins/bugs/skills/write/SKILL.md:165; a row of its own covers it only if listed.
• plugins/bugs/skills/scan/SKILL.md:64-67 (r038). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#where-each-variable-resolves Drop the claim that the plugin data directory is ephemeral or unreachable; keep the instruction to pass --track on cloud or scheduled runs and the cursor-ladder rung, pointing at the section. Same text also at: plugins/bugs/README.md:92; a row of its own covers it only if listed.
• plugins/bugs/skills/setup/SKILL.md:52-58,152-153 (r039). Pointer: https://code.claude.com/docs/en/plugins/cli-reference#plugin-install Drop the install-output, -s default and uninstall-effect descriptions; keep the fallback command and never-uninstall rule, pointing at plugin install and 'What an uninstall deletes and keeps'.
• plugins/bugs/skills/setup/SKILL.md:150-151 (r040). Pointer: https://code.claude.com/docs/en/skills#available-string-substitutions Drop the 'injected at skill load' mechanism; keep the gotcha to verify a reconfiguration only in a fresh session and point at the substitutions section.
• plugins/bugs/skills/write/SKILL.md:147-148 (r042). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#where-each-variable-resolves Drop the statement that the data directory is per-plugin; keep the project-slug subdirectory decision and its duplicate-scan reason, pointing at the section.
• plugins/bugs/skills/write/SKILL.md:163-169 (r043). Pointer: https://cli.github.com/manual/gh_issue_create#options Drop the explanation of --type and Issue Types behavior; keep the filing command and the type: bug label fallback decision, pointing at gh issue create options. Same text also at: plugins/bugs/README.md:220; a row of its own covers it only if listed.

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