What is the MADR format?

MADR stands for Markdown Any Decision Records. It is a lean template for ADRs that uses standard Markdown to record decisions in a structured and readable way.

What is an Architecture Decision Record (ADR)?

An ADR is a short text file that captures a significant architectural decision, including the context in which it was made and the consequences it has for the project.

How does this skill help with decision-making?

The skill enforces best practices by requiring at least two alternative solutions and a 'do nothing' scenario, ensuring that trade-offs are evaluated objectively before a decision is finalized.

Can I customize where ADR files are stored?

Yes, while the skill has a default path in the .kiro directory, you can provide an optional target directory argument to fit your project structure.

Architecture Decision Record (ADR) Generator

Name: Architecture Decision Record (ADR) Generator
Author: taiyousan15

bytaiyousan15

0•

Aprendizaje y Documentación

Generates standardized Architecture Decision Records (ADRs) in MADR format to document technical choices, alternatives, and trade-offs.

The Architecture Decision Record (ADR) Generator skill enables development teams to maintain a transparent and searchable history of critical architectural choices. By utilizing the MADR (Markdown Any Decision Records) format, it ensures that every major technical decision is documented with clear context, considered alternatives, and objective trade-off analysis. The skill automates the creation of structured Markdown files, manages sequential numbering, and maintains a centralized index, making it an essential tool for long-term project maintainability and seamless developer onboarding.

Características Principales

01Automated ADR numbering and kebab-case file naming

020 GitHub stars

03Standardized MADR format implementation for consistency

04Mandatory alternative analysis including a 'do nothing' option

05Automatic generation of a centralized ADR index (README.md)

06Comprehensive status tracking from Proposed to Superseded

Casos de Uso

01Recording the rationale behind choosing a specific framework or database

02Standardizing the design review process during large-scale refactors

03Creating a historical 'knowledge base' for new team members to understand past decisions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add taiyousan15/taisun_agent sdd-adr

For use in Claude.ai and ChatGPT