Light pointer pass: open medium and low pointer findings from the upstream-pointer sweep

Start by rechecking the listed paths and line references against the current main branch; the issue says several sweep pull requests have since merged, and some findings may already be fixed. For each remaining item, compare the cited repository text with the live page and anchor named in the checklist, then update the pointer record or restated text as indicated by the finding type. Done means each still-open finding is resolved and the affected files have been checked.

Description

The upstream-pointer sweep's light pass read 176 live docs pages (160 on code.claude.com, 16 on claude.dev) and checked every repo citation of each page: whether each anchor still exists, and whether repo text that restates the page carries a whole pointer record (anchor, as-of date, recheck trigger). This issue lists the medium and low findings that the sweep's own branches left open. High-severity findings are not in this list.

Kinds:

• drift: the repo states something the live page now says differently.
• missing-pointer: the repo restates the page with no link to it.
• incomplete-record: a link exists but lacks the exact anchor, the as-of date, or the recheck trigger.
• wrong-host citation: the cited URL redirects off its host; cite the canonical one.

Line numbers come from the sweep's read of 2026-10-11/12. main and the sweep branches have moved since, so confirm each line before editing. Where a sweep PR (#7061-#7274) touches a file listed here, that PR left the finding open.

Open findings

autonomy

• plugins/autonomy/README.md:180: missing-pointer, low. Live: https://code.claude.com/docs/en/hooks-guide, anchor stop-hook-hits-the-block-cap

context-guard

• plugins/context-guard/reference/reader-contract.md:629: missing-pointer, medium. Live: https://code.claude.com/docs/en/desktop-wsl, anchor desktop-wsl#what-works-in-a-wsl-session
• plugins/context-guard/reference/cloud-headless-capture.md:28-29: missing-pointer, medium. Live: https://code.claude.com/docs/en/desktop-wsl, anchor desktop-wsl#what-works-in-a-wsl-session
• plugins/context-guard/reference/cloud-headless-capture.md:239: missing-pointer, low. Live: https://code.claude.com/docs/en/desktop-wsl, anchor desktop-wsl#what-works-in-a-wsl-session

fleet

• plugins/fleet/skills/reach/reference/relay.md:138: incomplete-record, low. Live: https://code.claude.com/docs/en/agent-view, anchor #limitations
• plugins/fleet/skills/reach/reference/relay.md:76 and plugins/fleet/skills/reach/SKILL.md:122: drift, medium. Live: https://code.claude.com/docs/en/cross-session-messaging, anchor #non-interactive-sessions, #control-inbound-messages

harness-config

• plugins/harness-config/reference/agents-md-liveness.md:43: incomplete-record, medium. Live: https://code.claude.com/docs/en/plugins/mods/overview, anchor #mods-built-into-claude-code
• plugins/harness-config/skills/audit-automation-gaps/context/gap-analysis.md:10: incomplete-record, low. Live: https://code.claude.com/docs/en/plugins/mods/overview, anchor #compare-mods-settings-hooks-skills-and-mcp-servers
• plugins/harness-config/skills/unhobble/SKILL.md:455-459: missing-pointer, medium. Live: https://code.claude.com/docs/en/headless, anchor #start-faster-with-bare-mode

harness-memory

• plugins/harness-memory/skills/audit/reference/official-guidance.md:326: incomplete-record, medium. Live: https://code.claude.com/docs/en/plugins/mods/overview, anchor #mods-built-into-claude-code

harness-ops

• plugins/harness-ops/skills/audit-performance/scripts/audit_performance.py:292-294: missing-pointer, medium. Live: https://code.claude.com/docs/en/sub-agents, anchor #concurrent-subagent-limit, #let-subagents-spawn-their-own-subagents
• plugins/harness-ops/skills/audit-skill-visibility/reference/usage-counters.md:114-116: missing-pointer, medium. Live: https://code.claude.com/docs/en/claude-directory, anchor #cleaned-up-automatically, cli-reference#cli-commands
• plugins/harness-ops/skills/plugins/context/gotchas.md:393-412: drift, medium. Live: https://code.claude.com/docs/en/headless, anchor #start-faster-with-bare-mode
• plugins/harness-ops/skills/audit-performance/scripts/audit_performance.py:2195: incomplete-record, medium. Live: https://code.claude.com/docs/en/troubleshoot-install, anchor #claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell
• plugins/harness-ops/skills/audit-performance/reference/known-performance-issues.md:635: drift, medium. Live: https://code.claude.com/docs/en/desktop, anchor coming-from-the-cli > shared-configuration; environment-configuration > local-sessions
• plugins/harness-ops/skills/audit-performance/reference/known-performance-issues.md:637 and :649: incomplete-record, low. Live: https://code.claude.com/docs/en/desktop, anchor shared-configuration
• plugins/harness-ops/skills/observability/context/operator-setup-emission-privacy.md:63-64 and :73: incomplete-record, low. Live: https://code.claude.com/docs/en/agent-sdk/observability, anchor control-sensitive-data-in-exports

