Skill: change-impact-annotate

---
name: change-impact-annotate-885ae4b848f9
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.