Purpose
Verify that an architectural decision or proposal is complete, well-documented and ready for review.
Pre-Review
- ADR or RFC is drafted with clear context and decision.
- Problem statement is clearly defined.
- Alternatives have been identified and evaluated.
- Trade-offs are documented.
- Quality attributes are addressed.
- Architecture diagrams are current (C4 model).
- Relevant stakeholders have been identified.
- Review materials distributed at least 2 days in advance.
During Review
- Problem is correctly understood.
- Proposal is consistent with architecture principles.
- Quality attribute trade-offs are acknowledged.
- Alternatives were meaningfully evaluated.
- Consequences (positive and negative) are understood.
- Risks are identified and mitigated.
- Proposal supports incremental implementation.
- Security and compliance implications addressed.
Post-Review
- Review outcome is documented.
- ADR or RFC is updated with review decisions.
- Conditions or action items are tracked.
- Decision log is updated.
- Follow-up milestones are scheduled.