instruction-placement

• plugins/instruction-placement/skills/migrate/reference/sources.md:363: incomplete-record, low. Live: https://code.claude.com/docs/en/plugins/create, page-level

machine-health

• plugins/machine-health/skills/audit/reference/windows/check-catalog.md:608-626: drift, low. Live: https://code.claude.com/docs/en/interactive-mode, anchor #how-backgrounding-works

miro

• plugins/miro/README.md:16 (also plugins/miro/skills/setup/SKILL.md:44-47): drift, low. Live: https://code.claude.com/docs/en/debug-your-config, anchor check-mcp-servers

playbooks

• plugins/playbooks/skills/boris/reference/favorites.md:139: drift, medium. Live: https://code.claude.com/docs/en/best-practices, anchor #automate-and-scale (not cited)
• plugins/playbooks/skills/boris/reference/orchestration.md:26: missing-pointer, low. Live: https://code.claude.com/docs/en/fast-mode, anchor #toggle-fast-mode
• plugins/playbooks/skills/boris/reference/customization.md:15: drift, medium. Live: https://code.claude.com/docs/en/terminal-config, anchor enter-multiline-prompts
• plugins/playbooks/skills/boris/reference/customization.md:102-104: missing-pointer, low. Live: https://code.claude.com/docs/en/keybindings, anchor configuration-file
• plugins/playbooks/skills/boris/reference/orchestration.md:48: missing-pointer, medium. Live: https://claude.dev/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code, anchor #why-dynamic-workflows
• plugins/playbooks/skills/boris/reference/orchestration.md:56: missing-pointer, medium. Live: https://claude.dev/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code, anchor #helpful-patterns-when-using-dynamic-workflows
• plugins/playbooks/skills/boris/reference/orchestration.md:60: missing-pointer, low. Live: https://claude.dev/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code, anchor #use-cases
• plugins/playbooks/skills/boris/vendor/upstream-skill.md:1451: drift, low. Live: https://claude.dev/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code, anchor #why-dynamic-workflows
• plugins/playbooks/skills/fable-5/context/verification.md:68: missing-pointer, low. Live: https://claude.dev/blog/building-effective-agent-automations, anchor #get-the-code

visualization

• plugins/visualization/skills/visualize/context/decision-matrix.md:241,244,249,252: incomplete-record, low. Live: https://code.claude.com/docs/en/interactive-mode, page-level

(repository root)

• docs/upstream/claude-code-mods/research-2026-09-19/research-authoring-and-testing.md:150: drift, low. Live: https://code.claude.com/docs/en/plugins/mods/test, anchor follow-the-test-kits-rules
• scripts/test-plugin-mods.sh:1-8: missing-pointer, low. Live: https://code.claude.com/docs/en/plugins/mods/test, anchor write-a-test
• docs/adr/0002-default-on-ai-review-advisory-with-earned-promotion.md:190-194: missing-pointer, medium. Live: https://code.claude.com/docs/en/github-actions, anchor #who-can-trigger-runs
• lib/session-bridge/README.md:176: missing-pointer, low. Live: https://code.claude.com/docs/en/authentication, anchor authentication-precedence
• docs/upstream/claude-code-mods/sources.md (no row for the page): missing-pointer, low. Live: https://claude.dev/blog/getting-started-with-claude-code-mods, anchor #four-habits-worth-keeping
• docs/finding-your-unknowns.md:265-267: missing-pointer, low. Live: https://claude.dev/blog/using-claude-code-the-unreasonable-effectiveness-of-html, page-level

Recheck on main first

The pass deferred these because another open PR owned the file at the time. Those PRs have since merged, so each finding may already be fixed.

context-budget

• plugins/context-budget/skills/audit/reference/levers.json:393: drift, medium. Live: https://code.claude.com/docs/en/mcp, anchor #configure-tool-search
• plugins/context-budget/skills/audit/reference/levers.json:207: drift, low. Live: https://code.claude.com/docs/en/headless, anchor #start-faster-with-bare-mode
• plugins/context-budget/skills/audit/reference/levers.json:402 and :467: incomplete-record, medium. Live: https://code.claude.com/docs/en/agent-sdk/tool-search, anchor configure-tool-search

disk-hygiene

• plugins/disk-hygiene/skills/clean/reference/safety-model.md:698: incomplete-record, low. Live: https://code.claude.com/docs/en/headless, anchor #turn-off-permission-prompts-in-unattended-runs

dometrain-mcp

