kmp-project-docs-maintainer

Read the live docs and the source files they describe, then update the smallest stale surface while keeping terminology and links consistent. The heal_docs.py script automates sitemap regeneration, kebab-case renaming, and archiving of completed task notes.

Use the default topology: docs/tasks.md for active work, docs/architecture.md for system design, docs/decisions/ for ADRs, docs/reference/ for deep-dives, and docs/bugs/ for active bug threads. Task files follow the NN-slug-status.md naming convention.

The docs hygiene rules, topology, and healing scripts are generic Markdown and docs/ folder conventions that work on any project. However, the templates, module README guidance, and related skills are tailored to KMP clean architecture workflows.

heal_docs.py auto-fixes safe violations like snake_case names, completed task archiving, and sitemap regeneration. The audit script audit_skills_repo.py --docs-hygiene-only only flags violations such as orphaned reference docs, oversized files, and missing task index rows without modifying anything.

Do not use it for consumer release notes, per-skill changelogs, or maintaining the kmp-agent-skills repository's own docs, which route to the docs-maintainer skill instead. It also does not cover implementing product code.