What is an Architecture Decision Record (ADR)?

An ADR is a short text document that captures a significant architectural decision, the context in which it was made, and the consequences it has for the project's future.

Which ADR templates does this skill support?

It includes support for the comprehensive MADR (Markdown Architecture Decision Records) format, the compact Nygard format, and concise Y-Statements.

How can I enforce architectural decisions automatically?

The skill provides patterns for 'Fitness Functions' using tools like ArchUnit, which allow you to write unit tests that fail if the code violates an ADR.

Does this skill help with managing old or outdated decisions?

Yes, it includes specific patterns for superseding old ADRs and maintaining a clear status lifecycle to ensure engineers aren't following stale advice.

Architecture Decision Record (ADR) Patterns

Name: Architecture Decision Record (ADR) Patterns
Author: HermeticOrmus

byHermeticOrmus

0•

学習とドキュメンテーション

Standardizes architectural decision-making through proven templates, lifecycle management, and automated enforcement patterns.

This skill equips Claude with a comprehensive framework for creating and managing Architecture Decision Records (ADRs), ensuring that the rationale behind technical choices is never lost. It includes industry-standard templates like MADR and Nygard, logic for Y-Statements, and strategies for linking decisions directly to source code. By utilizing these patterns, teams can maintain a searchable history of design choices, prevent architectural drift using fitness functions, and avoid common pitfalls like stale documentation or contextless decrees, ultimately improving long-term system maintainability and team alignment.

主な機能

01Lifecycle management for superseding and retiring legacy architectural decisions

02Standardized templates for MADR, Nygard, and Y-Statement formats

03Comprehensive guide to identifying and avoiding architectural anti-patterns

04Automated enforcement patterns using ArchUnit fitness functions

050 GitHub stars

06Cross-referencing logic to link ADRs directly to relevant source code

ユースケース

01Onboarding new engineers by providing a structured, searchable history of system design

02Documenting high-impact technical choices like database migrations or framework selections

03Automating architectural compliance in CI/CD pipelines to prevent technical debt

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hermeticormus/librearch-claude-code adr-patterns

For use in Claude.ai and ChatGPT

主な機能

01Lifecycle management for superseding and retiring legacy architectural decisions

02Standardized templates for MADR, Nygard, and Y-Statement formats

03Comprehensive guide to identifying and avoiding architectural anti-patterns

04Automated enforcement patterns using ArchUnit fitness functions

050 GitHub stars

06Cross-referencing logic to link ADRs directly to relevant source code

ユースケース

01Onboarding new engineers by providing a structured, searchable history of system design

02Documenting high-impact technical choices like database migrations or framework selections

03Automating architectural compliance in CI/CD pipelines to prevent technical debt