Design Review
Trigger Boundary
- •Use when a design artifact is ready for formal review before implementation or release.
- •Do not use for creating principles from scratch; use
design-principles. - •Do not use for designing accessibility remediation plans; use
accessibility-design.
Goal
Identify design risks early and provide concrete, reviewable fixes.
Shared Design Contract (Canonical)
- •Use
../design-principles/references/design-governance-contract.mdas the single schema and gate source. - •Validate IDs, lifecycle states, and approval requirements against this contract.
- •Run machine validation:
python3 ../design-principles/scripts/validate_design_contract.py --manifest <path/to/manifest.json>.
Inputs
- •Design artifact and review scope
- •Relevant flow IDs and spec IDs
- •Accessibility and localization constraints
Outputs
- •
DREV-*findings list with severity and owner - •Approval decision with blockers and conditions
- •Follow-up action log with due dates
Workflow
- •Confirm review scope and acceptance criteria.
- •Check usability, consistency, and implementation feasibility.
- •Verify accessibility gate status using existing
A11Y-CHK-*results. - •Record findings with severity, owner, and remediation path.
- •Conclude approval or rejection with explicit rationale.
Quality Gates
- •Findings are evidence-based and reproducible.
- •Blockers are clearly separated from improvements.
- •Required approvers are assigned and traceable.
- •Contract validation passes for IDs and gates.
Failure Handling
- •Stop review when scope or artifact is ambiguous.
- •Stop release recommendation when blocker findings remain unresolved.