디자인 시스템 다시 생각해보기

토스 TDS는 제품팀이 컴포넌트를 detach하거나 패키지를 fork하는 현상을 시스템 위반이 아니라, 디자인 시스템이 수요를 충분히 해결하지 못한다는 신호로 바라봤습니다. 통제와 금지를 강화하기보다 우회할 이유를 줄이기 위해 컴포넌트 API를 재검토했고, Flat 패턴의 간결함과 Compound 패턴의 확장성을 각각의 장단점과 함께 비교했습니다. 이에 단순하고 자주 쓰는 경우에는 Flat API를, 복잡하거나 커스텀이 필요한 경우에는 Compound API를 제공하는 하이브리드 전략을 택했습니다. 두 API는 공통 primitive를 재사용해 구현을 공유하며, 디자인 시스템은 팀을 제한하기보다 예외 상황까지 지원해야 한다는 점을 강조합니다.

• 시스템을 우회하는 팀을 탓하기보다, 우회가 필요한 이유를 찾아 API와 제공 범위를 개선하세요.
• Flat API는 흔한 사용 사례를 간결하게 만들지만, 예외가 늘면 props가 비대해질 수 있습니다.
• Compound API는 조합을 통한 확장성이 높지만, 사용자가 구조와 조합 규칙을 익혀야 합니다.
• 단순한 사례에는 Flat, 복잡하거나 변형이 잦은 사례에는 Compound를 제공하는 하이브리드 전략을 고려하세요.
• 두 API의 내부 구현이 같은 primitive를 재사용하면 외부 선택지를 늘리면서 유지보수 부담을 줄일 수 있습니다.