Guide the team through writing a change-impact record for IEC 62304 / FDA / ISO 26262 ASIL C+ projects. Surfaces the affected REQ/DES/TEST/CODE artefacts and captures human-attested verification approach.
Scanned 9/19/2026
Install to Claude Code
Skills Directorynpx -y skills add SteveGJones/ai-first-sdlc-practices --skill change-impact-annotate --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Change Impact Annotate?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/stevegjones-change-impact-annotate)More formats (shields.io, HTML) on the badges page.
---
name: change-impact-annotate
description: Guide the team through writing a change-impact record for IEC 62304 / FDA / ISO 26262 ASIL C+ projects. Surfaces the affected REQ/DES/TEST/CODE artefacts and captures human-attested verification approach.
---
<!-- implements: DES-assured-skills-006 -->
# Skill: change-impact-annotate
**Use this skill** before pushing a code change that touches a regulated-context project where `change_impact_gate` is enabled. Produces a `docs/change-impacts/CHG-NNN.md` record that satisfies the gate.
## Inputs
- The unstaged or just-staged code changes (read from `git diff`)
## Steps
1. **Inspect the diff.** Identify the touched files and (best-effort) the touched functions.
2. **Map files to module IDs** using `programs.yaml`.
3. **Map touched functions to cited artefact IDs** by parsing existing `# implements:` annotations.
4. **Compute the next CHG number.** Scan `docs/change-impacts/CHG-*.md`; new ID = max + 1.
5. **Generate a draft.** Use the `change-impact.md` template, pre-filled with:
- Discovered REQs, DESs, TESTs, code locations, modules
- Empty fields for: change summary, downstream effects, verification approach, approver
6. **Prompt the user** to fill in the empty fields. Surface verification approach as the highest-stakes field (this is the regulator's primary check).
7. **Save.** Write to `docs/change-impacts/CHG-<NNN>.md`.
8. **Re-run change_impact_gate** to verify the record covers all touched code files.
9. **Remind.** "Approval signature is required before merge — the framework records it; the human authorises it."
## Done criteria
- `CHG-<NNN>.md` written.
- All touched code files cited in the record.
- `change_impact_gate` passes.
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
