artifact-adr

Artifact: ADR (Architecture Decision Record)

A short record of an architectural decision and its rationale. In Matt Pocock’s skills, ADRs are written inline during grilling sessions by mp-grill-with-docs, capturing why a choice was made at the moment it is settled.

Produced by (backlinks)

Matt Pocock — Skills for Real Engineers:

• mp-grill-with-docs — records decisions as ADRs during the session.

Addy Osmani — Agent Skills:

• addy-documentation — writes ADRs at decision/ship time.

nano-spec:

• nano-spec-create — the pack’s doc.md Key Decisions (options considered · chosen · rationale); nano-spec-update appends new decisions as the build proceeds (part of the artifact-nano-spec-pack).

See Also

• artifact-domain-model — the companion shared-language doc updated alongside ADRs.
• artifact-design-md — OpenSpec’s per-change design record; same decision+rationale content, scoped to one change.