What problem does it solve? Code changes constantly, and documentation drifts out of sync. This Skill researches the current code state, compares it against existing docs, and updates only the documents that owe code alignment—while protecting frozen design records, work records, and history records from accidental rewriting. ## Core Features & Use Cases - 5-Level Feature Resolution: Locates the target feature's docs and related code using a confidence-scored cascade, escalating to a human gate when the target cannot be found instead of guessing. - Role-Based Doc Classification: Uses resolveDocRole and owesCodeAlignment from scripts/lib/doc-metadata.js to distinguish current-authority docs (rewritable) from design records, work records, and history records (append-only or frozen). - Structured Diff and Verification: Produces a doc-vs-code comparison table, updates architecture diagrams, service tables, APIs, and data models, then re-verifies that new modules are documented and removed ones cleaned up. - Use Case: After a precommit pass lands changes to a feature under docs/features/, run this Skill to sync the affected current-authority docs and emit a Doc Update Report. ## Quick Start Ask the agent to run update-docs to research recent code changes and synchronize the corresponding feature documentation.
