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

•

Aprendizaje y Documentación

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

Acerca de

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.

Características Principales

Manages the ADR lifecycle from proposal to implementation and supersession.
29 GitHub stars
Captures technical context, business constraints, and long-term consequences.
Supports Git-based documentation workflows for version-controlled architecture.
Facilitates structured tradeoff analysis and documentation of alternatives.
Provides standardized Nygard-format templates for architectural consistency.

Casos de Uso

Establishing architectural patterns and coding conventions for a development team.
Documenting the selection of a new database or backend framework for a project.
Recording 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

GitHub