Will it overwrite my existing ADRs?

No. The skill includes a 'duplicate-checker' phase that compares new proposals against your existing index, allowing you to choose whether to create a new file, update an existing one, or supersede an old record.

How do I start using mADR Generator?

Simply run '/madr init' to set up the docs/decisions directory and inject the necessary architecture context into your CLAUDE.md file.

How does this skill detect architectural decisions?

The skill analyzes your recent Claude Code conversation logs (JSONL) and Git commit history to identify patterns that suggest an architectural choice was made, such as introducing a new library or changing a data flow.

Can I customize the documentation format?

Yes, you can configure the ADR directory, template style (full or minimal), and language preferences via a .madr-gen.json configuration file in your project root.

mADR stands for Markdown Architecture Decision Record, a standardized format for documenting significant design choices, their context, and their consequences within a project.

mADR Architecture Decision Generator

Name: mADR Architecture Decision Generator
Author: JiHongKim98

byJiHongKim98

•

Learning & Documentation

Automatically detects, validates, and documents architectural decisions from Claude Code sessions into standardized Markdown ADRs.

This skill automates the creation and maintenance of Markdown Architecture Decision Records (mADR) by analyzing Claude Code session history and Git changes. It utilizes a sophisticated three-phase pipeline—detection, validation, and execution—to identify significant architectural shifts, verify them against existing records to prevent duplicates, and generate professional documentation. By integrating with the CLAUDE.md file, it ensures that Claude remains context-aware of past decisions, maintaining architectural consistency and providing a clear rationale for every major design choice in your codebase.

Key Features

01Intelligent duplicate checking against existing ADR indices to prevent redundant documentation

023 GitHub stars

03Interactive multi-select CLI for choosing which detected decisions to record

04Session-aware decision detection using parallel JSONL log and Git analysis

05Seamless CLAUDE.md integration to preserve architectural context across sessions

06Automated MADR 4.0 template generation with support for full or minimal styles

Use Cases

01Maintaining a searchable history of design rationale to aid developer onboarding and team alignment

02Documenting technology stack migrations and library choices in real-time during development

03Synchronizing architectural state between Claude Code sessions to prevent design drift

Key Features

01Intelligent duplicate checking against existing ADR indices to prevent redundant documentation

023 GitHub stars

03Interactive multi-select CLI for choosing which detected decisions to record

04Session-aware decision detection using parallel JSONL log and Git analysis

05Seamless CLAUDE.md integration to preserve architectural context across sessions

06Automated MADR 4.0 template generation with support for full or minimal styles

Use Cases

01Maintaining a searchable history of design rationale to aid developer onboarding and team alignment

02Documenting technology stack migrations and library choices in real-time during development

03Synchronizing architectural state between Claude Code sessions to prevent design drift