When should I use the ADR Writer skill?

You should use it for decisions that are difficult to reverse, choices between competing technologies, or any change that significantly affects multiple components or teams.

Does the skill support status tracking for decisions?

Yes, it includes standardized status values like Proposed, Accepted, Deprecated, and Superseded to help teams understand the current state of any architectural choice.

What is an Architecture Decision Record (ADR)?

An ADR is a document that captures a significant architectural decision made in a project, including the context, the decision itself, alternatives considered, and the resulting consequences.

Where does this skill store the documentation?

By default, this skill organizes ADRs in the docs/architecture/ directory using a sequential numbering system, such as ADR-001-short-title.md.

Can I customize the ADR template?

While the skill provides a high-quality default template including risk matrices and implementation notes, you can use the Edit tool to adjust it to your team's specific needs.

Architecture Decision Record Writer

Name: Architecture Decision Record Writer
Author: nitromike502

bynitromike502

0•

콘텐츠 관리

Standardizes the creation and management of Architecture Decision Records (ADRs) to document technical rationale and long-term consequences.

The Architecture Decision Record (ADR) Writer skill enables developers to document significant technical decisions with clarity and consistency. It provides a structured framework for capturing the problem context, exploring alternatives, assessing risks, and recording final decisions directly within the project repository. By maintaining a sequential historical record of architectural choices, this skill ensures that the rationale behind complex systems remains transparent and accessible to current and future contributors, preventing knowledge loss and improving long-term project maintainability.

주요 기능

01Comprehensive capture of context, alternatives considered, and rejection reasons

02Built-in risk assessment and mitigation planning tables

03Standardized file naming and directory organization in docs/architecture/

04Structured ADR template generation with standardized metadata and status tracking

05Historical change logging to track how decisions evolve over time

060 GitHub stars

사용 사례

01Recording breaking changes and their long-term impact on the system architecture

02Documenting the choice between competing database, library, or framework technologies

03Establishing reusable architectural patterns and system-wide coding standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nitromike502/meckert-claude-code-marketplace adr-writer

For use in Claude.ai and ChatGPT

Download Skill