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.