Skills
.Work. You
Rest

adr-writer

Official

Write MADR ADRs clearly and consistently.

Software Engineering#documentation#adr#reference#MADR#software-design#architectural-decision
AuthorBridgingIT-GmbH
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill helps teams consistently create MADR-compliant Architectural Decision Records to capture critical architectural decisions. It enforces structure, numbering, and references to related decisions, reducing ambiguity and drift over time.

Core Features & Use Cases

  • MADR-compliant ADR authoring with required sections (Status, Context, Decision, Rationale, Consequences, Alternatives, References, Notes)
  • 4-digit numbering and cross-linking of related ADRs for traceability
  • Guidance for implementation notes and references, improving documentation workflows

Quick Start

To create an ADR, generate the next ADR number under docs/ADR (for example, 0001-adr-writing.md), then fill in the Context, Decision, and Rationale sections and add References to related ADRs.

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-writer
Download link: https://github.com/BridgingIT-GmbH/bITdevKit.Examples.GettingStarted/archive/main.zip#adr-writer

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.