Skills
.Work. You
Rest

adr-documentation

Official

Document architectural decisions effectively.

Software Engineering#architecture#decision making#documentation#adr#technical debt#trade-offs
AuthorMadAppGang
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a structured and comprehensive approach to documenting architectural decisions, ensuring clarity, context, and historical record-keeping for software projects.

Core Features & Use Cases

  • Standardized ADR Format: Guides users through creating Architecture Decision Records (ADRs) with predefined sections for context, decision, consequences, and alternatives.
  • Decision Lifecycle Management: Explains the process from proposal to acceptance, deprecation, and superseding of ADRs.
  • Integration Guidance: Shows how to reference ADRs within other documentation (like CLAUDE.md) and agent instructions to ensure compliance.
  • Use Case: When making a significant technology choice, like selecting a new database or framework, use this Skill to generate a formal ADR that captures the rationale, trade-offs, and alternatives considered, ensuring the decision is well-understood and recorded for the future.

Quick Start

Use the adr-documentation skill to generate a new Architecture Decision Record for a proposed database change.

Dependency Matrix

Required Modules

None required

Components

references

💻 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-documentation
Download link: https://github.com/MadAppGang/magus/archive/main.zip#adr-documentation

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 471,000+ vetted skills library on demand.