← ClaudeAtlas

diff-doc-synclisted

Identify only the canonical docs made stale by the current diff.
Eliyce/paqad-ai · ★ 5 · Code & Development · score 74
Install: claude install-skill Eliyce/paqad-ai
## What It Does Narrows documentation follow-up to only the canonical docs made stale by the current diff, avoiding full documentation refreshes when `differential_refresh` is enabled. ## Use This When Use this after implementation or validation when you already know which files changed and only want the stale canonical documentation set. ## Inputs - Read the changed file list from `changed_files`. - Read `references/diff-sync-rules.md` for project-specific override rules before deciding whether a doc can be safely skipped. ## Procedure 1. Pipe the changed file list into `scripts/detect-stale-docs.sh` — it cross-references against existing canonical docs and emits candidate paths. 2. Drop any paths that `references/diff-sync-rules.md` declares safe to skip in this scenario. 3. Format as a JSON array exactly matching `assets/output.template.json` (sorted, duplicate-free). 4. Validate with `scripts/lint-output.sh` — it enforces JSON shape, sortedness, dedupe, and `.md` suffix. ## Output Contract - Match `assets/output.template.json`: a JSON array of canonical doc paths. `[]` exactly when none are stale. - Output must pass `scripts/lint-output.sh` (exit 0). ## Escalate / Stop Conditions - Ask when the changed file list is missing or incomplete. - Warn when the stale doc detector is unavailable or returns non-canonical paths. - Do not widen the result to a full documentation workflow unless the detector evidence requires it. ## Resources - `references/diff-sync-rules