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.