Architecture Decision Record (ADR)

Create an Architecture Decision Record (ADR) for any technical decision. Use when asked to document a technical decision, write an ADR, record an architecture choice, or capture why a technology or approach was selected. Produces a structured ADR with context, decision, consequences, and tradeoffs.

▶ Run it free in the Playground View SKILL.md ↗

Install

npx pm-claude-skills add --agent claude   # or codex · cursor · gemini · hermes
# or one-line MCP (every skill, any client):
claude mcp add pm-skills -- npx -y pm-claude-skills-mcp

What to give it

ADR number — sequential number in your ADR registry — e.g. 012; or "next available" if unknown
Decision title — brief, e.g. "Use PostgreSQL as primary datastore"
Context — what situation led to this decision needing to be made?
Options considered — at least 2; if only 1 is given, prompt for alternatives that were considered or ruled out
Decision made — which option was chosen
Reason for choice
Status — Proposed / Accepted / Deprecated / Superseded
Author and date
Team context (optional) — optional — team size, relevant experience, org constraints; helps calibrate formality and depth of the Context section

Related skills

Architecture Decision Record (ADR) is one of 174 open-source professional AI agent skills. Try them all in the browser · ⭐ Star on GitHub · Browse the full catalog