docs: replace restated upstream facts with pointers in knowledge and computer-use #12775
Description
Refs #12694
Outcome
14 passages in 9 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: knowledge, computer-use.
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.
Scope: the knowledge and computer-use rows of #12694 only: docs/contracts/plugin-reconfiguration/README.md, plugins/knowledge/README.md, plugins/knowledge/skills/distill/SKILL.md, plugins/knowledge/skills/docpage-digest/SKILL.md, plugins/knowledge/skills/docpage-digest/context/anthropic-docs-profile.md, plugins/knowledge/skills/setup/SKILL.md, plugins/computer-use/README.md, plugins/computer-use/skills/diagnose/SKILL.md, plugins/computer-use/skills/setup/SKILL.md. The context-guard and disk-hygiene rows belong to the sibling child.
Rows
knowledge
docs/contracts/plugin-reconfiguration/README.md:116-118(r311). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#reference-a-saved-value Drop the description of when user_config and CLAUDE_PLUGIN_OPTION_* are injected; keep the rule that observation is next-session and a same-session check reports the old value, with a pointer.plugins/knowledge/README.md:82-84(r313). Pointer: https://code.claude.com/docs/en/tools-reference#read-tool-behavior Drop the claim that PDF works natively with Read; keep the requirement of a PDF or EPUB the user may read and the EPUB unzip note, and point at the Read tool section. Same text also at:plugins/knowledge/skills/distill/SKILL.md:42; a row of its own covers it only if listed.plugins/knowledge/README.md:121-122(r309). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#where-values-are-stored Drop the claim about how a sensitive option persists on Windows; keep the decision that course-platform credentials stay in shell env vars, not userConfig, with a pointer.plugins/knowledge/skills/distill/SKILL.md:188,254(r314). Pointer: https://code.claude.com/docs/en/tools-reference#write-tool-behavior Drop the claims that git mv invalidates or breaks Claude Code's read tracking; keep the instruction to Read the file at its new path before Edit/Write, and point at the Write tool section.plugins/knowledge/skills/docpage-digest/SKILL.md:48-51(r316). Pointer: https://www.gnu.org/software/coreutils/manual/html_node/sha2-utilities.html#67-sha2-utilities-print-or-check-sha-2-digests Drop the claim about which platforms lack sha256sum; keep the hash8 slug rule and the sha256sum-or-shasum command, and point at the sha2 utilities section.plugins/knowledge/skills/docpage-digest/SKILL.md:48-51(r317). Pointer: https://www.gnu.org/software/coreutils/manual/html_node/sha2-utilities.html#67-sha2-utilities-print-or-check-sha-2-digests Drop the clause on stock macOS lacking sha256sum; keep step 3's hash8 rule, the command and truncating the prefix not the hash, with a pointer.plugins/knowledge/skills/docpage-digest/context/anthropic-docs-profile.md:38,40-41(r318). Pointer: none found; No fetched page documents the raw .md channel output (llms.txt only lists pages). Search the Claude Code docs for a page describing the raw markdown form; if none exists, the PR should remove these sentences instead. Drop the list of channel artifacts (fence attributes, tab expansion, escaped URLs); keep that source.* stays the unaltered fetch and the reproduce-never-repair decision, with a pointer to the owner.plugins/knowledge/skills/setup/SKILL.md:95-97(r321). Pointer: https://code.claude.com/docs/en/plugins/manifest-reference#where-each-variable-resolves Drop the explanation of when ${user_config.*} is injected; keep the instruction to rerun check in a fresh session and report the observed value, and point at the section.
computer-use
plugins/computer-use/README.md:32-34(r060). Pointer: https://code.claude.com/docs/en/computer-use#screenshots-are-downscaled-automatically Drop the pixel-budget explanation and the claim that smaller monitors do not help; keep the decision that zoom is the lever, and point at the downscaling section. Same text also at:plugins/computer-use/skills/diagnose/SKILL.md:75-77,plugins/computer-use/skills/diagnose/SKILL.md:37-38; a row of its own covers it only if listed.plugins/computer-use/skills/diagnose/SKILL.md:75-77(r061). Pointer: https://code.claude.com/docs/en/computer-use#screenshots-are-downscaled-automatically Drop the megapixel-count explanation; keep the instruction to read the reference file before advising on resolution, and point at the downscaling section. Same text also at:plugins/computer-use/README.md:32-34,plugins/computer-use/skills/diagnose/SKILL.md:37-38; a row of its own covers it only if listed.plugins/computer-use/skills/setup/SKILL.md:44-46,117-119(r062). Pointer: none found; Upstream owner of the computer-use MCP tool descriptions (list_granted_applications, request_access); the fetched computer-use page does not name them. Search the docs for a tool reference or confirm via the /mcp tool listing. Drop what list_granted_applications returns and its read-only/no-side-effect description, in both places; keep the decision to use it as the check's probe, with a pointer.plugins/computer-use/skills/setup/SKILL.md:60-61,117-118(r063). Pointer: https://code.claude.com/docs/en/computer-use#approve-apps-per-session Drop the statement that request_access raises a consent dialog, in both places; keep the rule never to call it during a check, and point at the approval section.plugins/computer-use/skills/setup/SKILL.md:65-66(r064). Pointer: none found; Upstream doc on whether synthesized input resets the OS idle timer (Windows/macOS input injection or idle-detection docs); the computer-use page does not cover it. If none exists, reclassify as local measurement. Drop the claim that synthesized input does not reset the idle timer; keep the decision to probe and report the three timeouts, and point at an owner source once found. Same text also at:plugins/computer-use/README.md:29-31,plugins/computer-use/skills/diagnose/SKILL.md:42,plugins/computer-use/skills/setup/SKILL.md:79-81; a row of its own covers it only if listed.plugins/computer-use/skills/setup/SKILL.md:104-107(r065). Pointer: https://code.claude.com/docs/en/computer-use#approve-apps-per-session (confirm the section) Drop the description of the allowlist gate's refusal and its error text; keep reporting focus-stealing utilities as INFO with the retry pattern, and point at the approval section. Same text also at:plugins/computer-use/skills/diagnose/SKILL.md:41,plugins/computer-use/skills/diagnose/SKILL.md:80-81; a row of its own covers it only if listed.
Notes
Drafted by the issue-triage session. Agent choice, not an owner answer. Split from #12694 by whole plugins, so no file is touched by both children; every file above exists on origin/main. Size Medium from the passage count (14 of the parent's 28, which intake sized Large). Three rows (r318, r062, r064) have no pointer found yet and need a docs search before writing; the rule for each is in its row.
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". Pointers are candidates: fetch each before writing it, and confirm the section still documents the fact.
Related
- Parent: docs: replace restated upstream facts with pointers in knowledge, context-guard, disk-hygiene, computer-use #12694 (split by plugin); grandparent: Attribution audit: restated upstream facts left after the upstream-pointer sweep, and a check-stamps trigger-form gap #7292.
- Sibling child: context-guard and disk-hygiene rows of docs: replace restated upstream facts with pointers in knowledge, context-guard, disk-hygiene, computer-use #12694.
- Shape follows docs: replace restated upstream facts with pointers in harness-ops, discipline #12686.
Activity
github-actions commentedon Nov 3, 2026
melodic-automation-lanes commentedon Nov 3, 2026
This records a re-fire of an earlier refusal, not a new refusal. The lanes kill switch stopped run 41594365657, the work-resolve-issue run that
agent-readystarted, before it did any work; that run ended at 2026-11-03T08:38:28Z. work-unblock has now removed and addedagent-readyback 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 addedagent-readyor a run last reported, work-unblock waits longer before each one, up to 24 hours.github-actions commentedon Nov 3, 2026
github-actions commentedon Nov 3, 2026
melodic-automation-lanes commentedon Nov 3, 2026
The lanes App's pull request #12822 for this issue was closed without merging. work-unblock removed
status: readyandagent-ready, so the hourly triage sweep sends it back to intake triage, which decides what work is left and admits it again.21 remaining items
github-actions commentedon Nov 4, 2026
github-actions commentedon Nov 4, 2026
melodic-automation-lanes commentedon Nov 4, 2026
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-runand removedagent-ready: an agent run on a host builds it, and it waits on no decision from a person.In the run's words:
What the run says it did not do:
Run: https://github.com/melodic-software/claude-code-plugins/actions/runs/41765710753
To hand it back to the lane, remove
host-runand addagent-readyagain.kyle-sexton commentedon Nov 4, 2026
kyle-sexton commentedon Nov 4, 2026
Host run on row r318: the cut does not ship. The negative control fell short, so under
rewrite-a-plugin.mdthe part is unmeasurable and "ships its before text". Nothing is committed or pushed. This is the last row, and "Every row below is fixed" cannot be met as written, so the row needs the owner's call. Lease released.Search. The
llms.txtindex lists no page on the raw markdown form (searched: markdown, raw,theme=, fence). Index only, not page bodies. The no-page branch applies.Passes. A new case,
dd-raw-md-artifacts-reproduced, plusdd-tagging-rules; sonnet, 3 runs per case,--ablation none, 18 VALID runs.The mean fell 0.142 against the 0.15 bar, and at 2 cases the noise report can call no
case drop.Limits of this control.
dd-collision-refusesandmc-resource-seeds-route-awaydid not run: every Bash-granting case was refused on the Docker store symlink, and the link swap was not used. They name the skill but do not exercise this text, so they would add cases rather than sensitivity. That is my reading, not a measured result.dd-tagging-rules' without arm), so no VALID baseline arm exists.Found. In all three VALID degraded runs the digest kept
theme={null}and\&with both profile sections deleted: the verbatim rule inskills/docpage-digest/SKILL.md:205-208holds quotes byte-exact, not these sentences. Only the reader-link disclosure failed. The profile's Archive-reading bullet also lists the same three artifacts, outside this row.Question for the owner: how to settle r318?
rewrite-a-plugin.mdstep 7. The other rows are delivered (docs: replace restated upstream facts with pointers in knowledge and computer-use #12913, docs: replace restated upstream facts with pointers in repository docs and bugs #12818).SKILL.md:205-208evidence, as an exception to the control. Basis: the three degraded runs above.dd-tagging-rulesprompt that stops the without-arm search. Basis: judgment.kyle-sexton commentedon Nov 4, 2026
Decision recorded. Owner, verbatim, 2026-11-04: "Go w/ recommendations", on the question recommending option (a): keep the sentences and close, with r318 recorded as unmeasurable.
Row r318 stays as it is in
plugins/knowledge/skills/docpage-digest/context/anthropic-docs-profile.md: the negative control fell short (mean drop 0.142 against the 0.15 bar), so underrewrite-a-plugin.mdstep 7 the before text ships. The other rows were delivered by #12913 and #12818.