When should I use this skill to create a new ADR?

Use it whenever you make a decision that is difficult to reverse, such as choosing a database, defining API standards, or establishing deployment strategies.

Can Claude help me fill out the ADR template?

Yes, by providing the project context, Claude can use this skill to draft the ADR, including evaluating alternatives and identifying potential risks and mitigations.

How does this skill improve team collaboration?

By providing a consistent template and central repository for decisions, it ensures all team members understand the logic behind the architecture, reducing friction during code reviews and planning.

What is an Architecture Decision Record (ADR)?

An ADR is a short text document that captures a significant architectural decision, including the context of the problem, the chosen solution, and the resulting consequences and trade-offs.

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: bradtaylorsf

bybradtaylorsf

•

Aprendizaje y Documentación

Standardizes the documentation of technical decisions using structured Architecture Decision Records (ADR) and proven patterns.

The Architecture Decision Records skill provides a robust framework for capturing the 'why' behind technical choices throughout a project's lifecycle. It includes standardized Markdown templates to document context, constraints, decisions, and both positive and negative consequences, ensuring that architectural trade-offs are transparent and searchable. With predefined patterns for common scenarios like database selection and API design, plus a clear lifecycle management system (Proposed, Accepted, Superseded), this skill helps engineering teams maintain high-quality documentation that facilitates onboarding and prevents the repetition of past mistakes.

Características Principales

01Standardized ADR Markdown template with context and consequence tracking

02Pre-defined patterns for databases, API design, and authentication systems

03Integration-ready for system architect and technical lead agent workflows

046 GitHub stars

05Structured directory and index README organization for easy navigation

06Decision lifecycle management including Proposed, Accepted, and Superseded states

Casos de Uso

01Formalizing the evaluation of competing third-party services like Auth0 vs Keycloak

02Documenting the rationale behind significant technology stack changes or migrations

03Creating a historical record of architectural trade-offs for onboarding new team members

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bradtaylorsf/alphaagent-team architecture-decisions

For use in Claude.ai and ChatGPT

Download Skill