architecture-decision-records

Generate Architecture Decision Records with templates for context, options, consequences, and status.

Updated Jan 16, 2026
One-click install
npx skills add https://github.com/cornmanwtf/ABANG-COLEK --skill architecture-decision-records-cornmanwtf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/cornmanwtf/ABANG-COLEK/tree/main/skills/documentation-knowledge/architecture-decision-records
Command: npx skills add https://github.com/cornmanwtf/ABANG-COLEK --skill architecture-decision-records-cornmanwtf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework for documenting architectural decisions, ensuring clarity, traceability, and consistency in system design.

Core Features & Use Cases

  • ADR Templates: Offers standardized templates for capturing decision context, rationale, and consequences.
  • Decision Tracking: Facilitates the recording and management of architectural choices over time.
  • Use Case: When deciding on a new database technology, use this Skill to generate an ADR that outlines the problem, evaluates alternatives, and documents the chosen solution and its implications.

Quick Start

Use the architecture-decision-records skill to create a new ADR for a database migration.

Frequently Asked Questions about architecture-decision-records

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

FAQPage Schema
How do I document architectural decisions for a database migration?▼

To document architectural decisions for a database migration, you generate an Architecture Decision Record outlining the problem, evaluating alternatives, and detailing the chosen solution and its implications. This provides a structured framework for capturing decision context, rationale, and consequences.

How do I create an ADR to track system design choices over time?▼

You create an ADR by generating a standardized template to capture decision context, rationale, and consequences. This facilitates decision tracking by maintaining a clear audit trail of your architectural choices over time, supporting compliance and governance requirements.

What should I include in an architecture decision record template?▼

An architecture decision record template should include structured sections for decision context, available options, consequences, and status. Capturing this rationale ensures traceability and consistency in your system design evolution and provides a clear audit trail for compliance.

Can I use an ADR for compliance and governance tracking?▼

Yes, you can use an ADR for compliance and governance tracking because it maintains a clear audit trail of system design evolution. By documenting significant architectural choices and their consequences, it facilitates compliance and ensures traceability of decision rationale.

When should I write an architecture decision record instead of standard documentation?▼

You should write an architecture decision record instead of standard documentation when making significant architectural choices that require structured decision-making. ADRs specifically capture the context, alternatives, and consequences of system design decisions to ensure traceability and consistency.