When should I use an ADR instead of a regular comment?

Use an ADR for significant, hard-to-reverse decisions like framework adoption or database choices. Routine implementation details and bug fixes do not require an ADR.

Which ADR formats does this skill support?

This skill supports several industry-standard formats including MADR (Markdown Architecture Decision Records), Lightweight ADRs, and Y-Statements.

How do ADRs help with team collaboration?

ADRs serve as a source of truth for the 'why' behind a system, reducing friction during code reviews and providing clear context for new developers joining the project.

What is an Architecture Decision Record (ADR)?

An ADR is a short document that captures a significant architectural decision, the context in which it was made, and the consequences it has for the project.

Can I track the status of a decision over time?

Yes, the skill manages the full lifecycle of a decision, allowing you to mark records as Proposed, Accepted, Rejected, Deprecated, or Superseded by newer records.

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: pur3v4d3r

bypur3v4d3r

•

Aprendizaje y Documentación

Creates and maintains structured Architecture Decision Records to document technical choices, trade-offs, and design rationale.

Acerca de

The Architecture Decision Records skill provides a comprehensive framework for capturing the 'why' behind significant technical choices. It offers a variety of standardized templates—including MADR, Lightweight, and Y-Statement formats—to help development teams record context, considered options, and long-term consequences. By treating knowledge as code, this skill ensures that architectural history remains accessible for onboarding, auditing, and future refactoring, preventing the loss of critical institutional knowledge as a project evolves.

Características Principales

Comprehensive review checklists for architectural governance
Automated ADR indexing and directory structure guidelines
Standardized ADR templates (MADR, Lightweight, and Y-Statement)
Structured RFC (Request for Comments) generation for technical proposals
1 GitHub stars
Decision lifecycle management (Proposed, Accepted, Superseded, Deprecated)

Casos de Uso

Documenting the selection of core technologies like databases or frameworks
Managing the deprecation and migration process between legacy and modern systems
Onboarding new team members by providing a historical record of design choices

Acerca de

Características Principales

Comprehensive review checklists for architectural governance
Automated ADR indexing and directory structure guidelines
Standardized ADR templates (MADR, Lightweight, and Y-Statement)
Structured RFC (Request for Comments) generation for technical proposals
1 GitHub stars
Decision lifecycle management (Proposed, Accepted, Superseded, Deprecated)

Casos de Uso

Documenting the selection of core technologies like databases or frameworks
Managing the deprecation and migration process between legacy and modern systems
Onboarding new team members by providing a historical record of design choices