베지어 다시 짓기 (1) : 사람과 AI를 위한 디자인 시스템
먼저, 기조와 정책 세우기
River ⛵️ • Product Designer @Meet Team
- Design / PM
디자인 시스템, 잘 관리되고 있나요?
요즘, 모두가 AI-네이티브 제품 개발을 이야기합니다. 그런데 정작 성공담은 잘 안 들려요. 왤까요? 목적지는 명확하지만, 거기까지 '어떻게' 가느냐에서 어려움을 겪는 팀이 많기 때문일 거에요. 그리고 아마 대표적인 걸림돌 중 하나가 '잘 정비된 디자인 시스템'일 겁니다.
디자인 시스템이 아직 없거나, 구축하던 도중에 다른 급한 업무가 생겨 중단되거나, 몇 번의 구축 및 차세대 시도를 거쳐 여러 버전의 라이브러리가 뒤섞여 있거나, 담당자가 없어서 운영 및 관리가 제대로 이루어지지 않는 등... 여러분의 상황은 어떠신가요?
채널팀의 디자인 시스템인 '베지어(Bezier)' 역시 몇 가지 문제를 겪고 있었습니다.
첫 번째로, "어느 컴포넌트를 언제, 어떤 상황에 써야 하는가"를 알기 어려웠어요.
UX 패턴이나 컴포넌트 사용 가이드가 명확히 정의되어 있지 않았고, 매우 특정한 니즈에 의해 덧붙여진 것으로 추정되는 컴포넌트 스펙도 더러 존재했습니다. 그러니 만드는 사람에 따라 해석과 사용법이 미묘하게 달라졌어요. 사람도 정확히 판단하기 어려운 걸 AI가 알아서 잘 가져다 쓸 리가 없죠.
두 번째로, 디자이너들이 피그마 컴포넌트를 깨서(detach) 사용하는 빈도가 높았어요.
피그마의 기능적 제약으로 인한 사용성 부족, 개발 구현체와 피그마 컴포넌트의 괴리 등 원인은 여러가지였어요. 또, 가이드가 명확하지 않으니 컴포넌트를 용법에 어긋나게 쓰는 경우도 많았습니다. 때문에 개발자와 디자이너가 스펙을 재확인해야할 때가 잦았고, 이런 디자인 소스를 AI가 읽어가기 위한 비용도 어마어마했습니다.
위 문제로 인한 생산성 저하에 대해 제품팀 전체의 공감대가 점점 더 높아지던 중, '채널웍스 리디자인'이 본격적으로 시작되면서 베지어 리디자인 프로젝트도 급물살을 탔습니다.
베지어의 비전과 설계 원칙 3가지
디자인 시스템 만들기는 모든 의사결정이 동일한 철학을 따르도록 정렬하기 위한 지루한 싸움입니다. 그래서 저는 프로젝트를 시작할 때 먼저 기준선부터 협의하자고 제안했어요. 목적과 판단 기준이 명확하지 않으면 수많은 지점에서 끝도 없이 헤매게 된다는 것을 이전 경험을 통해 알고 있었기 때문이에요.
하나, Readable by Humans, Runnable by AI.
디자인 시스템의 사용자는 더 이상 사람만이 아니기 때문에, 'AI도 잘 사용할 수 있는가'가 관건이었어요. AI가 잘 사용하려면 직관적인 네이밍과 명확한 기준이 중요한데요. 결국 인간 입장에서의 가독성을 최대한 끌어올렸을 때 AI 활용도 역시 높아진다는 결론에 도달합니다.
둘, Extensible for Every Need.
채널팀의 과감하고 빠른 제품 개발 문화, 웹 기반의 다양한 기능 확장성 등의 사용 환경을 고려했을 때 디자인 시스템의 유연성은 중요한 포인트였어요. 제품이 성장하면서 디자인 시스템이 낙오되지 않으려면 확장의 여지를 미리 열어둘 필요가 있었습니다.
셋, Clear by Default.
라이브러리의 사용성이 쉽고 편해야한다는 것은 어찌보면 기본적인 가치인데요. 특히 예전에는 디자이너 또는 클라이언트 개발자가 담당하던 작업을 이제는 누구든 진행할 수 있다는 점을 고려했을 때 일정 품질 이상의 UI/UX가 보장되어야한다는 점이 한층 더 중요해졌습니다.
베지어 리디자인 프로젝트에 참여하는 디자이너, 프론트엔드 개발자, iOS 개발자, 안드로이드 개발자가 모두 모여서 이 대원칙을 확정했고, 협의된 설계 원칙에 따라 몇 가지의 작업 방식을 고안했어요.
모든 컴포넌트는 각자의 '기준 문서'를 가진다
이 컴포넌트의 사용 목적 정의, 컴포넌트 및 베리언트 선택 가이드, 사용 금지 기준, 프로퍼티별 사용 원칙 등 "언제, 어떻게 써야하는지" 판단하기 위한 모든 정보를 기준 문서에서 제공합니다. 각 컴포넌트와 기준 문서는 한 세트이기 때문에, 모든 작업자가 참조할 수 있도록 피그마 라이브러리의 모든 컴포넌트들에 각자의 spec.md 깃헙 링크를 컴포넌트 컨피그(configuration) 안에 넣어 두었어요.
예전같았으면 이 내용을 작성하기 위해 하나하나 리서치하고 스펙을 고민하면서 많은 시간을 들였겠지만 이번에는 AI를 활용해서 작업 시간을 대폭 단축할 수 있었어요. 먼저 우리 제품을 고려해 선정한 주요 레퍼런스들을 리서치해서 초안을 뽑아내고, 주요 쟁점에 대해 클로드 코드와 토론해서 수정하고, 필요 시 채널팀의 실제 레포지토리에서 이전 버전의 베지어(Bezier) 컴포넌트가 어떤 맥락으로 사용되었는지 조사해 검증하는 식으로 진행했어요.
기존 베지어 디자인 시스템은 아토믹 컴포넌트를 매우 자유롭게 조합해 사용하는 방식이었기 때문에 Select나 DropdownMenu 같은 부모 컴포넌트들이 정의되어있지 않았는데, 이번 리디자인을 통해 목적 및 기능에 따라 부모 컴포넌트를 사용하는 방식으로 전환하였기 때문에 기존 구성원들이 어떤 맥락에서 어떤 컴포넌트를 선택해서 어떻게 사용해야할지 가이드하는 목적으로도 이 문서들을 잘 활용하고 있습니다.
스펙은 자유롭게, 정책은 엄격하게
피그마 슬롯(Slot)을 도입하면서 '무엇이든 넣을 수 있는 자리'를 어떻게 제어할지 고민이었어요. 새로운 니즈가 생길 때마다 컴포넌트 스펙을 확장하는 것은 비효율적이기 때문에 개발 구현상으로는 자유 영역으로 두되, 정책과 피그마 컴포넌트로 제한하는 방식을 채택했어요. 예를 들어 Button의 leading 영역이 실제로는 슬롯이지만 레포 조사 결과 8~90%의 유즈케이스가 아이콘이라면, 피그마 컴포넌트에도 아이콘을 넣어두되 슬롯임을 뜻하는 네이밍을 적용하는 식이에요. 이러면 아이콘을 다른 UI로 바꿔치기(swap instance)하더라도 네이밍이 유지되어 개발/AI 가독성에 문제가 생기지 않습니다.
하지만 ListItem같은 컨테이너의 경우 이전과 미래의 모든 사용자 니즈를 유형화하기가 어려워서 고민이 좀 더 필요했는데요. 공통 규격 문서인 BaseItem.md에 각 슬롯별 목적(e.g. 'trailing 영역에는 숨겨질 수도 있는 부가 정보를 표현함')을 명확히 정의하고, 사용 가능한 UI의 특성(e.g. '이 영역에는 사용자와 인터랙션할 수 있는 UI를 사용할 수 없음' 등) 및 갯수를 가이드해서 모든 파생 컴포넌트가 이 내용을 우선적으로 따르도록 설정했습니다.
Base.md라는 공통 기준을 바탕으로 최종 사용될 부모 컴포넌트별 허용 스펙에 맞춰 전용 자식 컴포넌트를 만드는 방식에는 여러 가지 이점이 있는데요. 예전에는 피그마의 루트 컴포넌트가 하던 역할을 문서로 이관해 컴포넌트는 경량화하면서, 각각의 자식 컴포넌트는 동일 규격을 따르되 허용되는 UI만 제공하는 식으로 피그마 상에서의 라이브러리 통제력을 높일 수 있습니다.
이전에는 개발 구현체에서 '무엇이든 넣을 수 있음'에 해당하는 영역일 경우 피그마 컴포넌트에서는 특정 UI들을 미리 넣어두고 표시 여부만 바꾸는 방식을 사용했는데요. 컴포넌트의 경직도가 높아져서 불필요한 detach가 자주 발생하고 피그마 파일이 무거워진다는 단점이 있었습니다. 그리고 루트(root) 컴포넌트를 감싸서 파생 컴포넌트를 만들었기 때문에 최종 컴포넌트에서의 프로퍼티 사용을 제어할 수 없다는 부분도 문제였고, 컴포넌트의 중첩 구조 때문에 figma to code 과정에서도 비효율이 발생했는데요. 피그마 슬롯과 Base.md를 도입하면서 이 문제를 모두 해결할 수 있었습니다.
다음 글 읽기: (2) 클로드 코드와 함께 컴포넌트 만들기
채널톡을 함께 만들어갈 동료를 찾고 있어요. → 채용공고 보러가기
