Architecture decision record (ADR)
An architecture decision record (ADR) is a document that captures an important architecture decision made along with its context and consequences — for software planning, CTO/CIO leadership teamwork, and project management documentation.
Important: do your own due diligence for these resources before using them in any
critical systems.
New: Claude Code skills for ADRs
Two Claude Code skills ship in the source repository so an AI coding agent can write and maintain ADRs the way this project recommends — see the skills page for what each one does and how to install it.
architecture-decision-record-skill
For anyone writing an ADR in any project: picks a template, names the file, and writes good context/consequences.
architecture-decision-record-maintainer-skill
For maintainers of this repository: how to add a template, example, or tool link, and keep README.md and locales/ in sync.