• plugins/dometrain-mcp/README.md:183: incomplete-record, medium. Live: https://code.claude.com/docs/en/mcp, anchor #scope-hierarchy-and-precedence, #use-dynamic-headers-for-custom-authentication

harness-config

• plugins/harness-config/skills/audit-instructions/reference/criteria.md:343-345: incomplete-record, medium. Live: https://code.claude.com/docs/en/sub-agents, anchor #what-loads-at-startup (not cited)
• plugins/harness-config/skills/audit-instructions/reference/criteria.md:218-219: drift, medium. Live: https://code.claude.com/docs/en/features-overview, anchor understand-how-features-layer
• plugins/harness-config/skills/audit-instructions/reference/criteria.md:219: incomplete-record, medium. Live: https://code.claude.com/docs/en/features-overview, anchor understand-how-features-layer
• plugins/harness-config/skills/audit-instructions/reference/criteria.md:212: wrong-host citation, medium. Live: https://claude.dev/blog/the-new-rules-of-context-engineering-for-claude-5-generation-models, page-level

planning

• plugins/planning/skills/plan/context/plan-template.md:410: missing-pointer, medium. Live: https://code.claude.com/docs/en/agent-teams, anchor #avoid-file-conflicts
• plugins/planning/skills/draft-goal-condition/SKILL.md:31: drift, medium. Live: https://code.claude.com/docs/en/goal, anchor compare-ways-to-keep-a-session-running
• plugins/planning/skills/draft-goal-condition/SKILL.md:147: missing-pointer, medium. Live: https://code.claude.com/docs/en/goal, anchor set-a-goal
• plugins/planning/README.md:115 and plugins/planning/.claude-plugin/plugin.json:18: missing-pointer, medium. Live: https://code.claude.com/docs/en/agent-sdk/user-input, anchor limitations

playbooks

• plugins/playbooks/skills/skill-authoring/SKILL.md:141: drift, medium. Live: https://claude.dev/blog/lessons-from-building-claude-code-how-we-use-skills, anchor #composing-skills
• plugins/playbooks/skills/skill-authoring/SKILL.md:19: missing-pointer, low. Live: https://claude.dev/blog/lessons-from-building-claude-code-how-we-use-skills, page-level

session-flow

• plugins/session-flow/skills/retro/SKILL.md:121-128: drift, low. Live: https://code.claude.com/docs/en/data-usage, anchor data-retention
• plugins/session-flow/reference/save-point.md:411: incomplete-record, medium. Live: https://code.claude.com/docs/en/goal, anchor write-an-effective-condition; set-a-goal

source-control

• plugins/source-control/skills/babysit-prs/reference/safety.md:426-429: missing-pointer, low. Live: https://code.claude.com/docs/en/headless, anchor #turn-off-permission-prompts-in-unattended-runs

(repository root)

• docs/migration-playbook.md:509-513: incomplete-record, medium. Live: https://code.claude.com/docs/en/plugins/loading, anchor #which-marketplaces-and-plugins-auto-update
• AGENTS.md:46: missing-pointer, low. Live: https://code.claude.com/docs/en/cli-reference, anchor #cli-flags
• docs/migration-playbook.md:1478: drift, low. Live: https://code.claude.com/docs/en/plugins/host-marketplace, anchor #add-a-headershelper-to-a-plugin-entry
• docs/migration-playbook.md:1477: drift, low. Live: https://code.claude.com/docs/en/plugins/marketplace-reference, anchor #command-plugin-source
• docs/migration-playbook.md:792-793: drift, medium. Live: https://code.claude.com/docs/en/plugins/org, anchor require-plugins-per-repository
• docs/migration-playbook.md:792-796: incomplete-record, medium. Live: https://code.claude.com/docs/en/plugins/org, anchor require-plugins-per-repository

Skipped: files owned by other open PRs

Not listed above because an open PR outside the sweep touches the file. Pick them up after that PR merges.

• plugins/testing/README.md:80-84 (#7046)
• plugins/source-control/README.md:160-164 (#7050)
• plugins/guardrails/README.md:72-76 (#7056)
• plugins/planning/skills/plan/SKILL.md:77 (#7053, #7059)
• plugins/implementation/skills/implement-dispatch/SKILL.md:105-113 (#7045)
• docs/plugin-philosophy.md:106-107 (#6861)
• docs/plugin-philosophy.md:955 (#6861)

The pass also found a dead anchor, hooks-guide#debug-techniques, cited in docs/conventions/hook-observability/README.md and owned by #7064. #7064 has since merged, and main no longer cites that anchor, so no action is needed.

Affected area / component

Pointer records to upstream docs across the plugins and repo docs listed above.

Found during the upstream-pointer sweep (PRs #7061-#7274).