What problem does it solve? Over time, learning and pattern docs under docs/solutions/ drift out of sync with the codebase: file paths move, recommended fixes become outdated, and overlapping docs contradict each other. This Skill reviews those docs against the current code and keeps, updates, consolidates, replaces, or deletes the drifted ones. ## Core Features & Use Cases - Drift Detection and Classification: Cross-references each learning doc's file paths, code snippets, and recommended solutions against the current codebase, then classifies it as Keep, Update, Consolidate, Replace, or Delete. - Document-Set Analysis: Detects overlapping, superseded, and contradictory docs, identifies the canonical source of truth per topic cluster, and merges or removes redundant files. - Interactive and Autofix Modes: Runs interactively with one-at-a-time questions on ambiguous cases, or fully unattended via mode:autofix, which applies safe actions and marks uncertain docs as stale with a summary report. - Use Case: After a major refactor, run a sweep of docs/solutions/ to find learnings referencing deleted files, update the ones whose fixes still apply, and replace docs whose recommended approach no longer matches the code. ## Quick Start Ask the assistant to refresh stale learnings in docs/solutions/ and audit them against the current codebase.
