From adr
This skill should be used when the user asks about "MADR format", "MADR template", "Markdown Architectural Decision Records", "MADR 4.0", "MADR sections", or needs guidance on creating ADRs using the MADR (Markdown Architectural Decision Records) format.
npx claudepluginhub zircote/adrThis skill uses the workspace's default tool permissions.
MADR (Markdown Architectural Decision Records) is a lean, developer-friendly ADR format that emphasizes considered options and their pros/cons. It is the default format for the ADR plugin.
Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Uses ctx7 CLI to fetch current library docs, manage AI coding skills (install/search/generate), and configure Context7 MCP for AI editors.
MADR (Markdown Architectural Decision Records) is a lean, developer-friendly ADR format that emphasizes considered options and their pros/cons. It is the default format for the ADR plugin.
MADR is:
Current version: MADR 4.0.0
All sections including optional ones. Use for important decisions requiring comprehensive documentation.
Sections:
Only mandatory sections. Use for simpler decisions or when brevity is preferred.
Sections:
Same sections as full/minimal but without explanatory text. For experienced teams who know the format.
Format: # {Short Title}
The title should:
Examples:
# Use PostgreSQL for Primary Storage# Adopt Event-Driven ArchitectureThe current status of the decision.
Valid values: proposed, accepted, deprecated, superseded
Include metadata if needed:
## Status
Accepted
Supersedes ADR-0003
Describe the context and the problem requiring a decision.
Format options:
Example:
## Context and Problem Statement
Our order processing system experiences high latency during peak hours.
We need to decouple order submission from order processing to improve
responsiveness. The current synchronous architecture cannot scale to
meet projected growth of 5x order volume.
Forces and concerns influencing the decision.
Format: Bullet list
## Decision Drivers
* Need to handle 10x current load
* Team familiarity with technology
* Budget constraints (max $5K/month)
* Must integrate with existing systems
List of options seriously considered.
Format: Bullet list of option titles
## Considered Options
* RabbitMQ
* Apache Kafka
* AWS SQS
* Redis Pub/Sub
State the chosen option and why.
Format:
## Decision Outcome
Chosen option: "{option title}", because {justification}.
Example:
## Decision Outcome
Chosen option: "Apache Kafka", because it provides the durability and
replay capability we need for order processing, and the team has
existing experience with it.
Positive and negative outcomes of the decision.
Format:
### Consequences
* Good, because {positive outcome}
* Good, because {another positive}
* Bad, because {negative outcome}
* Bad, because {another negative}
How compliance with the decision will be verified.
Example:
### Confirmation
The implementation will be verified through:
* Architecture review before deployment
* Load testing against performance requirements
* ArchUnit tests to enforce message-based communication
Detailed analysis of each option.
Format:
## Pros and Cons of the Options
### {Option 1 Title}
{Brief description}
* Good, because {pro}
* Good, because {pro}
* Neutral, because {neutral point}
* Bad, because {con}
### {Option 2 Title}
{Brief description}
* Good, because {pro}
* Bad, because {con}
Additional context, links, or notes.
Include:
# Copy full template
cp ${CLAUDE_PLUGIN_ROOT}/templates/madr/adr-template-full.md docs/adr/0001-title.md
# Copy minimal template
cp ${CLAUDE_PLUGIN_ROOT}/templates/madr/adr-template-minimal.md docs/adr/0001-title.md
| Aspect | MADR | Nygard | Y-Statement |
|---|---|---|---|
| Focus | Options comparison | Decision recording | Concise statement |
| Length | Medium | Short | Very short |
| Options | Detailed | Implicit | Single |
| Best for | Tech decisions | Quick records | Simple decisions |
references/madr-examples.md - Complete MADR examplesTemplates available at ${CLAUDE_PLUGIN_ROOT}/templates/madr/:
adr-template-full.md - All sections with guidanceadr-template-minimal.md - Required sections onlyadr-template-bare.md - All sections, no guidanceadr-template-bare-minimal.md - Required sections, no guidance