An Architectural Decision Record (ADR) is a short text document that captures a significant architectural decision, including its context, rationale, and consequences for the project's future.

What is the E.C.A.D.R. quality criteria?

It is a verification framework used by the skill to ensure every ADR is Explicit, Comprehensive, Actionable, Documented, and Reviewable before being marked as done.

What is the MADR template?

MADR stands for Markdown Architectural Decision Records. It is a lean, standardized template designed to make architectural decisions easy to write and read in version control systems.

Can I generate multiple ADRs at once?

Yes, the skill includes a specialized script to handle sequence numbering for parallel writes, preventing number collisions when documenting multiple decisions simultaneously.

How does this skill handle missing information?

The skill identifies missing context or data and inserts [INVESTIGATE] prompts directly into the document, highlighting exactly what needs to be followed up with stakeholders.

ADR Architect

Name: ADR Architect
Author: existential-birds

byexistential-birds

•

Aprendizaje y Documentación

Generates structured Architectural Decision Records using the MADR template to document technical choices and their impact.

The ADR Architect skill automates the creation of Architectural Decision Records, ensuring that technical decisions are documented consistently and professionally. It guides users through fetching sequence numbers, exploring project context, and filling out the MADR template while verifying content against a rigorous 'Definition of Done'. This skill is ideal for technical leads and developers who need to maintain a high-quality audit trail of architectural changes and identify information gaps that require further stakeholder investigation.

Características Principales

01Intelligent sequence numbering for both standalone and parallel execution

02Context-aware exploration of related code, existing ADRs, and PR discussions

0314 GitHub stars

04Automated MADR template population with required YAML frontmatter

05Comprehensive E.C.A.D.R. quality verification and checklist validation

06Gap identification with explicit investigation markers for missing technical data

Casos de Uso

01Recording technical rationale for framework migrations and infrastructure changes

02Converting technical meeting notes or PR discussions into formal documentation

03Standardizing decision-making records across large, distributed engineering teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add existential-birds/beagle adr-writing

For use in Claude.ai and ChatGPT

Download Skill