maintain-docs

Run update mode, which reads each documentation surface and compares it against actual filesystem state using Glob and Grep. It produces a drift report listing mismatched counts, broken paths, and missing entries, then applies factual fixes directly.

Use create mode with a target, which interviews you with focused questions tailored to the document type (system overview, knowledge guide, or operational reference). It drafts the document and waits for your approval before writing.

Run it after structural changes like adding agents, skills, or directories, after a system audit flags drift, or periodically to verify docs match reality. Skill counts in CLAUDE.md are the most common drift source.

It does not write research findings, create governance translations, propose structural changes, or modify workspace-root constitutional docs like CHARTER.md. Those belong to other skills or require human approval.

No. Update mode only fixes factual errors such as counts, lists, and broken paths. It preserves the original author's voice and does not reorganize sections unless factual accuracy requires it.