Design Decision Schema Checklist
Use this checklist when documenting a design decision so it’s reusable and auditable.
- Context - What problem or question does this decision address?
- Options considered - What alternatives did you evaluate (including “do nothing”)?
- Decision - What did you choose? State it clearly.
- Rationale - Why this option over the others?
- Constraints - When does this apply? When does it not apply?
- Outcomes - How will you know it worked? What might you measure or observe?
- Ownership - Who is responsible for revisiting or updating this decision?
- Links - Related decisions, components, or docs.
Not every decision needs every field. Use the ones that reduce ambiguity and make the decision easier to find and apply later.