Decision Record

Template Library

Decision Record

Record durable decisions with context, rationale, alternatives, consequences, evidence, AI disclosure, follow-up, and supersession.

Reusable Decision Decision Evidence

Library AreaTemplate Library

Current PageDecision Record

FocusDecision

UseDecision Evidence

Repository Areadocs/template-library/cross-cutting/

← Previous Repository Conventions

Current Decision Record

Next → Evidence Record

Template purpose

Use this template to record a decision that needs durable evidence but does not fit a more specific stage-owned decision artifact.

Decision ID

DR-000

Title

<Decision title>

Document control

Field	Value
Status	<proposed / accepted / rejected / superseded / deferred>
Date	<YYYY-MM-DD>
Owner	<owner>
Reviewers	<reviewers>
Related Stage	<ES-### or cross-cutting>
Project workspace target	docs/project-workspace/shared/decision_record.md

Context

<What situation, problem, constraint, opportunity, risk, or tradeoff led to this decision?>

Decision

<What decision was made?>

Rationale

<Why was this decision made?>

Decision drivers

Driver	Source	Importance
<driver>	<requirement / risk / constraint / evidence / stakeholder>	<high / medium / low>

Alternatives considered

Alternative	Advantages	Reason Not Chosen
<alternative>	<advantages>	<reason>

Consequences

Positive

• <positive consequence>

Negative / tradeoffs

• <negative consequence or tradeoff>

Evidence

Evidence	Location / Source	Notes
<evidence>	<path/source>	<notes>

AI assistance disclosure

Question	Answer
Was AI used to help form, draft, evaluate, or document this decision?	<yes / no>
What human verification was performed?	<verification>
What AI-use evidence was preserved?	<evidence or not applicable>

Follow-up

Follow-up	Owner	Due / Trigger	Status
<follow-up action>	<owner>	<due/trigger>	<open / closed / deferred>

Supersession

Field	Value
Supersedes	<DR-ID or none>
Superseded By	<DR-ID or none>

Review checklist

• [ ] Context is clear.
• [ ] Decision is explicit.
• [ ] Rationale is evidence-based.
• [ ] Alternatives and tradeoffs are recorded.
• [ ] Evidence is linked.
• [ ] Follow-up is assigned.
• [ ] Supersession is supported where relevant.

Continue to Evidence Record

Proceed to the next cross-cutting engineering artifact.

Open Evidence Record →