skills.rest
gtonic
gtonicCOMMUNITY
Explore all skills by this author →
GitHub

architecture-decision-record

Create and evaluate Architecture Decision Records using the MADR template.

3|1|Updated Feb 26, 2026
Search Tags:#decision making#documentation#adr#technical debt#architecture decision record#madre
One-click install
npx skills add https://github.com/gtonic/ea-skills --skill architecture-decision-record-gtonic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision-record
Source: https://github.com/gtonic/ea-skills/tree/main/.skills/architecture-decision-record
Command: npx skills add https://github.com/gtonic/ea-skills --skill architecture-decision-record-gtonic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation, evaluation, and management of Architecture Decision Records (ADRs), ensuring that crucial architectural choices are well-documented, justifiable, and consistent.

Core Features & Use Cases

  • Structured ADR Creation: Generates ADRs following the MADR template, including context, drivers, options, and consequences.
  • Options Evaluation: Supports methods like Weighted Scoring and Utility Trees for comparing architectural options.
  • Consistency Checks: Identifies potential conflicts with existing ADRs in the repository.
  • Use Case: When deciding on a new database technology, use this Skill to document the decision process, evaluate PostgreSQL vs. MongoDB, and ensure the choice aligns with existing architectural principles.

Quick Start

Use the architecture decision record skill to create an ADR for choosing a new database.

Frequently Asked Questions about architecture-decision-record

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document architectural decisions to avoid technical debt?▼

Document architectural decisions by generating Architecture Decision Records (ADRs) using the MADR template to capture context, drivers, options, and consequences for traceable technical debt management.

What is the best way to evaluate architectural options like PostgreSQL vs MongoDB?▼

Evaluate architectural options like PostgreSQL vs MongoDB by applying Weighted Scoring or Utility Trees within an ADR to systematically assess and justify your technology choices.

How do I check if a new architecture decision conflicts with existing ones?▼

Check for architectural conflicts by running consistency checks against existing ADRs in your repository to ensure new decisions align with established architectural principles.

When do I need to create an Architecture Decision Record?▼

Create an Architecture Decision Record whenever you make a significant architectural choice, such as selecting a new database technology, to ensure the decision process is structured and justifiable.

Does the MADR template support weighted scoring for decision making?▼

Yes, the MADR template supports weighted scoring for decision making by allowing you to assess and compare architectural options using structured evaluation methods.

Related Skills

Explore More Software Engineering Skills→
rjschierjschie

adr

Automate Architecture Decision Record creation, indexing, and repository updates.

Community
Intermediate
SchurupIK72SchurupIK72

commit-helper

Enforce Conventional Commits and atomic change limits in git workflows.

Community
Advanced
Imad-OuteImad-Oute
2

mh-cto-sdlc-tech-retro

Evaluate architectural decisions against production outcomes to update ADRs and catalog technical debt.

Community
Advanced
baotoqbaotoq
98

architecture-decision-records

Capture and manage architectural decisions with standardized ADR templates.

Community
Intermediate