skills.rest
cpliakas
cpliakasCOMMUNITY
Explore all skills by this author →
GitHub

write-adr

Generate MADR-format Architecture Decision Records with sequential numbering and project context.

4|Updated Mar 11, 2026
Search Tags:#architecture#documentation#decision record#adr#technical decisions#madr
One-click install
npx skills add https://github.com/cpliakas/claude-code-engineering-leaders --skill write-adr-cpliakas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-adr
Source: https://github.com/cpliakas/claude-code-engineering-leaders/tree/main/skills/write-adr
Command: npx skills add https://github.com/cpliakas/claude-code-engineering-leaders --skill write-adr-cpliakas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of Architecture Decision Records (ADRs) in the MADR format, ensuring that significant architectural choices are properly documented and their context preserved.

Core Features & Use Cases

  • ADR Generation: Produces complete ADR documents based on a provided decision description.
  • Automated Numbering: Automatically determines the next ADR number by checking existing records.
  • Contextual Gathering: Gathers relevant project context from CLAUDE.md, existing ADRs, and project memory.
  • Use Case: When a new technical approach is decided upon, use this Skill to generate a formal ADR that captures the problem, options considered, the final decision, and its consequences.

Quick Start

Use the write-adr skill to document the decision to implement a new caching layer for the user profile service.

Frequently Asked Questions about write-adr

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

FAQPage Schema
How do I document architectural decisions in MADR format?▼

To document architectural decisions in MADR format, provide a decision description to generate a complete Architecture Decision Record. The output captures status, date, deciders, context, decision drivers, options, and consequences automatically.

What is an Architecture Decision Record used for?▼

An Architecture Decision Record is used to preserve the context of significant technical decisions. It documents the problem, options considered, and consequences, ensuring future teams understand why a specific architectural choice was made.

How are ADRs numbered when generating new technical decision records?▼

When generating new technical decision records, ADRs are numbered sequentially. The system checks existing records in your project directory to determine and automatically assign the next sequential number to the new document.

Do I need a CLAUDE.md file to create architecture documentation?▼

You do not strictly need a CLAUDE.md file to create architecture documentation, but having one improves output quality. The system gathers relevant project context from CLAUDE.md and project memory to populate the decision drivers and context sections.

What is the best way to track considered options for technical decisions?▼

The best way to track considered options for technical decisions is using the MADR template. It standardizes the documentation of decision drivers, evaluated alternatives, and the resulting consequences in a single, cohesive record.

Related Skills

Explore More Software Engineering Skills→
jbactadjbactad
1

context-optimizer

Generate and refine Automaker project context files for agent prompts.

Community
Advanced
VictorHueniVictorHueni

arch-adr

Automate creation, review, and maintenance of Architecture Decision Records using MADR 4.x conventions.

Community
Advanced
AJBcodingAJBcoding
4

moai-cc-claude-md

Generate structured Markdown documentation with templates and cross-references.

Community
Advanced
asterkinasterkin
1

adr

Create Architecture Decision Records with standardized sections and automatic numbering.

Community
Basic