drafting-an-adr
Use when a decision affecting architecture (structure, non-functional characteristics, dependencies, interfaces, or construction techniques) needs to be recorded before or after it's made. Applies Nygard's architecturally-significant criteria to judge warrant, then drafts an ADR from a MADR-derived template. Distinct from explaining-the-work (cites an ADR, never authors one) and drafting-an-acm-issue (same drafted-artifact shape, different artifact).
Pinned to revision 1d6444696221, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/drafting-an-adr/SKILL.md
- skills/drafting-an-adr/metadata/gitapex.yaml
- skills/drafting-an-adr/references/adr-template.md
- skills/drafting-an-adr/references/this-repo-only.md
- skills/drafting-an-adr/scripts/gitapex_check_adr_shape.py
- skills/drafting-an-adr/scripts/test_gitapex_check_adr_shape.py
Every link opens the file at its source, pinned to the revision this page describes.