베지어 다시 짓기 (2) : 클로드 코드로 컴포넌트 만들기
AI와 함께한 피그마 라이브러리 제작
River ⛵️ • Product Designer @Meet Team
- Design / PM
이전 글 읽기: (1) 사람과 AI를 위한 디자인 시스템
AI와 함께한 약 60일간의 여정
혼자서 클로드 코드만 옆에 끼고 총 63일동안 웹 컴포넌트 38종, 모바일 컴포넌트 32종을 만들었습니다. 저는 3~4개의 병렬 세션을 띄워두고 결과가 오는 순서대로 받아치는 방식을 선호해요. 보통 1개 세션은 어느 정도 고민과 검토가 필요한 이슈를 다루고, 다른 세션들은 컴포넌트의 정렬·겹침·테두리처럼 자잘한 이슈를 쪼개어 처리하는 식입니다. 그렇게 3개월 동안 돌린 세션이 총 754개, 지금 보니 베지어에만 집중할 수 있었던 날은 하루에 53개까지도 진행한 적이 있네요.
클로드 디자인으로 만든 초기 버전 디자인 가이드
'딸깍-'에 대한 환상이 파괴된 사연
클로드 코드로 컴포넌트 만들기를 시작할 때 저는 이 작업이 아주 간단할 거라고 생각했어요. 웹, iOS, 안드로이드 세 플랫폼 모두 이미 사용 중인 기존 베지어 레포지토리가 있으니까 AI한테 코드를 읽혀서 피그마로 옮기고, 조금만 손보면 될 컴포넌트들부터 끝낸 후 그것을 참조해서 새 컴포넌트들을 만들 계획이었거든요. 그런데 막상 해보니 생각보다 시행착오가 많았어요. 거기에는 몇 가지 분명한 원인이 있었습니다.
병렬 진행으로 인한 혼란스러운 환경
이 당시 채널웍스 리디자인이 한창 진행되고 있었어요. 비유하자면 '달리는 기차에 바퀴를 달아야 하는데, 그 와중에 다른 팀에서는 차체를 다시 조립하고 있는' 상황이었죠. 촉박한 일정상 기존 베지어 컴포넌트와 리디자인 스타일을 강제로 입혀둔 임시 베지어 컴포넌트가 혼용되고 있었습니다. 그래서 작업 맥락에 따라 SSOT(Single Source Of Truth)로 삼아야 할 경로가 달라지곤 했는데, 어떤 작업을 지시했을 때 잘못된 대상을 참조하는 경우가 많았어요.
엎치락뒤치락하는 컴포넌트 기획
피그마 라이브러리 작업을 진행하면서 컴포넌트들의 베리언트 구성을 바꾸거나 프로퍼티를 삭제·추가하는 등 크고 작은 의사결정이 계속해서 일어났어요. 그런데 AI는 작업을 매 세션 새로 시작하다보니, 세션끼리 기억이 공유되지 않아 이전에 결정한 내용을 다시 뒤집어서 반영하는 등의 오류가 자꾸 발생했습니다. 기획 변경 사항이 Spec.md와 피그마 양쪽에 모두 전파되지 않고 한 쪽에만 반영되는 누락 이슈도 종종 있었구요.
빠르지만 기억하지 못하는 클로드 코드
클로드 코드를 통해 피그마 작업을 할 때의 최대 장점은 사람보다 디버깅을 빠르고 체계적으로 할 수 있다는 점이에요. 간혹 사람이라면 절대 하지 않을 실수를 저지를 때도 있지만, 대부분 몇 번의 채찍질만으로도 직접 테스트하는 것보다 피그마 구현상의 문제를 쉽게 해결할 수 있었습니다. 그런데 이렇게 한 번 바로잡아도 그때뿐이라는게 문제였어요. 실수에서 배운 내용이 어디에도 쌓이지 않아서 새로운 세션을 시작하면 지난 실수를 되풀이하는 거였죠.
안정적인 작업 파이프라인 만들기
Claude code-Figma 작업 파이프라인 개요
일단 인사이트를 기록으로 쌓기 시작하자 실수가 눈에 띄게 줄어들었어요. 아무것도 없을 때는 한 번 교정했던 문제가 다시 발생한 세션이 100번당 27번 쯤이었는데, 컴포넌트 관련 결정 이력과 피그마 작업 방법을 적어둔 기준 문서를 세팅한 뒤로는 1번 정도로 뚝 떨어졌어요. 빌드할 때 AI가 이 문서들을 참조하면서 같은 실수를 덜 반복하게 된 거죠. 여기에 피그마 구현체를 스펙 및 기준 문서와 대조하는 검수 에이전트를 추가해서 더블체크할 수 있도록 세팅했습니다.
decision-log.md: 빈틈없는 기획 변경 히스토리
가장 먼저 필요했던건 컴포넌트 기획이 바뀔 때마다 이전과 최신 의사결정이 뒤섞이지 않도록 하는 장치였어요. decision-log.md는 "이건 왜 이렇게 정했나"를 시간순으로 기록한 문서입니다. AI뿐만 아니라 다른 멤버들과도 뇌를 공유할 수 있도록 기획 시 고려했던 옵션들과 관련 리서치, 최종 채택안과 결정 이유까지 저장합니다. 효과는 빨랐어요. 첫 항목을 기록한 바로 그날 오후에, 벌써 다른 작업에서 그걸 인용하면서 "이건 아까 정한 그거"라고 넘어가더라고요. 더 이상 맨땅에 헤딩하지 않게 된거죠.
plugin-api-workaround.md: 피그마 작업 공략집
사람이 툴 사용법을 배울 때 문제 대처법을 기억하는 것처럼, 클로드 코드가 한 번 학습한 피그마 작업 요령을 기록해두고 계속 참조할 수 있는 규칙서를 만들었어요. plugin-api-workaround.md는 새로운 피그마 문제를 해결할 때마다 계속 노하우가 추가되는 지침서입니다. 예를 들어 '숨겨져있는 레이어의 크기를 잘못 읽는 문제'를 한 번 정리해두니, 나중에 전혀 다른 컴포넌트들의 베리언트 100여개에서 같은 문제가 있을 때 기록해둔 방법을 바로 꺼내 쓸 수 있었어요. 프로젝트가 마무리될 때쯤 이 문서에 기록된 항목은 60개 이상이 되었습니다.
figma-safety-gate.sh: 돌이킬 수 없는 실수 차단
클로드 코드가 컴포넌트를 수정하다가 통째로 날려먹은 사건 이후, figma mcp의 작성 툴을 호출할 때 safety gate 훅이 돌아가면서 컴포넌트 삭제를 원천 차단하도록 세팅했습니다. 이걸 붙인 직후 어떤 컴포넌트의 베리언트를 부분 삭제하려다가 차단당했는데요. 당초의 목적은 마스터 컴포넌트의 ID 상실 방지였기 때문에 컴포넌트 세트 삭제만 막도록 기준을 완화했습니다. 제대로 코드를 읽고 잘 판단하고 있다는 뜻이라서 안심이 됐어요.
bezier-figma-auditor: 피그마-스펙 일치 여부 검수
클로드 코드가 작업 내용을 다 반영했다고 했는데, 사실 진행되지 않았거나 누락되는 경우가 종종 있었어요. 하지만 모든 컴포넌트의 수많은 베리언트를 하나하나 확인하는 건 시간이 꽤 드는 일입니다. 그래서 Spec.md에서 기준값을, Figma에서 실제 값을 읽고 둘을 맞춰보는 검수 스킬(bezier-figma-audit)을 만들었어요. 웹과 모바일의 모든 컴포넌트 세트에서 특정 state가 누락되지 않았는지 전수 조사하는 등의 작업에 유용했습니다. 나중에는 이 스킬을 팀 동료인 라이언이 에이전트화(bezier-figma-auditor)하면서 안정성이 강화되고 가이드 개선 제안도 받을 수 있게 되었습니다.
자동화 뒤에 남는 건 결국 '판단'
작업 환경을 세팅한 후에는 컴포넌트 설계 고민에 순수하게 몰입할 수 있었어요. 가장 마지막까지 고민한 것은 List item의 베리언트 구성이었는데요. 처음에는 leading content별 인터페이스 통제를 위해 종류별 서브 컴포넌트를 나누었는데, 사용성과 관리 비용 측면에서 너무 비효율적이었어요. 앞서 세웠던 베지어 설계 원칙과도 잘 맞지 않았구요. 그래서 서브 컴포넌트는 하나로 합치고, 어떤 요소가 들어올 수 있는지는 베리언트로 제약해 일관성만 지켰어요. 마침 참고하던 주요 레퍼런스 시스템들을 코드 레벨로 뜯어보니 동일한 구조더라고요.
이렇게 설계한 컴포넌트들을 핸드오프하면서 구조와 네이밍을 최종 확정하는 시기에는 개발자분들과 매일같이 열띤 토론을 나누었어요. 마찬가지로 속도감있는 일정으로 진행했지만 이전에 기록해둔 결정 근거와 리서치 내용이 있어서 사전 준비에 드는 시간은 적었지만 효율적으로 논의할 수 있었고, 협의한 결과 기획이 변경되는 경우에도 작업 환경이 잘 마련되어 있어서 수정 사항이 누락되지 않도록 빠르게 반영할 수 있었습니다.
치열한 대화의 기록
다시 처음부터 시작한다면...
작업 환경을 체계적으로 세팅한 후 시작하기
이번에는 '일단 해보자'는 마음으로 시작했기 때문에 무작정 컴포넌트를 찍어낸 다음, 문제를 발견할 때마다 일일히 대응하면서 파이프라인을 보완했는데요. 다시 작업한다면 먼저 디자인 시스템 구축 이후의 운영 단계를 기준으로 전반적인 폴더 구조부터 잡아두고, 기조와 철학 / 작업 가이드라인 / 주요 레퍼런스 / 프로젝트 진행 환경 등 필요 문서와 맥락 정보를 최대한 채운 후 작업을 시작할 것 같아요. AI의 작업 속도는 사람이 따라갈 수 없지만, AI가 무엇을 기준으로 삼을지를 정하는 건 결국 사람의 몫이더라고요. 필요한 정보를 사람이든 AI든 다시 꺼내볼 수 있는 자산으로 남기는 일의 중요성을 많이 느낄 수 있었어요.
수작업을 좀 더 많이 활용하기
'클로드가 알아서 잘 만들어주지 않을까'하는 기대감과, 모든 작업 이력을 메모리에 남기고 싶다는 막연한 마음으로 인해 프로젝트 중반까지도 피그마 작업을 그다지 직접 하지 않았는데요. 정확한 레퍼런스가 주어졌을 때 지침에 따라 베리에이션하는 일을 AI가 잘하기 때문에, 제 요청을 계속해서 잘 못알아들을 경우 직접 샘플을 작성해서 보여주는 편이 쉽고 빨랐어요. 여러 곳에 참조시킬 수 있거나 세밀한 조정이 필요한 작업일 경우, 처음부터 직접 만들었다면 작업 시간과 토큰을 많이 아낄 수 있었을 것 같아요.
베지어 리디자인은 아직 활발한 프로젝트에요. 어느 정도 구현이 완료되어서 윤곽이 드러나고 실사용되기 시작한 지금, 다음 관심사는 '새로워진 디자인 시스템이 얼마나 AI-네이티브 제품 개발에 기여하고 있는지'를 측정하면서 꾸준히 키워나가는 것이에요. 정말 흥미로운 주제 아닌가요?
채널톡을 함께 만들어갈 동료를 찾고 있어요. → 채용공고 보러가기
