Where should I store the ADR files created by this skill?

Standard practice is to store them within your project repository, typically in a directory like docs/adr/ or architecture/decisions/, using sequential numbering.

How does the skill validate the quality of an ADR?

It uses a built-in rubric to evaluate whether the context is clear, if at least 2-3 alternatives were documented, and if both benefits and drawbacks are honestly addressed.

Why should I use the ADR Architecture skill?

This skill ensures that your team's technical decisions are documented consistently, making it easier to onboard new members and understand the 'why' behind legacy choices years later.

Can I update an existing ADR using this skill?

Following best practices, ADRs are meant to be immutable. If a decision changes, the skill helps you create a new ADR that marks the previous one as 'Superseded'.

What is an Architecture Decision Record (ADR)?

An ADR is a short text file that captures a single significant technical decision, the context in which it was made, the alternatives considered, and the resulting consequences.

ADR Architecture Manager

Name: ADR Architecture Manager
Author: lyndonkl

bylyndonkl

•

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

Document significant technical decisions with context, rationale, and consequences to create a permanent architectural decision trail.

The ADR Architecture skill enables teams to systematically record and maintain Architecture Decision Records (ADRs) for technical, infrastructure, and process choices. By guiding users through a structured workflow—including context gathering, alternative analysis, and trade-off evaluation—it ensures that the 'why' behind critical decisions is preserved for future stakeholders. It includes built-in quality validation rubrics and standardized templates to maintain high documentation standards and clarity across the development lifecycle.

主な機能

018 GitHub stars

02Integrated quality validation rubric to score and improve decision records

03Immutable record tracking with support for superseding outdated decisions

04Structured ADR generation including context, alternatives, and consequences

05Standardized templates for technology selection and complex architecture

06Detailed guidance on documenting technical trade-offs and migration strategies

ユースケース

01Establishing and logging team-wide technical standards and coding conventions

02Recording the selection and rationale for new databases, frameworks, or libraries

03Documenting infrastructure changes such as microservices migrations or cloud provider shifts

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lyndonkl/claude adr-architecture

For use in Claude.ai and ChatGPT

Download Skill