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.