create-architectural-decision-record

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

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