How does the skill handle old decisions?

It manages a status lifecycle, allowing you to mark old decisions as 'Superseded' or 'Deprecated' while linking them to new ADRs for a clear historical audit trail.

When should I use the ADR skill?

Use this skill when choosing technologies, frameworks, or making decisions that are difficult to reverse or might confuse future engineers if left unexplained.

What is an Architecture Decision Record (ADR)?

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

What is included in the ADR template?

The template includes Date, Status, Deciders, Tags, Context (the problem), Decision (the solution), Consequences (trade-offs), Alternatives Considered, and Review Triggers.

Architecture Decision Record (ADR) Manager

Name: Architecture Decision Record (ADR) Manager
Author: chavangorakh1999

bychavangorakh1999

0•

Learning & Documentation

Generates and manages structured records for architectural decisions, capturing context, trade-offs, and consequences for engineering teams.

The ADR skill empowers Claude to help engineering teams document critical architectural choices using a standardized format. By capturing the 'why' behind technology selections, framework migrations, or design patterns, it prevents 'architecture rot' and ensures future developers understand the constraints and trade-offs considered during the decision-making process. It guides users through a comprehensive template covering context, decision rationale, positive and negative consequences, risks, and alternatives considered, ultimately fostering better team alignment and technical debt management.

Key Features

010 GitHub stars

02Standardized ADR template generation including status and deciders

03Automated lifecycle management for Proposed, Accepted, and Superseded states

04ADR Index maintenance for project-wide decision tracking

05Detailed alternative comparison to document rejected paths

06Structured impact analysis covering positive/negative consequences and risks

Use Cases

01Tracking the evolution of a system by superseding outdated architectural decisions

02Documenting the selection of a new primary database or backend framework

03Explaining complex architectural trade-offs to stakeholders and new team members

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add chavangorakh1999/sde-skills adr

For use in Claude.ai and ChatGPT