What problem does it solves?
Inconsistent or missing documentation for critical architectural decisions leads to confusion, technical debt, and difficulty onboarding new team members. This skill provides a structured template and guide to ensure all decisions are well-documented.
Core Features & Use Cases
- Standardized Template: Provides a comprehensive Markdown template for Architecture Decision Records (ADRs).
- Decision Tracking: Guides through documenting context, options, evaluation, rationale, and consequences of architectural choices.
- Workflow Integration: Outlines a workflow for ADR creation, review, and integration into project plans.
- Use Case: When a major technical decision needs to be made (e.g., choosing a database or a backend framework), use this skill to generate a structured ADR document, ensuring all aspects are considered, evaluated, and documented for future reference and team alignment.
Quick Start
Use the adr-template skill to create a new Architecture Decision Record for choosing a backend framework.