← ClaudeAtlas

do-docslisted

Use when cascading documentation updates after code changes. Finds every document referencing the changed area and makes targeted surgical updates. Triggered by 'update docs', 'sync the docs', or any request about documentation updates.
tomcounsell/ai · ★ 14 · AI & Automation · score 70
Install: claude install-skill tomcounsell/ai
# Update Docs — Cascade Skill After a code change lands, find every document that references the changed area and make targeted, surgical updates so docs match the actual implementation. ## Stage Marker At the very start of this skill, write an in_progress marker: ```bash sdlc-tool stage-marker --stage DOCS --status in_progress --issue-number {issue_number} 2>/dev/null || true ``` After all documentation updates are complete and committed (Step 4), write the completion marker: ```bash sdlc-tool stage-marker --stage DOCS --status completed --issue-number {issue_number} 2>/dev/null || true ``` ## Goal Alignment When invoked by `do-build`, this skill should receive the **plan context** (high-level goal, tracking issue, and acceptance criteria) so doc updates are aligned with the feature's intent — not just the raw diff. **How to get plan context** (in priority order): 1. If the caller passed plan context inline (e.g., `do-build` includes it in the prompt), use that directly 2. Check the PR body for `Closes #N` — fetch the issue, then look for `docs/plans/{slug}.md` 3. Check the current git branch — if `session/{slug}`, look for `docs/plans/{slug}.md` 4. If no plan found, proceed without it — the diff alone is sufficient for doc cascading When plan context is available, use it to: - Understand the *purpose* of the change (not just what moved) - Identify which docs are conceptually related even without keyword overlap - Write doc updates that explain the "why" alongside