Can I modify an ADR once it is accepted?

No. To maintain a clear history, accepted ADRs are immutable. If a decision changes, you create a new ADR that explicitly supersedes the previous one.

Where are the ADR files stored by this skill?

The skill automatically creates and manages markdown files within the docs/adr/ directory, using a sequential numbering format like 001-description.md.

Why does the skill insist on documenting alternatives?

The primary value of an ADR lies in understanding why other options were discarded. Documenting at least three alternatives ensures a rigorous evaluation process and provides clarity for future developers.

What is an Architecture Decision Record (ADR)?

An ADR is a document that captures an important architectural decision, the context in which it was made, the alternatives considered, and the final justification for the choice.

How does this integrate with Claude's memory?

The skill uses memory_log_decision to store the outcome, allowing Claude to remember your architectural choices in future sessions without needing to re-read the files every time.

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: 686f6c61

by686f6c61

•

学习与文档

Standardizes the documentation of significant architectural decisions and technical trade-offs using the ADR pattern.

This skill automates the creation and management of Architecture Decision Records (ADR), serving as the institutional memory for your software project. It guides users through documenting the context, evaluated alternatives, and consequences of design choices in a standardized markdown format. By enforcing a consistent structure in the docs/adr/ directory and integrating with the project's persistent memory, it ensures that technical decisions are transparent, justified, and easily accessible for future team members, preventing the loss of critical design context over time.

主要功能

01Integration with persistent project memory via memory_log_call for context-aware future sessions.

0237 GitHub stars

03Comprehensive impact assessment covering both positive and negative design consequences.

04Standardized ADR template generation with status tracking for proposed, accepted, or superseded decisions.

05Automatic sequential numbering and file management within the docs/adr/ directory.

06Comparative analysis of at least three technical alternatives including pros, cons, and risks.

使用场景

01Documenting the choice of a specific database or framework over competing technologies.

02Creating a searchable history of technical justifications to streamline developer onboarding and audits.

03Recording high-level design patterns or structural changes to the codebase for team alignment.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add 686f6c61/alfred-dev arquitectura

For use in Claude.ai and ChatGPT

Download Skill