Short title of the decision
ADR-NNNN: Short title of the decision
Section titled “ADR-NNNN: Short title of the decision”Status
Section titled “Status”Proposed
Context
Section titled “Context”Background and Problem Statement
Section titled “Background and Problem Statement”Describe the context and the problem that motivates this decision. What forces are in play, and what question are we answering? Link to the repo files that ground the decision.
Current Limitations
Section titled “Current Limitations”Describe what the current state cannot do, or what defect this decision exists to remove.
Decision Drivers
Section titled “Decision Drivers”Primary Decision Drivers
Section titled “Primary Decision Drivers”- The most important force or constraint.
- The second most important force.
Secondary Decision Drivers
Section titled “Secondary Decision Drivers”- A supporting consideration.
- Another supporting consideration.
Considered Options
Section titled “Considered Options”Option 1: Name of the first option
Section titled “Option 1: Name of the first option”Description: One paragraph describing the option.
- Advantages: What this option does well.
- Disadvantages: Where this option falls short.
- Risk Assessment: technical low; schedule low; ecosystem low.
Option 2: Name of the second option
Section titled “Option 2: Name of the second option”Description: One paragraph describing the option.
- Advantages: What this option does well.
- Disadvantages: Where this option falls short.
- Risk Assessment: technical medium; schedule low; ecosystem medium.
Decision
Section titled “Decision”State the chosen option in one sentence, then describe how it is realized, citing the real files that implement it.
Consequences
Section titled “Consequences”Positive
Section titled “Positive”- A good outcome of this decision.
Negative
Section titled “Negative”- A cost or downside of this decision.
Neutral
Section titled “Neutral”- A trade-off that is neither clearly good nor bad.
Decision Outcome
Section titled “Decision Outcome”Summarize what the decision achieves and how the negatives are mitigated.
Related Decisions
Section titled “Related Decisions”- Link each related ADR by its
NNNN-kebab.mdfilename (one bullet per related decision).
More Information
Section titled “More Information”- Date: YYYY-MM-DD
- Source:
path/to/grounding-file
YYYY-MM-DD
Section titled “YYYY-MM-DD”Status: Pending
| Finding | Files | Assessment |
|---|---|---|
| What was checked | path/to/file | compliant / pending |
Summary: One-line summary of the audit result.
Action Required: None