Design system thất bại ở handoff khi token mơ hồ và API component chấp nhận vô hạn variant. Chúng tôi định nghĩa semantic token trước — surface, border, accent — rồi map màu brand vào lớp đó.
API component có một primary action mỗi surface. Secondary action là prop rõ ràng, không phải override style. Ràng buộc đó giữ Figma và code đồng bộ khi ba squad ship song song.
Tài liệu là phần định nghĩa component: do/don’t, ghi chú accessibility và screenshot responsive behavior ship cùng mỗi merge.
Governance nhẹ: review 30 phút hàng tuần cho pattern mới, changelog trong repo, và Storybook là hợp đồng giữa design và engineering.
Drift bị bắt sớm khi designer và engineer pair trên consumer đầu tiên của mọi primitive mới.
