# Record Adr

> Use this to create or modify architecture decision records (ADRs)

- Skill: `majiayu000/record-adr` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/record-adr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/record-adr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/record-adr

---


IMPORTANT: Use the template stored in `./templates/adr.md` to record the architecture decision.

## Guidelines for recording the decision

- Use a single sentence to describe the decision made.
- Defer any explanation for why to the context section.

## Guidelines for recording the context

- Make sure to include alternatives to the choice we're recording.
- Explain why we have to make the choice in the first place.

IMPORTANT: If you don't have this information, ask the user to provide the information!

## Guidelines for recording the options considered

- Create a sub section per option and provide a short description of the pros and cons of the option.
- Keep the description short and consise

## Guidelines for recording the consequences

- List the consequences one-by-one
- Include both positive and negative consequences in the list

## Where to store the ADR files

- Store ADR files in `docs/architecture/adr`
- Give a unique number to each ADR and write files like this: `001-title-of-the-adr.md`
- Include the ADR in the TOC in `09-decisions.md` located in in `docs/architecture`