ce-compound-refresh

Invoke the refresh workflow on your docs/solutions/ directory. It reads each learning doc, cross-references file paths, class names, and code snippets against the current code, then classifies each doc as Keep, Update, Consolidate, Replace, or Delete with evidence.

Add mode:headless to the invocation arguments. Headless mode skips all user questions, applies unambiguous actions automatically, marks ambiguous cases as stale, and produces a summary report split into applied and recommended actions.

Yes, pass a scope hint as an argument such as a subdirectory name, filename, module, or keyword. The skill matches it against directories, frontmatter fields, filenames, then content, stopping at the first strategy that produces results.

Deleted docs are removed outright with no archive directory. Git history preserves every deleted file, so you can recover them later with git log --diff-filter=D on the docs/solutions/ path.

Replace applies when the core recommended solution conflicts with current code, not just when references moved. A replacement subagent writes a successor doc following the schema and template, then the orchestrator deletes the old file.

Yes, it searches the repo's markdown content for citations of the file before deletion. Decorative citations allow deletion with cleanup, while substantive citations signal Replace or stale-marking instead.