skills.rest
sougetuOte
sougetuOteCOMMUNITY
Explore all skills by this author →
GitHub

adr-template

Generate standardized Architecture Decision Records with a structured template.

3|Updated Nov 20, 2025
Search Tags:#template#architecture#decision making#documentation#adr#technical debt
One-click install
npx skills add https://github.com/sougetuOte/LivingArchitectModel --skill adr-template-sougetuote
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-template
Source: https://github.com/sougetuOte/LivingArchitectModel/tree/main/.claude/skills/adr-template
Command: npx skills add https://github.com/sougetuOte/LivingArchitectModel --skill adr-template-sougetuote

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the creation of Architecture Decision Records (ADRs) by providing a standardized template that incorporates a multi-perspective analysis, ensuring comprehensive and well-reasoned architectural choices.

Core Features & Use Cases

  • ADR Templating: Generates ADRs with a predefined structure, including sections for context, options, 3-agent analysis, decision, and impact.
  • 3 Agents Model Integration: Guides the user to consider affirmative, critical, and mediator perspectives for robust decision-making.
  • Use Case: When making a significant technical choice, like selecting a new database technology, use this skill to generate an ADR that systematically documents the background, evaluated options, potential risks and benefits from different viewpoints, and the final decision with its rationale.

Quick Start

Create a new ADR for the decision on the database selection.

Frequently Asked Questions about adr-template

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

FAQPage Schema
What is an Architecture Decision Record and when do I need one?▼

An Architecture Decision Record (ADR) captures the context, options, and rationale behind a significant technical selection, like choosing a new database. You need an ADR to prevent technical debt and ensure architectural choices are systematically documented.

How do I create an Architecture Decision Record for a database selection?▼

To create an Architecture Decision Record, generate a standardized template that structures your context, options analysis, multi-perspective review, the final decision, and an impact assessment for your database selection.

How does the 3-Agents Model work in architectural decision making?▼

The 3-Agents Model enforces robust architectural decision making by guiding you to review technical selections from three distinct perspectives: Affirmative, Critical, and Mediator, ensuring well-reasoned and comprehensive choices.

What sections should I include in an Architecture Decision Record template?▼

An Architecture Decision Record template should include sections for context, options analysis, a 3-Agents Model review, the final decision, and an impact assessment to align with standard internal decision-making protocols.

Does the ADR template require any specific dependencies or frameworks?▼

No specific dependencies or frameworks are required to use the ADR template. It operates independently to generate standardized documentation for architectural choices and technical selections.

What is the best way to document technical debt and design decisions?▼

The best way to document technical debt and design decisions is using a standardized Architecture Decision Record template that forces you to evaluate options and assess the impact of architectural choices before finalizing them.

Related Skills

Explore More Software Engineering Skills→
ejoongseokejoongseok
8

adr

Generate structured Architecture Decision Records with context, alternatives, and impacts.

Community
Intermediate
roanbrasilroanbrasil
5

technical-debt

Identify and classify technical debt using the Cunningham/Fowler quadrant.

Community
Advanced
aydinsenturkkaydinsenturkk
3

sw-generate-knowledge

Generate formatted markdown knowledge files from official and community documentation.

Community
Advanced
TheycallmehollaTheycallmeholla

connotation-cop

Audit terminology against a CONTEXT.md glossary and enforce ADR documentation.

Community
Intermediate