do-docslisted
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