What format does this ADR skill use?

This skill follows the industry-standard Nygard format, which includes specific sections for Title, Status, Context, Decision, Consequences, and Alternatives Considered.

Does it help with tradeoff analysis?

Yes, it specifically prompts for at least two alternatives and requires documenting the consequences (positive, negative, and neutral) of the chosen path.

Why should I use ADRs in my project?

ADRs preserve architectural memory, help with team onboarding, and provide a clear history of why certain technical paths were chosen over others.

Can I store these records in my repository?

The skill is designed to work with Git-based workflows, recommending that ADRs be stored as Markdown files within your project's version control.

Does the skill manage the decision lifecycle?

Yes, it supports statuses such as Proposed, Accepted, Rejected, Deprecated, and Superseded, ensuring the current state of any decision is clear.

Architecture Decision Record (ADR)

Name: Architecture Decision Record (ADR)
Author: yonatangross

byyonatangross

•

Learning & Documentation

Generates and manages standardized Architecture Decision Records to document technical choices and their rationale using the Nygard format.

The Architecture Decision Record (ADR) skill enables Claude to facilitate structured technical documentation by capturing the 'why' behind significant design choices. By implementing the industry-standard Nygard format, this skill helps engineering teams preserve architectural memory, streamline developer onboarding, and prevent the revisiting of settled debates. It provides comprehensive templates and workflows for documenting context, analyzing trade-offs, and tracking the lifecycle of decisions from proposal through implementation and eventual supersession.

Key Features

01Manages the ADR lifecycle from proposal to implementation and supersession.

0229 GitHub stars

03Captures technical context, business constraints, and long-term consequences.

04Supports Git-based documentation workflows for version-controlled architecture.

05Facilitates structured tradeoff analysis and documentation of alternatives.

06Provides standardized Nygard-format templates for architectural consistency.

Use Cases

01Establishing architectural patterns and coding conventions for a development team.

02Documenting the selection of a new database or backend framework for a project.

03Recording the rationale for system migrations or major infrastructure changes.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yonatangross/skillforge-claude-plugin architecture-decision-record

For use in Claude.ai and ChatGPT

Download Skill