An Architecture Decision Record (ADR) is a short text document that captures a significant architectural decision made in a project, including the context, the decision itself, and the consequences.

When should I use the ADR Writer skill?

Use it for non-trivial decisions that are hard to reverse, involve significant trade-offs, or were debated by the team for more than 30 minutes.

Can it help me evaluate alternatives?

Yes, the ADR Writer specifically prompts for alternatives considered and requires concrete reasons for why they were rejected to ensure a balanced record.

Where are the ADRs typically stored?

The skill follows industry standards by recommending storage in a sequential format within the docs/adr/ directory of your project repository.

How does this skill help with team collaboration?

It provides a clear, standardized format that explains the 'why' behind technical choices to current and future team members, preventing repeated debates.

ADR Writer

Name: ADR Writer
Author: newkayak12

bynewkayak12

0•

学习与文档

Generates comprehensive Architecture Decision Records (ADRs) to document technical choices, trade-offs, and rejected alternatives.

The ADR Writer skill helps engineering teams maintain a living history of their system's architecture by formalizing the decision-making process. It guides users through capturing critical context, evaluating alternatives, and honestly assessing both positive and negative consequences of a choice. By enforcing a standardized template and active-voice declarations, it ensures that the rationale behind a decision is never lost, making it indispensable for long-lived projects, compliance requirements, and growing teams that need to onboard new developers effectively.

主要功能

01Deep trade-off analysis of rejected alternatives

02Honest assessment of positive and negative architectural consequences

030 GitHub stars

04Support for sequential thinking to ensure thorough documentation

05Guided capture of technical constraints and system context

06Standardized ADR template generation with sequential numbering

使用场景

01Documenting the choice of a specific database or messaging queue over alternatives

02Recording the rationale for migrating from a monolithic architecture to microservices

03Formalizing API design decisions and contract changes for team alignment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add newkayak12/claude-skills adr-writer

For use in Claude.ai and ChatGPT

主要功能

01Deep trade-off analysis of rejected alternatives

02Honest assessment of positive and negative architectural consequences

030 GitHub stars

04Support for sequential thinking to ensure thorough documentation

05Guided capture of technical constraints and system context

06Standardized ADR template generation with sequential numbering

使用场景

01Documenting the choice of a specific database or messaging queue over alternatives

02Recording the rationale for migrating from a monolithic architecture to microservices

03Formalizing API design decisions and contract changes for team alignment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add newkayak12/claude-skills adr-writer

For use in Claude.ai and ChatGPT