Summary
One sentence describing the architectural decision to be made.
Context
Two–three sentences explaining why this decision is needed, what it affects, or what problem it resolves.
What to do
- Check relevant context (existing ADRs or related discussions)
- Identify the gap or decision that needs to be formalized
- Propose the decision and outline alternatives (if any)
- Write the ADR using the official ADR template
- Open a PR with the new ADR and request review
- Address reviewer feedback
Definition of Done
- All steps completed and decision clearly articulated
- ADR written using the ADR template
- ADR reviewed and merged
Summary
One sentence describing the architectural decision to be made.
Context
Two–three sentences explaining why this decision is needed, what it affects, or what problem it resolves.
What to do
Definition of Done