architecture-decision-record

Installation
SKILL.md

Architecture Decision Record

Overview

Architecture Decision Records (ADRs) are lightweight documents that capture important architectural decisions along with their context and consequences. This skill provides templates, examples, and best practices for creating and maintaining ADRs in your projects.

When to use this skill:

  • Making significant technology choices (databases, frameworks, cloud providers)
  • Designing system architecture or major components
  • Establishing patterns or conventions for the team
  • Evaluating trade-offs between multiple approaches
  • Documenting decisions that will impact future development

Why ADRs Matter

ADRs serve as architectural memory for your team:

  • Context Preservation: Capture why decisions were made, not just what was decided
  • Onboarding: Help new team members understand architectural rationale
  • Prevent Revisiting: Avoid endless debates about settled decisions
Related skills

More from ariegoldkin/ai-agent-hub

Installs
14
GitHub Stars
8
First Seen
Jan 24, 2026