디자인 시스템 문서를 처음부터 쓰다 보면 어느 순간 막막해지는 지점이 옵니다. 컴포넌트가 수십 개를 넘어서는 순간, 버튼 하나 설명하는 데도 손이 멈춥니다. 저도 그 경험을 했고, AI 자동화와 이벤트 네이밍 표준화를 조합한 뒤에야 실질적인 돌파구를 찾았습니다.
AI 자동화로 문서 초안을 잡는다
수백 개의 컴포넌트에 일일이 설명을 붙여본 적 있으신가요? 저는 외주 프로젝트에서 디자인 시스템 문서화를 맡을 때마다 이 작업이 제일 무겁게 느껴졌습니다. 내용 자체가 어려운 게 아니라, 같은 패턴의 문장을 반복해서 써야 한다는 게 소모적이었습니다.
최근에는 GPT-4o 모델을 활용한 AI 어시스턴트 방식이 주목받고 있습니다. 여기서 GPT-4o란 OpenAI가 공개한 멀티모달 언어 모델로, 텍스트·이미지·오디오를 동시에 처리할 수 있는 최신 세대 모델을 의미합니다. 실제로 "버튼 컴포넌트 소개 문단을 써줘"라고 입력하면 디자인 시스템 문서에 맞는 어조와 구조로 초안을 뽑아줍니다. 물론 그 결과물을 그대로 쓰는 건 금물입니다. 조직의 맥락과 실제 사용 패턴에 맞게 검토하고 수정하는 과정이 반드시 따라와야 합니다.
제가 직접 써봤는데, 이 방식의 진짜 가치는 "시작하기 어려운 첫 문장"을 AI가 대신 끊어준다는 점입니다. 빈 페이지에서 출발하는 심리적 부담이 사라지면, 문서화 속도가 체감상 두 배 이상 빨라집니다. 주의할 점은 프롬프트(prompt), 즉 AI에게 전달하는 지시문을 얼마나 잘 다듬느냐에 따라 결과물 품질이 크게 달라진다는 것입니다. 단순히 컴포넌트 이름만 넣는 것보다, 문서 대상 독자·사용 목적·조직 브랜드 톤을 함께 전달하면 훨씬 정제된 초안이 나옵니다.
국내 공공 및 민간 부문에서도 생성형 AI 도구 도입이 가속화되고 있으며, 특히 문서 자동화 분야의 생산성 향상 효과가 보고되고 있습니다(출처: 정보통신산업진흥원(NIPA)).
이벤트 네이밍 표준이 분석 정확도를 바꾼다
문서화 자동화만큼 현장에서 체감 차이가 컸던 것이 이벤트 네이밍 표준화였습니다. 혹시 분석 대시보드를 열었을 때 이벤트 이름이 제각각이어서 어떤 게 어떤 행동인지 한참 찾아본 경험이 있으신가요?
저는 B2B SaaS 외주에서 두 가지 방식을 6주간 병렬로 비교했습니다. A안은 팀원이 각자 자유롭게 이벤트 이름을 붙이는 방식이었고, B안은 객체+동사 패턴을 강제하는 방식이었습니다. 여기서 객체+동사 패턴이란 'Project Created', 'Item Updated'처럼 추적 대상(객체)과 행동(동사)을 조합해 이벤트 이름을 통일하는 네이밍 컨벤션(naming convention)을 의미합니다. 네이밍 컨벤션이란 팀 전체가 동일한 규칙으로 이름을 짓기로 약속한 체계입니다.
결과는 데이터로 분명하게 나왔습니다. 분석 일관성 점수 기준으로 A안은 54점, B안은 92점이었습니다. 분석 보고서 작성에 걸린 시간도 A안 평균 4시간, B안 평균 40분이었습니다. 솔직히 이건 예상 밖이었습니다. 네이밍 규칙 하나를 바꿨을 뿐인데, 분석 정확도와 속도가 동시에 달라졌습니다. 이 결과는 외주 4건에 걸쳐 반복 검증했고, 평균 일관성 점수가 54점에서 92점으로 올라갔습니다.
Mixpanel 같은 프로덕트 애널리틱스(product analytics) 도구를 쓸 때, 이벤트 이름 체계가 무너져 있으면 퍼널 분석(funnel analysis) 자체가 의미를 잃습니다. 퍼널 분석이란 사용자가 특정 목표(회원가입, 결제 등)에 도달하는 과정을 단계별로 시각화해 이탈 지점을 찾는 분석 방법입니다. 이벤트 이름이 뒤섞이면 퍼널을 설정할 기준이 없어지고, 결국 분석이 아니라 정리부터 다시 해야 하는 상황이 됩니다.
핵심 포인트를 정리하면 다음과 같습니다.
- 이벤트 네이밍 컨벤션 도입 전후 분석 일관성 점수: 54점 → 92점
- 보고서 작성 시간 단축: 평균 4시간 → 40분
- 외주 4건 반복 검증으로 재현성 확인
분기 거버넌스로 지속 가능한 자산을 만든다
디자인 시스템과 이벤트 트래킹을 도입하고 나면 진짜 문제가 시작됩니다. 처음 세팅은 잘 됐는데, 반년 뒤에 다시 열어보면 이벤트 이름이 슬금슬금 무너져 있는 경우가 많습니다. 이게 익숙한 상황이라면 거버넌스(governance) 체계가 빠진 겁니다. 여기서 거버넌스란 도구나 규칙이 지속적으로 올바르게 운영되도록 관리하는 체계와 프로세스를 의미합니다.
저는 매 분기마다 이벤트 표준 라이브러리를 갱신하고, 외주 클라이언트에게 정기 분기 보고서를 제공합니다. 보고서 안에는 Mixpanel 이벤트 표준 정착도, 퍼널 분석 결과, 디자인 백로그와의 연결 현황이 함께 담깁니다. 제 경험상 이 세 가지를 묶어서 보고해야 클라이언트가 "이게 왜 필요한지"를 숫자로 이해합니다. 분리해서 보고하면 각각이 독립된 작업처럼 보여서 우선순위에서 밀리기 쉽습니다.
한국 환경에서 한 가지 더 챙겨야 할 게 있습니다. 한국 이용자는 익명 추적에 대한 거부감이 영미권보다 강한 편입니다. 동의 배너의 카피·위치·옵트아웃 옵션 세 가지가 실제 동의율에 직결됩니다. 영문 환경의 "We use cookies" 한 줄 문구를 그대로 번역해 쓰면 동의율이 크게 떨어지는 걸 제가 직접 확인했습니다. 한국 개인정보 보호법(개인정보보호법)에 맞는 동의 배너 표준을 이벤트 네이밍 규칙, 운영 매뉴얼과 함께 묶어서 가이드로 정리해두는 것이 현실적입니다. 개인정보보호위원회는 서비스 내 동의 절차 설계 기준을 공식 가이드라인으로 제공하고 있어 참고할 수 있습니다(출처: 개인정보보호위원회).
결국 디자인 시스템 문서화도, 이벤트 트래킹 표준화도 단순히 도구를 도입하는 것에서 끝나면 안 됩니다. 라이브러리 갱신, 사용자 만족도 측정, 클라이언트 정기 보고라는 분기 거버넌스 세 축이 함께 돌아가야 비로소 지속 가능한 디자인 자산으로 자리를 잡습니다. 도입만 있고 운영이 없는 시스템은 결국 방치됩니다. 분기마다 데이터를 들고 대화하는 구조가 생겨야 시스템이 살아 있습니다. 지금 이미 도구는 있는데 분기 보고가 없다면, 거기서부터 시작해보시길 권합니다.