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

学習とドキュメンテーション

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.

主な機能

Automated ADR numbering and kebab-case file naming
0 GitHub stars
Standardized MADR format implementation for consistency
Mandatory alternative analysis including a 'do nothing' option
Automatic generation of a centralized ADR index (README.md)
Comprehensive status tracking from Proposed to Superseded

ユースケース

Recording the rationale behind choosing a specific framework or database
Standardizing the design review process during large-scale refactors
Creating 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

Download Skill

GitHub

概要