Architecture Decision Records Skill

Use When

Use when recording a consequential architecture choice, context, options, rationale, consequences, owner, and supersession path. Use ai-adr-catalogue for AI-system decisions and formal-review-gates for approval checkpoints.

Do not use for trivial implementation choices that do not affect system structure, cost, or future flexibility.
Do not use this skill to fabricate missing project facts, legal conclusions, test results, approvals, or certification claims.

Artefact	Source or provider	Required?	Missing-input behaviour
Decision problem; architectural context; constraints; viable options; evaluation evidence; affected interfaces; decision owner	Architecture owner and affected engineering or operations teams	Yes	Stop dependent work; name the missing item, owner, and decision impact. A review check remains `not assessed`.
Scope, audience, baseline/version, and accountable decision owner	Requester or project context	Yes	Ask for or record the gap; do not infer authority or scope.