compound-refresh

What problem does it solve?

Solution documentation in docs/solutions can become stale, reference deleted or moved code, duplicate other entries, or drift in relevance; that makes retrieval noisy and onboarding harder. This Skill performs a structured audit to identify outdated, missing, consolidated, or duplicate solution docs and recommends or applies corrective actions.

Core Features & Use Cases

• Inventory & Validation: Walks docs/solutions/**/*.md, reads frontmatter and body, records path, mtime, and metadata, and surfaces invalid frontmatter for user correction.
• Staleness Probes & Heuristics: Verifies referenced file existence and moved paths, checks for missing identifiers, computes age versus severity thresholds, and classifies each doc into Keep, Update, Consolidate, Replace, or Delete.
• Modes & Safe Application: Supports interactive, autofix, and report-only modes, writes a run artifact summarizing outcomes, stages only touched docs and the artifact, and enforces commit/worktree safety rules before applying changes.

Quick Start

Run compound-refresh from the repository root in report-only mode to generate a classification table of docs/solutions files.