Create Adr

This skill provides guidance for creating well-structured Architecture Decision Records.

Structure:

An ADR documents a single architectural decision using the following sections:

• Title — A concise, descriptive title summarizing the decision (not the problem)
• Supersedes — Reference to any ADR this decision replaces
• Context — The forces at play that motivate the decision
• Decision — The change being proposed or adopted
• Alternatives Considered — Options that were evaluated but rejected
• Consequences — Positive, negative, and neutral outcomes

DO:

• Frame the context as the problem or situation that motivates the decision
• State the decision using active voice: "We will..."
• List alternatives that were genuinely considered, with brief rationale for rejection
• Include positive, negative, and neutral consequences — every decision has trade-offs
• Use a descriptive title that summarizes the decision (not the problem)
• Keep language concise and factual
• Reference related ADRs when decisions build on or supersede previous ones