How does the --review flag work?

When the --review flag is used, the skill creates a specialized team consisting of a drafter agent and an architect agent. The architect must review and approve the drafter's output before the ADR is finalized.

Where are the architectural records stored?

The skill stores ADRs in the docs/adrs/ directory of your project, using a standardized four-digit sequential naming convention such as ADR-0001-title.md.

Can this skill help with project onboarding?

Yes, by integrating with CLAUDE.md and maintaining a history of ADRs, it provides immediate architectural context for new developers or AI agents joining the project.

What is the MADR format used by this skill?

MADR stands for Markdown Architectural Decision Records. It is a lean template for capturing decisions including status, context, considered options, and positive/negative consequences.

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: joestump

byjoestump

•

Content Management

Generates and manages standardized Architecture Decision Records (ADRs) using the MADR format to document technical choices.

The ADR skill streamlines the process of capturing and documenting significant architectural decisions within a project codebase. It automatically manages sequential numbering, researches the current architecture to provide context, and drafts comprehensive records using the Markdown Architectural Decision Records (MADR) format. With support for multi-agent team reviews and automatic Mermaid diagram generation, this skill ensures that every technical decision is well-reasoned, evaluates multiple alternatives, and remains easily accessible to future developers through seamless integration with CLAUDE.md and the project's documentation directory.

Key Features

01Multi-agent review mode for collaborative drafting and validation

02Automatic codebase research to identify current architecture and context

03Seamless CLAUDE.md integration to maintain persistent architectural context

04Integrated Mermaid diagram generation for visual architecture mapping

05Automated MADR-formatted documentation generation with sequential numbering

064 GitHub stars

Use Cases

01Documenting the rationale for choosing a specific technology stack or database

02Recording breaking changes and architectural shifts for future maintainers

03Facilitating peer-reviewed technical design discussions using AI agents

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joestump/claude-plugin-design adr

For use in Claude.ai and ChatGPT

Download Skill