How does this Claude Code skill help my team?

It provides Claude with standardized templates and best practices to ensure your team's technical decisions are documented consistently, making it easier to onboard new members and track project history.

What is an ADR in software development?

An Architecture Decision Record (ADR) is a short text file that captures a significant technical decision, including the context in which it was made and the resulting consequences.

Does it include a review process?

Absolutely. The skill outlines a comprehensive ADR review checklist to ensure that all viable options are considered and that security and cost implications are addressed before acceptance.

What formats does the ADR skill support?

The skill supports several industry standards, including Markdown Architecture Decision Records (MADR), lightweight formats for quick decisions, and Y-Statements for concise rationale.

Can I use this for existing legacy projects?

Yes, the skill includes patterns for documentation deprecation and superseding, allowing you to bridge the gap between historical choices and modern architectural changes.

Architecture Decision Records

Name: Architecture Decision Records
Author: EngineerWithAI

byEngineerWithAI

0•

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

Standardizes the documentation of significant technical decisions using Architecture Decision Records (ADRs) to capture context, rationale, and consequences.

This skill provides Claude with the specialized patterns and templates needed to create, maintain, and manage Architecture Decision Records (ADRs). By following industry standards like MADR and Y-statements, it helps development teams record the 'why' behind their architectural choices, ensuring historical context is preserved for future onboarding, audits, and system evolutions. It includes various templates for lightweight decisions, deprecations, and full RFCs, while also offering guidance on directory structure and automation tools to integrate documentation seamlessly into the development workflow.

主な機能

01Structured directory and index management patterns for long-term project maintainability

02Comprehensive RFC-style templates for complex architectural proposals and peer reviews

03Support for multiple ADR formats including MADR, Y-Statement, and Lightweight styles

04Integration guidance for ADR automation utilities and review checklists

05Standardized lifecycle management for Proposed, Accepted, Deprecated, and Superseded decisions

060 GitHub stars

ユースケース

01Managing the deprecation of legacy technologies and tracking superseded architectural choices

02Documenting the rationale and trade-offs when choosing a new database or framework

03Recording security architecture and API design patterns during system design phases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add engineerwithai/engineerwith-agents architecture-decision-records

For use in Claude.ai and ChatGPT

Download Skill