create-architectural-decision-record

Installation
Summary

Structured Architectural Decision Record generator with AI-optimized formatting and sequential file management.

  • Generates standardized ADR documents with front matter, context, decision rationale, and consequences organized into positive and negative outcomes
  • Requires four inputs (decision title, context, decision, alternatives, stakeholders) with validation to prompt for missing information before generation
  • Uses coded bullet-point system (3-4 letter codes + 3-digit numbers) across consequences, alternatives, implementation notes, and references for machine parsing
  • Automatically saves documents to /docs/adr/ directory with sequential naming convention (adr-NNNN-[title-slug].md) and enforces standardized markdown structure with YAML front matter
SKILL.md

Create Architectural Decision Record

Create an ADR document for ${input:DecisionTitle} using structured formatting optimized for AI consumption and human readability.

Inputs

  • Context: ${input:Context}
  • Decision: ${input:Decision}
  • Alternatives: ${input:Alternatives}
  • Stakeholders: ${input:Stakeholders}

Input Validation

If any of the required inputs are not provided or cannot be determined from the conversation history, ask the user to provide the missing information before proceeding with ADR generation.

Requirements

  • Use precise, unambiguous language
  • Follow standardized ADR format with front matter
  • Include both positive and negative consequences
Related skills

More from github/awesome-copilot

Installs
9.0K
GitHub Stars
32.8K
First Seen
Feb 25, 2026