How does the AI assist in the ADR process?

The AI handles research, option enumeration, consistent formatting, and risk summarization, while the human provides context and makes the final decision.

An Architecture Decision Record (ADR) is a short text file that captures a significant architectural decision, including its context, the options considered, and the final consequences.

Which frameworks does this skill support?

It includes the Salesforce Well-Architected framework for enterprise concerns and a Technical Trade-off framework for infrastructure, plus support for custom criteria.

Where is my decision progress saved?

The skill saves session state to a `.claude/adr-session.yaml` file to ensure continuity across the multi-step analysis and generation process.

What is the MADR template?

Markdown Architecture Decision Records (MADR) is a standardized format for lean architectural documentation that is easy to read and version control.

ADR Methodology Assistant

Name: ADR Methodology Assistant
Author: basher83

bybasher83

•

Productivity & Workflow

Automates the creation and documentation of Architectural Decision Records using structured frameworks and human-in-the-loop workflows.

The ADR Methodology Assistant streamlines the process of capturing complex architectural decisions by guiding users through a rigorous three-stage workflow. It helps teams define assessment criteria based on established frameworks like Salesforce Well-Architected or Technical Trade-offs, evaluates competing options through a risk-rated matrix, and generates standardized MADR-formatted documents. By managing the heavy lifting of research, formatting, and enumeration, it allows developers and architects to focus on project-specific context and final decision accountability while maintaining a high standard of documentation.

Key Features

01Standardized MADR output with mandatory AI disclosure sections

02Guided three-stage workflow: Context, Analysis, and Generation

0310 GitHub stars

04Automated risk rating and comparison matrix generation

05State persistence via YAML for multi-session decision tracking

06Pre-configured Salesforce Well-Architected and Technical Trade-off frameworks

Use Cases

01Documenting the selection of a new database or infrastructure provider

02Standardizing architecture decision records across a distributed engineering team

03Analyzing trade-offs between competing technical implementation patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add basher83/lunar-claude adr-methodology

For use in Claude.ai and ChatGPT

Download Skill