skills.rest
angryconsultant
angryconsultantCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

create-architectural-decision-record

Generate standardized Architectural Decision Records from required inputs.

Updated Mar 18, 2026
Search Tags:#templates#documentation#adr#software-architecture#stakeholders#architectural-decision-record
One-click install
npx skills add https://github.com/angryconsultant/Copilot-CLI --skill create-architectural-decision-record-angryconsultant
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-architectural-decision-record
Source: https://github.com/angryconsultant/Copilot-CLI/tree/main/skills/create-architectural-decision-record
Command: npx skills add https://github.com/angryconsultant/Copilot-CLI --skill create-architectural-decision-record-angryconsultant

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADR documentation is often inconsistent and time-consuming. This skill generates a properly formatted Architectural Decision Record (ADR) based on AI-assisted inputs, ensuring a consistent record of architectural choices and rationale.

Core Features & Use Cases

  • Standardized front matter with a template and consistent ADR structure
  • Generates ADRs from inputs: DecisionTitle, Context, Decision, Alternatives, Stakeholders
  • Automatically saves ADRs to the docs/adr directory with a clear, sequential filename

Quick Start

Provide the ADR inputs (DecisionTitle, Context, Decision, Alternatives, Stakeholders) to generate a formatted ADR document and save it to the docs/adr directory.

Frequently Asked Questions about create-architectural-decision-record

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

FAQPage Schema
What is an Architectural Decision Record and why do I need one?▼

An Architectural Decision Record (ADR) captures software architecture choices and their rationale. You need ADRs to maintain consistent documentation of trade-offs, stakeholders, and governance workflows across software and AI-enabled projects.

How do I generate an Architectural Decision Record automatically?▼

To generate an Architectural Decision Record automatically, provide the required inputs: DecisionTitle, Context, Decision, Alternatives, and Stakeholders. The skill outputs a formatted ADR document saved to the docs/adr directory.

Does this ADR generator work for AI-enabled systems and governance workflows?▼

Yes, this ADR generator works for AI-enabled systems and governance workflows. It precisely records decisions, trade-offs, and stakeholders in a standardized, machine-readable format suitable for automated architecture governance pipelines.

Where are generated Architectural Decision Records saved?▼

Generated Architectural Decision Records are saved to the docs/adr directory. The skill automatically creates a clear, sequential filename for each ADR document to maintain chronological order across software architecture projects.

What is the best way to standardize ADR documentation across architecture projects?▼

The best way to standardize ADR documentation is using a template with consistent front matter and section structure. This approach enforces required inputs like Context, Alternatives, and Stakeholders to produce repeatable, human-friendly ADRs.

Related Skills

Explore More Software Engineering Skills→
jtvarisjtvaris

architecture-decision

Generate Architecture Decision Records with context, constraints, and alternatives.

Community
Intermediate
VitaDynamicsVitaDynamics

adr

Create sequentially numbered Architecture Decision Records in docs/adr/.

Official
Intermediate
tamago0224tamago0224

create-architectural-decision-record

Generate standardized Architectural Decision Records in Markdown with front matter and structured sections.

Community
Advanced
HermeticOrmusHermeticOrmus

ADR Templates

Generate Markdown-based ADRs using MADR and Y-Statement templates.

Community
Basic