documentation-auditlisted

<!-- ABOUTME: Documentation audit skill for verifying claims against codebase --> <!-- ABOUTME: Uses two-pass extraction with pattern expansion for comprehensive detection --> # Documentation Audit Systematically verify claims in documentation against the actual codebase using a two-pass approach. ## Overview **Core principle:** Low recall is worse than false positives—missed claims stay invisible. **Two-pass process:** 1. **Pass 1:** Extract and verify claims directly from docs 2. **Pass 2A:** Expand patterns from false claims to find similar issues 3. **Pass 2B:** Compare codebase inventory vs documented items (gap detection) ## Quick Start 1. Identify target docs (user-facing only, skip `plans/`, `audits/`) 2. Note current git commit for report header 3. Run Pass 1 extraction using parallel agents (one per doc) 4. Analyze false claims for patterns 5. Run Pass 2 expansion searches 6. Generate `docs/audits/AUDIT_REPORT_YYYY-MM-DD.md` ## Claim Types | Type | Example | Verification | |------|---------|--------------| | `file_ref` | `scripts/foo.py` | File exists? | | `config_default` | "defaults to 'AI Radio'" | Check schema/code | | `env_var` | `STATION_NAME` | In .env.example + code? | | `cli_command` | `--normalize` flag | Script supports it? | | `behavior` | "runs every 2 minutes" | Check timers/code | **Verification confidence:** - **Tier 1 (auto):** file_ref, config_default, env_var, cli_command - **Tier 2 (semi-auto):** symbol_ref, version_req - **Tier 3 (huma