An Architectural Decision Record (ADR) is a document that captures a significant technical decision, including the context in which it was made and the consequences it has for the project.

How do I create the record once the skill suggests it?

You can use the command /adr:create within your Claude Code environment to quickly generate a new architectural decision record.

When will this skill suggest an ADR?

It suggests an ADR when it detects high-impact changes like adding new frameworks, changing security protocols, migrating technologies, or restructuring core modules.

Does it suggest an ADR for every code change?

No, it specifically avoids suggesting ADRs for bug fixes, minor refactors, routine dependency updates, or style changes to keep prompts relevant.

Architectural Decision Records (ADR)

Name: Architectural Decision Records (ADR)
Author: dariuszparys

bydariuszparys

0•

学习与文档

Suggests documenting significant architectural changes as ADRs to capture technical context and long-term reasoning.

The ADR Skill helps maintain a healthy codebase history by identifying moments where long-term architectural choices are made and prompting for their documentation. It monitors for significant changes such as new framework integrations, infrastructure shifts, or core refactoring, then provides a non-intrusive nudge to use the /adr:create command. By capturing the rationale behind technical decisions as they happen, this skill ensures that future developers understand the context, trade-offs, and intentions behind the system's architecture.

主要功能

010 GitHub stars

02Streamlined integration with the /adr:create command

03Clear differentiation between routine tasks and ADR-worthy decisions

04Intelligent detection of architectural shifts and pattern changes

05Context-aware suggestions for documenting technical trade-offs

06Non-intrusive prompts delivered only after significant work is completed

使用场景

01Capturing the rationale behind a breaking API change or major refactoring

02Documenting the introduction of a new database or caching layer

03Recording trade-offs when choosing between two competing frameworks or libraries

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dariuszparys/claude-code-toolkit adr

For use in Claude.ai and ChatGPT

Download Skill