adr

Name: adr
Availability: InStock
Author: agentpatterns

Create and manage Architecture Decision Records with structured YAML frontmatter.

5|1|Updated Feb 22, 2026

Search Tags:#template #architecture #documentation #adr #decision-record #advice-process

Ready to run

npx skills add https://github.com/agentpatterns/craft --skill adr-agentpatterns

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/agentpatterns/craft/tree/main/plugins/crafter/skills/adr
Command: npx skills add https://github.com/agentpatterns/craft --skill adr-agentpatterns

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Guides teams to record architectural decisions using ADRs, capturing context, alternatives, and rationale to improve traceability and future maintainability.

Core Features & Use Cases

Provides a structured ADR template combining MADR style with Harmel-Law advice process.
Encourages recorded decisions with context, options, consequences, and attribution.
Useful when architecture decisions involve multiple stakeholders or technologies.

Quick Start

Draft a new ADR using the template and fill in Context, Decision, Options, Consequences, and Advice.

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 for my software project?▼

You can draft a new ADR using a structured template that combines MADR style with the Harmel-Law advice process, requiring you to fill in Context, Decision, Options, Consequences, and Advice sections.

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

ADRs ensure your architectural rationale follows a consistent YAML frontmatter and structured format, making cross-team decisions and design reviews traceable across projects.

What is the best way to structure an ADR template for cross-team design reviews?▼

This structured approach combines MADR style with the Harmel-Law advice process, enabling teams to record decisions with proper context, options, consequences, and attribution during design reviews.

Can I use ADRs to capture context and rationale for multiple stakeholders?▼

By documenting context, alternatives, and rationale in a structured template, ADRs ensure cross-team decisions are traceable and maintainable across projects.

Do I need YAML frontmatter to create an Architecture Decision Record?▼

This standardized frontmatter helps maintain consistent attribution and metadata across all recorded architectural decisions within your projects.