Audit Derivability

Original name

Original description

Audit whether a documentation file earns its existence — could a fresh agent re-derive its conclusions by exploring the code, config, metadata, and structure itself? Read-only classifier: weighs each doc on derivability x re-derivation cost x drift risk x fact ownership and returns a verdict — delete, convert-to-pointer, keep-as-derivation-cache (drift-control required), or keep-owns-facts (rationale, decisions, constraints, external facts are non-derivable). Audience-aware: agent-facing surfaces get the full axe because exploration is cheap; human-facing docs weigh human derivation cost and clear a higher deletion bar. Use when: 'is this doc worth keeping', 'audit doc value', 'derivability', 'could an agent figure this out itself', 'should this doc exist', 'this doc just restates the code', 'prune redundant docs', 'does this doc earn its maintenance', before deleting a doc or before writing one that restates the codebase — not line-level noise inside a doc worth keeping (use /docs-hygiene:audit-noise), cross-file duplication (/docs-hygiene:extract-ssot), prose flavor (/docs-hygiene:compress), or code-mismatch staleness (a doc-drift detector).