When is the best time to trigger this skill?

Trigger the ADR generator whenever you make a significant technical choice that affects the project's structure, security, or long-term maintenance, such as picking a framework or choosing an API pattern.

What is an ADR and why should I use one?

An Architecture Decision Record (ADR) is a document that captures an important architectural decision, including its context and consequences. Using them helps teams understand the 'why' behind the code years after the decision was made.

Where does the adr-generator save files?

The skill automatically saves new ADRs to a dedicated directory, typically `docs/adr/` or `adr/`, following a sequential numbering format (e.g., 0001-use-postgresql.md).

Is this skill meant for general code comments?

No, this skill is specifically for high-level architectural decisions. General implementation details should remain in your code documentation or README files.

ADR Generator

Name: ADR Generator
Author: cskiro

bycskiro

•

학습 및 문서화

Streamlines the creation of standardized Architecture Decision Records (ADRs) to document significant design choices and rationales.

The adr-generator skill provides a structured framework for documenting critical architectural decisions directly within a project's repository. By guiding developers through a standardized template—covering context, status, alternatives, and trade-offs—it ensures that the reasoning behind technical choices is preserved for future reference and team alignment. This skill is essential for maintaining a clear historical log of why specific technologies, patterns, or frameworks were chosen, helping teams avoid 'architecture drift' and simplifying the onboarding process for new developers.

주요 기능

01Natural language triggers for rapid documentation during the design process

02Automatic directory organization in docs/adr/ or adr/ folders

03Comprehensive consequence analysis including positive and negative trade-offs

04Sequential naming conventions for structured decision history

05Standardized ADR templates with status and lifecycle tracking

062 GitHub stars

사용 사례

01Choosing between different database technologies or persistence layers

02Recording the rationale for adopting specific architectural patterns like microservices or event-sourcing

03Defining standardized API design patterns for a distributed system

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cskiro/claudex adr-generator

For use in Claude.ai and ChatGPT

Download Skill