maintain-docs

You can automate drift-detection by running an audit that compares code documentation against source code to identify structural inconsistencies and missing references. The maintain-docs Skill performs this drift-detection process and updates a persistent backlog with the results.

Finding orphaned docs and missing references in AGENTS.md is best handled by an on-demand audit that scans the documentation structure for outdated entries. The maintain-docs Skill identifies these orphaned entries and tracks them in a maintenance backlog.

No, you cannot use maintain-docs to rewrite source code. It enforces a strict constraint to edit only markdown files, ensuring source code remains untouched while it reconciles documentation drift and updates the maintenance backlog.

Managing a persistent backlog across multiple runs is achieved by tracking audit outcomes, including validated docs, exclusions, and new work items, in a synchronized file. The maintain-docs Skill automatically updates this maintenance backlog after each drift-detection run.

A documentation maintenance audit for post-feature reviews should be run after new code is merged to catch drift early. The maintain-docs Skill supports periodic maintenance and PR-driven fixes to keep AGENTS.md and developer docs synchronized with the source code.