Where are the ADR files stored?

ADRs are typically stored directly within your project's repository, allowing them to be versioned and reviewed alongside your source code.

An Architecture Decision Record (ADR) is a short text file that captures a significant architectural decision, including its context, the rationale behind it, and its consequences.

How does this skill improve team collaboration?

It provides a standardized framework for documenting technical choices, ensuring all team members and stakeholders understand the 'why' behind specific implementation details.

What information is included in the ADR template?

The template includes the date, status, decision-makers, business/technical context, the decision statement, rationale, positive/negative consequences, and alternatives considered.

Should I edit an existing ADR if the decision changes?

No, best practices suggest that ADRs should be immutable. If a decision is changed, a new ADR should be created with a 'Superseded' status pointing back to the original record.

Architecture Decision Recorder

Name: Architecture Decision Recorder
Author: Dexploarer

byDexploarer

•

学习与文档

Systematically documents and manages software architecture decisions, trade-offs, and technical rationale using the ADR pattern.

This skill empowers developers to maintain a clear, version-controlled history of architectural choices using the Architecture Decision Record (ADR) pattern. It streamlines the creation of standardized records that capture business context, technical constraints, and long-term consequences, ensuring that the 'why' behind complex system designs is never lost. By integrating directly into the development workflow, it helps teams align on technology stacks, design patterns, and infrastructure changes while facilitating seamless handovers and future-proofing system audits.

主要功能

01Version-controlled architectural history maintenance

02Standardized ADR template generation

03Lifecycle management for decision statuses (Proposed, Accepted, Superseded)

042 GitHub stars

05Cross-linking and referencing of related decisions

06Automated tracking of architectural trade-offs and rationale

使用场景

01Recording major system refactors and the reasoning behind design pattern changes

02Evaluating and documenting the selection of new technology stacks or frameworks

03Onboarding new developers by providing a historical log of technical context and constraints

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dexploarer/hyper-forge architecture-decision-recorder

For use in Claude.ai and ChatGPT

Download Skill