Does this skill support the MADR format?

Yes, it includes a detailed template for the Markdown Architectural Decision Records (MADR) format, which covers context, considered options, and specific pros/cons for each.

An Architecture Decision Record (ADR) is a short text file that captures a significant architectural decision made during a project, including the context in which it was made and the consequences it has for the future.

When should I write an ADR versus just a comment?

Use an ADR for significant choices like framework adoption, database selection, or security patterns. For minor implementation details or bug fixes, standard code comments are sufficient.

How do I manage the ADR lifecycle?

The skill provides a workflow for moving records through various statuses, such as Proposed, Accepted, Deprecated, and Superseded, ensuring the documentation reflects the current state of the architecture.

Architecture Decision Records (ADR)

Name: Architecture Decision Records (ADR)
Author: sickn33

bysickn33

•

31,721

•

Herramientas de Colaboración

Standardizes the creation and management of Architecture Decision Records to capture technical rationale and long-term consequences.

This skill provides comprehensive patterns and templates for managing Architecture Decision Records (ADRs), enabling teams to document the context, drivers, and trade-offs behind significant technical choices. By integrating structured decision-making into the development workflow, it ensures that historical context is preserved for future onboarding and audits, while providing multiple templates ranging from lightweight Y-statements to full MADR formats and RFC-style proposals.

Características Principales

01Structured guidance on documenting decision drivers and trade-off analysis

02Standardized directory structures for organized documentation management

0331,721 GitHub stars

04Multi-format templates including MADR, Lightweight, and Y-Statement styles

05Comprehensive ADR lifecycle tracking (Proposed, Accepted, Superseded, Rejected)

06Workflow integration with adr-tools for automated indexing and linking

Casos de Uso

01Streamlining team onboarding by providing a searchable history of architectural trade-offs

02Documenting the selection of a primary database or backend framework

03Recording the rationale and migration plan for deprecating legacy services

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sickn33/antigravity-awesome-skills architecture-decision-records

For use in Claude.ai and ChatGPT

Características Principales

01Structured guidance on documenting decision drivers and trade-off analysis

02Standardized directory structures for organized documentation management

0331,721 GitHub stars

04Multi-format templates including MADR, Lightweight, and Y-Statement styles

05Comprehensive ADR lifecycle tracking (Proposed, Accepted, Superseded, Rejected)

06Workflow integration with adr-tools for automated indexing and linking

Casos de Uso

01Streamlining team onboarding by providing a searchable history of architectural trade-offs

02Documenting the selection of a primary database or backend framework

03Recording the rationale and migration plan for deprecating legacy services

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sickn33/antigravity-awesome-skills architecture-decision-records

For use in Claude.ai and ChatGPT