skills.rest
rodrigotoledo
rodrigotoledoCOMMUNITY
Explore all skills by this author →
Website𝕏@foolkgsGitHub

create-adr

Generate Architecture Decision Records in MADR, Nygard, or Y-Statement formats.

Updated Jun 18, 2026
Search Tags:#architecture#documentation#adr#madr#decision-record#nygard#y-statement
One-click install
npx skills add https://github.com/rodrigotoledo/trading-exchange --skill create-adr-rodrigotoledo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-adr
Source: https://github.com/rodrigotoledo/trading-exchange/tree/main/packages/skills-catalog/skills/%28creation%29/create-adr
Command: npx skills add https://github.com/rodrigotoledo/trading-exchange --skill create-adr-rodrigotoledo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADRs capture the context, decision, and consequences of architectural choices to help future engineers understand why things are the way they are.

Core Features & Use Cases

  • Generates MADR, Nygard, or Y-Statement ADR formats to document decisions.
  • Supports interactive workflows to gather decision context (date, status, drivers, options).
  • Automatically assigns next ADR number by scanning existing ADR directories and enforces consistent naming conventions.
  • Includes guidance on when to use ADR vs RFC and how to link related decisions or tickets.

Quick Start

Draft an ADR describing a finalized architectural decision using MADR format.

Frequently Asked Questions about create-adr

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

FAQPage Schema
How do I document architectural decisions using MADR or Nygard formats?▼

To document architectural decisions, you generate ADRs using MADR, Nygard, or Y-Statement formats. The process captures title, date, status, context, decision, and consequences to record significant architectural choices.

What is the difference between an ADR and an RFC?▼

An ADR records finalized architectural choices including their context and consequences, while an RFC is typically used for proposing changes. ADRs also support supersession tracking to link and update related decisions over time.

How do I automatically assign ADR numbers to new architecture decision records?▼

You can automatically assign ADR numbers by scanning existing ADR directories. This enforces consistent naming conventions and sequentially assigns the next available number to newly documented architectural decisions.

Can I include decision drivers and considered options when creating an ADR?▼

Yes, when creating an ADR you can include optional decision drivers, considered options, links, and supersession tracking. This ensures all context surrounding significant architectural choices is documented for future engineering teams.

What should an architectural decision record include for engineering teams?▼

An architectural decision record should include structured documentation with a title, date, status, context, decision, and consequences. It captures why specific architectural choices were made for future engineering teams.

Related Skills

Explore More Software Engineering Skills→
amdmaxamdmax
2

create-adr

Generate Architecture Decision Records in MADR format from story context and NFRs.

Community
Advanced
jikig-aijikig-ai
12

architecture

Create, manage, and query ADRs and Mermaid C4 diagrams.

Official
Advanced
belokonmbelokonm
8

document-writer

Create templated ADR, RFC, and system design documentation.

Community
Advanced
vikas-gits-goodvikas-gits-good

confluence-docs

Generate standardized Markdown templates for Architecture Decision Records and operational runbooks.

Community
Intermediate