What problem does it solve? Knowledge base facts about a codebase silently go stale as the code evolves, leaving teams with outdated anchors, expired TTLs, and taxonomy entries that no longer match the directory structure. This Skill audits the OpenSpec knowledge base to detect drift, verify facts against current source code, and keep indexes and taxonomy synchronized. ## Core Features & Use Cases - Fact verification and read-repair: Re-verifies KB facts against anchors in src/, classifies drift as auto-repairable, review-required, or deprecate-candidate, and automatically repairs mechanical fingerprint mismatches. - Index and metrics maintenance: Rebuilds _index.yaml from KB markdown files with --reindex and reports usage counters, dead facts, and TTL calibration with --metrics. - Taxonomy and structure checks: Compares _taxonomy.yaml against src/*/cfe/* directories with --taxonomy-sync and validates the knowledge folder against a whitelist. - Use Case: After a large refactoring, run /opsx:knowledge-audit --overdue to re-verify only facts with expired TTL, auto-repair trivial drift, and receive a report listing facts that still need a manual decision. ## Quick Start Ask the assistant to run /opsx:knowledge-audit to verify all knowledge base facts against the current source code and generate an audit report.
