Skills
.Work. You
Rest

adr-madr

Community

Turn architecture decisions into MADR-style ADRs

Software Engineering#git#adr#docs#madr#decision-record#architectural-decision
Authorc-tomioka
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Organizes informal architecture decisions, PR/issue discussions, and git history into a consistent, MADR-compliant Architectural Decision Record so teams can track and communicate design choices reliably.

Core Features & Use Cases

  • Create MADR ADRs: Convert freeform decision notes, meeting outcomes, or PR descriptions into a structured MADR-format markdown file with metadata, context, drivers, options, outcome, pros/cons, and links.
  • Reverse-engineer from repository artifacts: Infer ADRs from git logs, commits, PRs, and issues while flagging assumptions when information is missing.
  • Update existing ADRs: Accept an existing ADR and a list of changes and regenerate a single, updated ADR file following the repository's naming and placement rules.
  • Use Case: When a design decision is reached in a PR discussion, run this skill to produce a one-file MADR ADR, propose a docs/adr filename, and surface any information gaps for follow-up.

Quick Start

Create a MADR ADR from the provided decision notes, git log excerpt, or PR text and suggest a docs/adr filename using the repository conventions.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: adr-madr
Download link: https://github.com/c-tomioka/mbtorch/archive/main.zip#adr-madr

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.