skills.rest
agentpatterns
agentpatternsOFFICIAL
Explore all skills by this author →
GitHub

adr

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
One-click install
npx skills add https://github.com/agentpatterns/craft --skill adr-agentpatterns
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
MoffranMoffran
78

ce-adr-author

Create and revise ADR entries with auto-numbering and template validation.

Community
Intermediate
lluppesmslluppesms

create-architectural-decision-record

Generate structured Architectural Decision Records with YAML frontmatter and coded bullet points.

Community
Intermediate
adelproadelpro
34

architecture

Document architecture decisions with context, options, and trade-offs in ADRs.

Community
Advanced
Partners-in-BizPartners-in-Biz

documentation-and-adrs

Document architectural decisions and design rationales in Markdown ADRs with YAML frontmatter.

Community
Advanced