lfe-hygiene

What problem does it solve?

This Skill ensures that the repository maintains compliance with the Library-First Engineering framework by conducting structural audits to detect "Documentation Drift" or "Spaghetti Files."

Core Features & Use Cases

• Repository Audit: Checks for "Illegal" and "Ghost" files, ensuring all registered files are present and vice versa.
• Coordination Layer Audit: Verifies the coordination layer between the Library and the filesystem.
• State Audit: Ensures pipeline_status.md and CONTEXT.md accurately reflect the repository's state.
• History Audit: Checks CHANGELOG.md for compliance with the 7-milestone rolling window and session count accuracy.
• Skills Audit: Validates SKILL.md files and .agents/permissions.json.
• Scaling Audit: Ensures .docs/ directories and files meet size and organization requirements.
• Coordination Contract Audit: Checks for drift between the coordination contract and actual skill operations.
• Retention Check: Manages aged-out entries in the hot file and moves them to the cold file.
• Output Generation: Writes .plans/hygiene_report.md with findings.

Quick Start

Run the /lfe-hygiene command to initiate the hygiene audit.