adr

Create structured Markdown Architecture Decision Records in the plans/adr/ directory.

7|4|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/jeremyary/agent-scaffold --skill adr-jeremyary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/jeremyary/agent-scaffold/tree/main/.claude/skills/adr
Command: npx skills add https://github.com/jeremyary/agent-scaffold --skill adr-jeremyary

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you systematically document important architectural decisions, ensuring clarity and maintainability in your projects.

Core Features & Use Cases

  • Interactive Decision Recording: Guides you through capturing context, options, and rationale for architectural choices.
  • Standardized ADR Format: Generates Architecture Decision Records (ADRs) in a consistent, readable Markdown format.
  • Use Case: When deciding on a new database technology, use this Skill to document why a specific option was chosen over others, including the pros, cons, and consequences.

Quick Start

Use the adr skill to create a new architecture decision record for choosing a new database.

Frequently Asked Questions about adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document architectural decisions in a structured format?

This Skill creates Architecture Decision Records by interactively gathering context, considered options, and final rationale, then writes a structured Markdown file into the `plans/adr/` directory for clear project documentation.

What is an Architecture Decision Record and when should I create one?

An Architecture Decision Record (ADR) captures context, options, and rationale for technical design choices. You create one when making significant architectural decisions like adopting a new database technology to ensure maintainability.

How do I create a new ADR file with automated numbering?

You create a new ADR file by interactively providing decision context and options to the Skill. It automatically handles file numbering and naming conventions, saving the structured Markdown record in the `plans/adr/` directory.

What format are Architecture Decision Records stored in?

Architecture Decision Records are generated in a standardized Markdown format. This ensures the technical design documentation remains readable and consistently structured across your project's `plans/adr/` directory.

Can I use this to document pros and cons for a database technology choice?

Yes, you can document database technology choices by interactively providing context and options. The Skill captures the pros, cons, and consequences, generating a structured Markdown record of your architectural rationale.

Do I need any dependencies to generate Architecture Decision Records?

No dependencies are required. The Skill operates independently to interactively gather your technical design context and write the structured Markdown Architecture Decision Records directly to your project directory.