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.

Acerca de

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

Intelligent sequence numbering for both standalone and parallel execution
Context-aware exploration of related code, existing ADRs, and PR discussions
14 GitHub stars
Automated MADR template population with required YAML frontmatter
Comprehensive E.C.A.D.R. quality verification and checklist validation
Gap identification with explicit investigation markers for missing technical data

Casos de Uso

Recording technical rationale for framework migrations and infrastructure changes
Converting technical meeting notes or PR discussions into formal documentation
Standardizing decision-making records across large, distributed engineering teams

Acerca de

Características Principales

Intelligent sequence numbering for both standalone and parallel execution
Context-aware exploration of related code, existing ADRs, and PR discussions
14 GitHub stars
Automated MADR template population with required YAML frontmatter
Comprehensive E.C.A.D.R. quality verification and checklist validation
Gap identification with explicit investigation markers for missing technical data

Casos de Uso

Recording technical rationale for framework migrations and infrastructure changes
Converting technical meeting notes or PR discussions into formal documentation
Standardizing decision-making records across large, distributed engineering teams