Skip to content

docs-hygiene: run the sibling passes over the 174 route-to-sibling annotations from the repo-wide derivability sweep #2735

Description

@kyle-sexton

The repo-wide /docs-hygiene:audit-derivability sweep (2026-08-15, 1131 tracked .md files, applied in #2695) annotated 174 documents with route-to-sibling dispositions that are follow-up work for the sibling skills, not this sweep's:

  • 136 → /docs-hygiene:extract-ssot — doc-to-doc duplication candidates to deduplicate into one source of truth (their derivability verdicts stand; the duplication is a separate axis).
  • 38 → /docs-hygiene:audit-noise — line-level noise inside documents worth keeping.

Also carried forward from the same sweep:

  • False-keep sampling backlog: the completed sweep's 1089 keep-owns-facts verdicts were never sampled (the spot-test protocol at the time gated only delete/pointer verdicts). The contract now requires sampling keeps on future sweeps; a one-off sampling pass (e.g. 20 random keeps through the fresh-context probe) would bound the false-keep rate of the recorded ledger.
  • Note: two files in the list below were pointer-converted in feat(docs-hygiene): repo-wide sweep escalation for audit-derivability + apply the sweep's confirmed verdicts #2695 (registry-schema.md, ecosystems.md, TODO.md, jira README.md kept per spot-test) — re-verify list membership against the merged tree before dispatching.

Full per-document detail (four factors, rationale, route) was in the session's ledger (derivability-ledger.json, session a86db903 scratchpad — ephemeral container storage; the routed list below is the durable copy).

Routed documents (174)

route: audit-noise (38)

  • CLAUDE.md
  • docs/conventions/commit-convention/README.md
  • docs/conventions/config-cascade/README.md
  • docs/conventions/ecosystem-commands/README.md
  • docs/conventions/hook-observability/README.md
  • docs/conventions/hook-telemetry/README.md
  • docs/topics/context-engineering-claude-5/design/skill-inventory.md
  • plugins/ai-briefing/skills/generate/references/build-pipeline.md
  • plugins/ai-briefing/skills/generate/references/slide-generation.md
  • plugins/architecture/CHANGELOG.md
  • plugins/claude-ops/skills/known-issues/context/registry-schema.md
  • plugins/disk-hygiene/CHANGELOG.md
  • plugins/domain-driven-design/README.md
  • plugins/dometrain/README.md
  • plugins/education/CHANGELOG.md
  • plugins/education/README.md
  • plugins/eol-normalizer/CHANGELOG.md
  • plugins/eol-normalizer/README.md
  • plugins/evals/CHANGELOG.md
  • plugins/firecrawl/CHANGELOG.md
  • plugins/knowledge/skills/youtube-digest/templates/sources.md
  • plugins/knowledge/vendor/repo-analysis/README.md
  • plugins/knowledge/vendor/video-digestion/TUNING.md
  • plugins/machine-health/skills/audit/references/windows/check-catalog.md
  • plugins/machine-health/skills/audit/references/windows/elevation-matrix.md
  • plugins/mcp-tools/skills/audit/reference/server-discovery.md
  • plugins/planning/reference/topic-docs.md
  • plugins/planning/skills/draft-goal-condition/SKILL.md
  • plugins/planning/skills/interview/context/session-config.md
  • plugins/playbooks/skills/boris/SKILL.md
  • plugins/songwriting/context/pat-pattison/research/ai-tools.md
  • plugins/testing/README.md
  • plugins/toolchain/skills/check/context/bash.md
  • plugins/toolchain/skills/check/context/dotnet.md
  • plugins/toolchain/skills/check/context/go.md
  • plugins/toolchain/skills/check/context/python.md
  • plugins/toolchain/skills/check/context/typescript.md
  • plugins/typos-format/README.md

route: extract-ssot (136)

  • docs/conventions/finding-suppression/CHANGELOG.md
  • docs/conventions/hook-telemetry/CHANGELOG.md
  • docs/conventions/liveness-assertion/CHANGELOG.md
  • docs/conventions/plugin-data-report-keying/CHANGELOG.md
  • docs/conventions/standards/CHANGELOG.md
  • docs/conventions/standards/examples/worked-index.md
  • docs/conventions/topic-docs/examples/worked-slice.md
  • docs/topics/ai-adoption-ladder/design/RESEARCH-sandcastle-pocock.md
  • docs/topics/context-engineering-claude-5/design/coverage-matrix.md
  • docs/topics/context-engineering-claude-5/design/rerun-contract.md
  • docs/topics/fable-field-guide-audit/audit-brief.md
  • docs/topics/shadowed-skill-renames/PLAN.md
  • docs/upstream/mattpocock-skills-v12-map.md
  • plugins/adhd/README.md
  • plugins/ai-briefing/README.md
  • plugins/ai-briefing/skills/generate/context/execution-flow.md
  • plugins/architecture/README.md
  • plugins/architecture/reference/topic-docs.md
  • plugins/architecture/skills/improve/research/deepening/scan-briefing.md
  • plugins/autonomy/reference/routines/issue-triage-sweep.md
  • plugins/autonomy/reference/routines/pr-queue-tending.md
  • plugins/autonomy/reference/runner/lifecycle.md
  • plugins/autonomy/reference/trigger-dispatch.md
  • plugins/autonomy/skills/setup/SKILL.md
  • plugins/autonomy/skills/setup/context/capture-slice.md
  • plugins/autonomy/skills/setup/templates/isolation-probe.md
  • plugins/autonomy/skills/setup/templates/return-capture.md
  • plugins/autonomy/skills/setup/templates/routine-definitions.md
  • plugins/bash-format/README.md
  • plugins/biome-format/README.md
  • plugins/bug-report/README.md
  • plugins/claude-config/skills/audit-automation-gaps/context/gap-analysis.md
  • plugins/claude-config/skills/audit-automation-gaps/templates/checklist.md
  • plugins/claude-config/skills/audit/context/validation-categories.md
  • plugins/claude-config/skills/audit/reference/audit-checklist.md
  • plugins/claude-config/skills/audit/templates/checklist.md
  • plugins/claude-memory/skills/audit/context/audit.md
  • plugins/claude-memory/skills/stateless/SKILL.md
  • plugins/claude-memory/skills/stateless/context/status.md
  • plugins/claude-ops/skills/observability/context/operator-setup.md
  • plugins/claude-ops/skills/observability/context/read-routing.md
  • plugins/claude-ops/skills/plugins/context/gotchas.md
  • plugins/code-tidying/README.md
  • plugins/code-tidying/skills/batch-simplify/templates/checklist.md
  • plugins/codebase-health/README.md
  • plugins/codebase-health/skills/audit/templates/checklist.md
  • plugins/computer-use/README.md
  • plugins/context-guard/README.md
  • plugins/debugging/README.md
  • plugins/debugging/skills/debug/templates/checklist.md
  • plugins/discipline/README.md
  • plugins/discovery/reference/artifact-protocol.md
  • plugins/discovery/skills/research/context/gotchas.md
  • plugins/disk-hygiene/README.md
  • plugins/disk-hygiene/skills/clean/reference/safety-model.md
  • plugins/docs-hygiene/README.md
  • plugins/docs-hygiene/skills/compress/context/integration.md
  • plugins/docs-hygiene/skills/compress/context/target-types.md
  • plugins/docs-hygiene/skills/extract-ssot/context/decision-framework.md
  • plugins/docs-hygiene/skills/rename-references/context/apply.md
  • plugins/docs-hygiene/skills/rename-references/context/audit.md
  • plugins/docs-hygiene/skills/rename-references/context/triage.md
  • plugins/evals/README.md
  • plugins/event-storming/README.md
  • plugins/event-storming/skills/methodology/SKILL.md
  • plugins/event-storming/skills/methodology/reference/glossary-and-tools.md
  • plugins/event-storming/skills/methodology/reference/notation-and-building-blocks.md
  • plugins/firecrawl/skills/update/context/update-flow.md
  • plugins/implementation/reference/artifact-protocol.md
  • plugins/implementation/skills/implement/context/gotchas.md
  • plugins/knowledge/skills/youtube-digest/context/workflow.md
  • plugins/machine-health/skills/audit/TODO.md
  • plugins/machine-health/skills/audit/references/shared/output-schema.md
  • plugins/machine-health/skills/audit/scripts/linux/NOT_IMPLEMENTED.md
  • plugins/machine-health/skills/audit/scripts/macos/NOT_IMPLEMENTED.md
  • plugins/mcp-tools/README.md
  • plugins/mutation-testing/CHANGELOG.md
  • plugins/mutation-testing/README.md
  • plugins/mutation-testing/skills/audit/context/suppression.md
  • plugins/naming/README.md
  • plugins/planning/README.md
  • plugins/planning/skills/interview/templates/checklist.md
  • plugins/planning/skills/plan/context/plan-template.md
  • plugins/planning/skills/plan/templates/checklist.md
  • plugins/playbooks/README.md
  • plugins/playwright/README.md
  • plugins/playwright/skills/playwright/actions/update.md
  • plugins/plugin-quality/README.md
  • plugins/rate-limit-guard/README.md
  • plugins/repo-fleet-hygiene/README.md
  • plugins/repo-hygiene/README.md
  • plugins/repo-hygiene/skills/clean/reference/ecosystems.md
  • plugins/session-flow/README.md
  • plugins/session-flow/skills/workflow/context/philosophy.md
  • plugins/session-flow/skills/workflow/context/spec-first.md
  • plugins/session-flow/skills/workflow/templates/checklist.md
  • plugins/skill-quality/README.md
  • plugins/songwriting/context/pat-pattison/research/action-routing.md
  • plugins/songwriting/context/pat-pattison/research/demo-review.md
  • plugins/songwriting/context/pat-pattison/research/line-brainstorm.md
  • plugins/songwriting/context/pat-pattison/research/line-edit-rubric.md
  • plugins/songwriting/context/pat-pattison/research/rhyme-generation.md
  • plugins/songwriting/context/pat-pattison/research/rhyme-strategy.md
  • plugins/songwriting/context/pat-pattison/research/rhyme-types.md
  • plugins/songwriting/context/pat-pattison/research/rhyme-worksheets.md
  • plugins/songwriting/context/pat-pattison/research/worksheets.md
  • plugins/songwriting/context/pat-pattison/templates/audit-checklist-prompt.md
  • plugins/songwriting/context/pat-pattison/templates/diagnose-section-prompt.md
  • plugins/songwriting/context/pat-pattison/templates/line-brainstorm-prompt.md
  • plugins/songwriting/context/pat-pattison/templates/variations-prompt.md
  • plugins/songwriting/skills/co-write/SKILL.md
  • plugins/songwriting/skills/diagnose/SKILL.md
  • plugins/songwriting/skills/suno/context/advanced.md
  • plugins/songwriting/skills/suno/context/lyrics.md
  • plugins/songwriting/skills/suno/context/power-tips.md
  • plugins/songwriting/skills/suno/context/style.md
  • plugins/songwriting/skills/suno/context/tips.md
  • plugins/songwriting/skills/suno/context/troubleshoot.md
  • plugins/songwriting/skills/suno/context/v55-features.md
  • plugins/songwriting/skills/suno/context/voices.md
  • plugins/songwriting/skills/suno/context/workflow-recipes.md
  • plugins/songwriting/skills/suno/templates/metal.md
  • plugins/songwriting/skills/suno/templates/rnb.md
  • plugins/source-control/README.md
  • plugins/source-control/skills/pull-request/templates/checklist.md
  • plugins/tdd/README.md
  • plugins/toolchain/README.md
  • plugins/toolchain/skills/check/SKILL.md
  • plugins/toolchain/skills/lint/SKILL.md
  • plugins/verification/README.md
  • plugins/verification/reference/artifact-protocol.md
  • plugins/work-items/README.md
  • plugins/work-items/reference/tracker-seam.md
  • plugins/work-items/templates/checklist.md
  • plugins/work-items/tools/work-item-tracker/adapters/jira/README.md
  • plugins/x/README.md

Note the sweep contract's post-#2695 caveats when dispatching: templates/checklist.md files and similar runtime scaffolds in this list are functional artifacts under the updated rubric (out of scope for derivability; still legitimate extract-ssot candidates where they duplicate each other), and CHANGELOG files routed as duplication candidates should be judged against the changelog-parity convention before any dedup.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions