adr-architecture

Document architectural decisions using the Architecture Decision Record format.

142|20|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/lyndonkl/claude --skill adr-architecture-lyndonkl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-architecture
Source: https://github.com/lyndonkl/claude/tree/main/skills/adr-architecture
Command: npx skills add https://github.com/lyndonkl/claude --skill adr-architecture-lyndonkl

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you systematically document significant architectural and technical decisions, ensuring that the context, rationale, and consequences are clearly recorded for future reference.

Core Features & Use Cases

  • Decision Recording: Capture context, decision, alternatives, and consequences for architectural choices.
  • Standardized Format: Utilizes a structured template for consistent documentation.
  • Quality Assurance: Provides a rubric for evaluating the quality of Architecture Decision Records (ADRs).
  • Use Case: When your team needs to choose between two cloud database solutions, use this Skill to create an ADR that details the pros and cons of each, the final decision, and the expected impact.

Quick Start

Use the adr-architecture skill to create a new Architecture Decision Record for choosing a new API gateway.

Frequently Asked Questions about adr-architecture

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?

To document architecture decisions, capture the context, alternatives considered, the final decision rationale, and expected consequences using a standardized ADR template. This ensures your team consistently logs technology choices and infrastructure decisions for future reference.

How do I evaluate the quality of my architecture documentation?

Yes, you can use an ADR to document cloud database decisions by detailing the pros and cons of each solution, the final choice, and the expected impact. This structured decision recording format scales effectively for both infrastructure decisions and technology choices.

Does using ADRs help manage technical debt?

Yes, using ADRs helps manage technical debt by ensuring the context and rationale behind software design choices are clearly recorded. This prevents repeated discussions and provides clear documentation of why specific technical standards were established.

What's the best way to record alternatives considered during software design?

The best way to record alternatives is by using a structured ADR format that explicitly documents the context, decision rationale, alternatives considered, and consequences. This standardized template ensures comprehensive decision logging for your architecture choices.