How does this skill optimize for LLM context?

It uses a tiered approach: a central index for high-level scanning, a 5-line Quick Reference block for relevance checking, and full content only when necessary, saving valuable context window space.

Does it manage the ADR index automatically?

Yes, every time a new ADR is created or an existing one is deprecated, the skill automatically updates the docs/decisions/INDEX.md file to ensure discoverability.

An Architectural Decision Record (ADR) is a short document that captures a significant technical decision, including its context, the options considered, and the final rationale.

When should I trigger the ADR skill?

You should use it whenever you make a significant technical choice, choose between different implementation approaches, or establish a new project-wide pattern.

Architectural Decision Records (ADR)

Name: Architectural Decision Records (ADR)
Author: mhylle

bymhylle

•

학습 및 문서화

Documents significant architectural and technical decisions in a standardized, LLM-optimized format.

This skill streamlines the creation and management of Architectural Decision Records (ADRs) within a codebase, ensuring that technical choices are documented with clarity and consistency. It employs a tiered reading strategy specifically designed for LLM context efficiency, featuring mandatory quick-reference blocks and a centralized index. By automating the boilerplate of ADR creation—including sequential numbering, status tracking, and cross-referencing—this skill helps development teams maintain a searchable history of the rationale behind their architecture, making it an essential tool for long-term project maintainability and seamless developer onboarding.

주요 기능

01Tiered reading strategy for maximum LLM context efficiency

02Integration with planning and implementation workflows to capture decisions in real-time

03Automatic indexing and categorization in a central INDEX.md file

04Automated sequential numbering and filename generation

0512 GitHub stars

06Standardized ADR template generation with mandatory Quick Reference blocks

사용 사례

01Tracking the evolution of a system by linking superseded and new decisions

02Establishing and enforcing new architectural patterns or coding conventions

03Documenting the rationale for choosing specific databases, frameworks, or libraries

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mhylle/claude-skills-collection adr

For use in Claude.ai and ChatGPT

Download Skill