How does this skill help with technical debt?

It prevents 'decision rot' by ensuring that the reasoning behind specific code patterns is documented, allowing future developers to understand constraints that might no longer apply.

What is an ADR in this context?

An Architecture Decision Record (ADR) is a short text file that captures an important architectural decision, including its context and the consequences of the choice made.

When should I use the ADR skill in Claude Code?

Use this skill when making significant technical choices that are hard to reverse, such as selecting a framework, changing data schemas, or defining authentication patterns.

Can I track changes to decisions over time?

Yes, the skill includes a status lifecycle that allows you to mark decisions as Superseded or Deprecated when new ADRs are created.

Architecture Decision Record (ADR)

Name: Architecture Decision Record (ADR)
Author: chavangorakh1999

bychavangorakh1999

0•

Collaboration Tools

Standardizes the creation and management of Architecture Decision Records to capture technical context and rationale.

This skill empowers developers using Claude Code to systematically document significant architectural choices, ensuring that technical debt is minimized and institutional knowledge is preserved. It provides a structured framework for capturing the context, decision criteria, consequences, and alternatives considered for major technical shifts. By maintaining a clear status lifecycle and index, it helps engineering teams understand the evolution of their codebase, justifies current implementation patterns, and facilitates smoother onboarding for future contributors.

Key Features

010 GitHub stars

02Detailed tracking of alternatives considered and reasons for rejection

03Full status lifecycle management (Proposed, Accepted, Superseded, Deprecated)

04Structured capture of context, trade-offs, and decision rationale

05Standardized ADR templates for consistent architectural documentation

06Automatic indexing and cross-referencing for searchable decision history

Use Cases

01Managing the transition and history when a legacy technology is superseded

02Documenting the rationale for complex, hard-to-reverse API design changes

03Choosing between competing database technologies or cloud infrastructures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add chavangorakh1999/sde-skills adr

For use in Claude.ai and ChatGPT