he-doc-gardening

What problem does it solve?

This Skill addresses the common issue of documentation becoming outdated and misaligned with the actual behavior of the codebase, ensuring that documentation remains a reliable source of truth.

Core Features & Use Cases

• Automated Drift Detection: Scans for inconsistencies between documentation and code using objective signals like linting and CI checks.
• Stale Content Identification: Identifies outdated or obsolete documentation, dead links, and high-churn areas.
• Automated Fix Queuing: Generates new specifications and plans for doc-fix initiatives, prioritizing small, independently shippable changes.
• Use Case: After a series of code updates and feature releases, this skill can be run to automatically identify any documentation that no longer accurately reflects the current state of the software, and then create tasks to update it.

Quick Start

Run the he-doc-gardening skill to scan the entire repository for documentation drift.