docs-audit
Docs Audit
Documentation-experience audit and debugging for any surface someone reads to
learn, integrate, recover, or retrieve — developer docs, end-user help, and
agent-readable docs. Provenance lives in skill.json; this file is runtime
routing only.
Produces: an intent-specific report — audit-report.md (friction findings,
score, audience conflicts) or debug-runbook.md (ranked hypotheses, fix path,
prevention).
Boundaries
Do NOT use to DESIGN new docs (use docs-design), to judge code package onboarding — install-to-first-success, errors, packaging (use dx-audit), for line-level prose tightening (use writing-audit), for end-user product UX outside help (use ux-audit), for repo agent hardening (use harden-repo-for-coding-agents), or for agent-native docs — AGENTS.md, llms.txt, tool descriptions (use agent-docs).