skills.rest
zircote
zircoteCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

adr-format-structured-madr

Structure ADRs with YAML frontmatter for auditable decision records.

5|3|Updated Jan 17, 2026
Search Tags:#architecture#documentation#adr#audit#frontmatter#decision-record#structured-madr
One-click install
npx skills add https://github.com/zircote/adr --skill adr-format-structured-madr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-format-structured-madr
Source: https://github.com/zircote/adr/tree/main/skills/adr-format-structured-madr
Command: npx skills add https://github.com/zircote/adr --skill adr-format-structured-madr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Structured MADR Format introduces a frontmatter-driven, auditable ADR framework that standardizes decisions and ensures traceability across projects.

Core Features & Use Cases

  • Frontmatter-driven metadata and structured decision context for auditability.
  • Comprehensive option analysis, risk assessment, and traceable links to related ADRs.
  • Generates MADR-compatible ADRs that are easy to review, version, and govern.

Quick Start

Create a new Structured MADR ADR using the frontmatter template and fill in the decision details.

Frequently Asked Questions about adr-format-structured-madr

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

FAQPage Schema
How do I add YAML frontmatter to architecture decision records for auditability?▼

You add YAML frontmatter to architecture decision records to embed traceable metadata, enabling auditable, standards-compliant decisions that satisfy governance requirements across projects.

What is MADR format and when do I need structured decision records?▼

MADR is a structured architecture decision record format needed when your project requires traceable metadata, mandatory audit sections, risk analysis, and links to related ADRs for governance.

How do I document option analysis and risk assessment in an ADR?▼

You document option analysis and risk assessment within a structured MADR by using a frontmatter template that includes dedicated sections for drivers, options, and comprehensive risk evaluation.

Does the structured MADR format support linking to related architecture decisions?▼

Yes, the structured MADR format supports linking to related architecture decisions, allowing you to create traceable connections between records for comprehensive audit trails and governance review.

How do I create governance-compliant ADRs that are easy to version and review?▼

You create governance-compliant ADRs by applying a structured MADR framework with frontmatter-driven metadata, which standardizes decisions and ensures they are easy to review, version, and govern.

Related Skills

Explore More Software Engineering Skills→
chaimtchaimt

speckit-adlc-architect-specify

Convert PRDs into MADR-compliant ADRs through guided interactive exploration.

Community
Advanced
BridgingIT-GmbHBridgingIT-GmbH
4

adr-writer

Automate MADR-compliant Architectural Decision Records with structured sections and 4-digit numbering.

Official
Advanced
ccfccf

architecture-decision-records

Document architectural decisions with a MADR-style template and lifecycle.

Community
Advanced
ChaiWithJaiChaiWithJai
1

technical-decision-record

Create Architecture Decision Records with standardized sections for context, constraints, options, decisions, and consequences.

Community
Intermediate