Does this skill support the MADR format?

Yes, the skill is designed to generate records following the Markdown Architectural Decision Records (MADR) structure.

How do I trigger the ADR authoring skill in Claude Code?

The skill triggers on phrases like 'create ADR', 'document this decision', 'architecture decision', or when working on plan files that contain ADR sections.

An Architecture Decision Record (ADR) is a short text file that captures an important architectural decision, including the context in which it was made and its consequences.

Which ADR template should I use?

Use 'Lightweight' for quick, low-impact decisions; 'Standard' for most architectural choices; and 'Full' for critical, high-impact, or irreversible decisions requiring deep traceability.

Architecture Decision Record Authoring

Name: Architecture Decision Record Authoring
Author: ddunnock

byddunnock

•

Learning & Documentation

Standardizes the creation and maintenance of Architecture Decision Records (ADRs) to document technical choices and their rationale.

This skill empowers teams to capture the rationale behind technical architecture by streamlining the creation of Architecture Decision Records (ADRs). By providing structured templates ranging from lightweight to comprehensive, it ensures that technical decisions are documented with necessary context, considered options, and trade-offs. This prevents the re-litigation of old decisions, aids in onboarding new developers, and maintains a clear, traceable history of a project's evolution within the Claude Code environment.

Key Features

01Standardized ADR lifecycle management including proposed, accepted, deprecated, and superseded states.

021 GitHub stars

03Multi-level MADR templates tailored for lightweight, standard, or full-scale architectural decisions.

04Guidance for writing quantifiable decision drivers and objective context statements.

05Automated sequential numbering and domain-specific categorization for organized documentation.

06Traceability integration to link ADRs directly to specific requirements and implementation tasks.

Use Cases

01Documenting the selection of a new database, framework, or cloud infrastructure provider.

02Recording the rationale behind specific API design patterns or security protocols during development.

03Reviewing and updating past architectural choices when transitioning to new technologies or superseding old patterns.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ddunnock/claude-plugins adr-authoring

For use in Claude.ai and ChatGPT

Download Skill