분석가에게 분석의 어려움과 고통이 있다면, 개발자와 기획자는 툴 도입 후 또 다른 종류의 고통을 받습니다.
개발자 : 제품 정의는 남이 하는데 결정은 내가 하고, 분량은 제일 많은데 리뷰에서는 아무도 안 봅니다. 맞게 심었는지는 배포하고 데이터가 쌓여야 알고요.
기획자 : 내가 설계한 이벤트는 문서에 있는데 그게 코드에 의도대로 들어갔는지는 배포 전까지 알 수 없습니다.
그런데 이 일은 고통스러운 만큼 중요합니다. 팀이 데이터를 믿고 쓸 수 있느냐가 여기서 정해지니까요. 어차피 꼭 해야 하는 일이라면 부담을 덜 방법을 찾는 편이 낫겠죠. 그래서 개발자와 기획자의 고통을 덜어줄 기능을 소개하려고 이 글을 준비했습니다
이 글은 믹스패널이 배포한 Implementation Skill로 계측 코드 작성과 결함 진단을 코딩 에이전트에게 시키는 법을 다룹니다. 콘솔에서 프롬프트를 복사해 붙여넣는 것으로 시작해서, 첫 이벤트를 심고 검증하는 데까지 한 세션이면 끝난답니다.(Quick Start 기준)
이 글을 다 읽고 나면 네 가지 모드가 언제 쓰이는지 알고, 에이전트가 추천한 모드가 내 상황에 맞는지 판단하실 수 있어요.
Quick Start : 첫 계측을 빠르게. 프롬프트 하나로 이벤트 2개와 로그인/로그아웃 식별을 한 세션에 배선
Full Implementation : 처음부터 제대로. 트래킹 플랜 설계부터 코드 구현과 배포 전 검증, 거버넌스 설정까지 단계마다 통과 조건을 걸고 진행
Add Tracking : 기존 구현에 이벤트 추가. 지금 쓰고 있는 명명 규칙을 먼저 읽고 거기에 맞춰서 구현
Audit : 기존 심은 것을 진단. 우선순위가 매겨진 수정 목록을 받고 필요한 수정까지 이어서
그리고 코드베이스에 접근할 수 없어도 멈추지 않습니다. Quick Start와 Full Implementation은 개발자에게 넘길 구현 스펙 문서를 대신 만들어 줘요.
💡 믹스패널 AI 에이전트 실전 가이드 시리즈
0편. 믹스패널 AI 기능 10가지, 우리 팀은 어디부터 켜야 할까요
1편. 분석가를 위한 믹스패널 AI ① KPI Agent와 RCA Agent
2편. 분석가를 위한 믹스패널 AI ② Dashboard Agent와 Experiment Agent
3편. 기획자·개발자를 위한 믹스패널 AI ① Context Engine, Verified Mode, Audit
4편. 기획자·개발자를 위한 믹스패널 AI ② 코딩 에이전트에 이벤트 트래킹을 맡기면 어디까지 하나요(Agent+Implementation Skill)
5편. Headless 출시, 분석을 코드로 남기는 방법
계측 앞에서 개발자와 기획자가 겪는 세 가지
문제1 - 제품 정의는 남이 하는데, 구현은 개발자가 합니다
기능 로직은 30줄인데 애널리틱스를 붙이고 나면 PR의 절반이 트래킹 코드가 됩니다. 분량은 제일 많은데 리뷰에서는 아무도 안 보고요. 더 곤란한 건 코드로 풀리지 않는 질문들이에요. Order Completed의 completed가 프론트 콜백인지 결제 승인인지는 제품 정의의 문제인데 물어봐도 확답이 안 오니까, 결국 개발자가 임의로 정하고 넘어가게 됩니다. 나중에 숫자가 이상하면 그 결정이 문제가 되고요.
문제2 - 맞게 심겼는지는 배포 후에야 안다
개발자는 한 번 눌렀는데 이벤트가 세 번 찍히는 것도, identify() 뒤에 로그아웃과 계정 전환, 웹뷰를 거치며 사용자 프로필이 쪼개지는 것도 데이터가 쌓여야 압니다. 기획자는 내가 설계한 이벤트가 코드에 의도대로 들어갔는지를 사전에 알 방법이 아예 없고요. 그래서 문제가 며칠 뒤에 드러나는데, 그때는 이미 다른 스프린트라 컨텍스트를 다시 불러오는 비용이 처음 심을 때보다 훨씬 큽니다.
문제3 - 코드는 고쳤는데 데이터가 맞는지는 또 모른다
수정 목록을 받아 코드를 고쳤다고 끝이 아니에요. 정의한 프로퍼티에 값이 제대로 들어오는지, 일부만 들어오는지, 데이터 타입이 맞는지는 코드를 봐서는 알 수 없고 실제로 쌓인 값을 봐야 압니다. 그런데 이 검산(QA)을 누가 언제 하는지가 정해져 있는 팀은 드물어요.
코드 작성부터 진단까지, 계측을 맡기는 3가지 방법
세 문제의 뿌리는 같습니다. 정의와 구현 사이가 비어 있고, 그 틈이 배포 후에야 드러난다는 것이죠. 앞의 둘은 Implementation Skill이 구현 모드와 Audit 모드로 해결할 수 있습니다. Implementation Skill도 구현한 뒤에 Live View에서 이벤트가 실제로 들어오는지 확인해요. 다만 기준값 대비 수집률이나 프로퍼티 충족률, 경로별 누락처럼 모집단 수준에서 정량 비교하고 수정 후 다시 재보는 루프는 별도 영역이라, 마켓핏랩이 자체 스킬로 운영하고 있습니다.
하나씩 살펴볼게요.
문제
현재 상황
맡는 도구
제품 정의를 개발자가 임의로 결정
확답해줄 사람이 없어 일단 정하고 넘어갑니다
Implementation Skill 구현 모드
배포 후에야 결함이 드러남
기획자가 데이터가 이상하다고 찾아와야 압니다
Audit 모드
고친 데이터가 맞는지 모름
실제 쌓인 값을 아무도 정량 검산하지 않습니다
마켓핏랩 QA 스킬
Implementation Skill은 믹스패널 콘솔이 아닌 여러분의 코딩 에이전트에서 실행됩니다
먼저 헷갈리는 지점 하나를 짚고 시작할게요. Implementation Skill은 믹스패널 콘솔에서 실행되는 제품 내장 기능이 아닙니다.
콘솔이 하는 일
코딩 에이전트가 하는 일
프로젝트 토큰과 skill 적용 프롬프트를 제공합니다
skill.md를 읽고 코드베이스를 스캔합니다
데이터 인입을 확인합니다 (Verify Connection)
추적 코드를 작성하고 자가 검증합니다
고객 코드베이스를 직접 읽거나 실행하지 않습니다
소스코드는 믹스패널로 전송되지 않습니다
믹스패널이 배포하는 것은 계측 절차서이고 실행은 여러분이 쓰는 Claude Code, Codex, Cursor, Copilot 같은 코딩 에이전트가 합니다. 믹스패널은 스킬이 코딩 에이전트 안에서만 돌고 코드가 사용자 환경을 벗어나지 않는다고 안내합니다. 프로젝트 토큰도 프로젝트에 설치되는 믹스패널 SDK만 사용해요.
설치는 프롬프트를 붙여넣기로 끝!
믹스패널 콘솔에서 톱니바퀴 설정으로 들어가 Set Up Mixpanel 메뉴를 엽니다
Get Started를 누르면 프로젝트 토큰과 skill.md 주소가 담긴 프롬프트가 나옵니다
이 프롬프트를 쓰고 계신 코딩 에이전트에 그대로 붙여넣습니다
에이전트가 코드베이스를 스캔한 뒤 필요한 것만 되물어봅니다
Implementation에는 4가지 모드가 있고, 에이전트가 제안하되 결정은 사용자가 합니다
모드
무엇을 하나
Quick Start
한 세션에 이벤트 2개(sign_up_completed와 Value Moment)와 identity 기본 배선(로그인 identify, 로그아웃 reset), Live View 검증까지 진행합니다
Full Implementation
트래킹 플랜 설계부터 코드 구현, 배포 전 검증과 거버넌스 설정까지 진행합니다. 단계마다 통과 조건이 걸려 있어요
Add Tracking
기존 구현에 이벤트를 추가할 때 씁니다. 기존 프로젝트의 컨벤션을 확인하고 맞춰 설계합니다
Audit
기존 구현을 스캔해 심각도/수정 우선순위 등이 붙은 수정 목록을 만들기도 하고, 실제 수정은 Add Tracking이나 Full Implementation 경로로 이어서 수행합니다
앞의 세 개가 구현 모드, 마지막이 진단 모드입니다.
스킬은 코드베이스에 접근할 수 있으면 먼저 조용히 스캔한 뒤, 네 가지 중 어느 모드로 갈지를 묻습니다. 진행하다가 identity 복잡도나 consent 이슈, CDP 사용처럼 판단이 바뀔 만한 게 나오면 다른 모드로 옮기자고 제안하고요. 결정은 사용자가 합니다.
Quick Start
Add Tracking
Full Implementation
언제
첫 이벤트를 빠르게 심을 때
기존 구현에 이벤트를 추가할 때
처음부터 제대로 깔 때
읽기
코드 접근 시 Pre-Flight 스캔
기존 코드와 이벤트 스키마
비즈니스 맥락 + Pre-Flight 스캔
확정
필수 확인 + 2개 이벤트 미니 플랜
신규 이벤트 스펙 리뷰 + 기존 규칙 정렬
KPI, 데이터 모델, 트래킹 플랜 + 사인오프
심는 범위
SDK 초기화 + 이벤트 2개 + 기본 identity
요청한 이벤트만
승인된 플랜을 우선순위대로 단계적 구현
검증
Live View 확인
Live View + 프로퍼티와 identity 확인
단계별 gate + identity QA
소요
1세션 목표
이벤트당 짧게
여러 세션 소요
Quick Start와 Add Tracking, Full Implementation 동작 원리
구현 모드 3가지는 읽기, 스펙 확인, 구현, 검증, 기록이라는 흐름을 공유합니다. 구현 모드에 따라서 달라지는 부분은 읽는 범위와 승인 강도, 구현 범위입니다.
이 글에서는 Quick Start 모드로 이 동작을 보여드리도록 할게요.
Pre-Flight 코드 스캔. 라우트, DB 모델, auth, 기존 애널리틱스, 환경변수를 스캔합니다.
one-way-door 질문. 코드가 답할 수 있는 것은 묻지 않습니다. skill.md는 Quick Start에서 사람에게 묻는 항목을 최대 네 가지로 못박아 두는데(플랫폼, CDP나 웨어하우스 사용, EU와 캘리포니아 사용자 유무, 핵심 가치 행동), 실제로 몇 개가 오는지는 Pre-Flight 스캔이 얼마나 채웠느냐에 달립니다. 저희 실측에서는 두 개가 왔습니다.
코드 작성. 승인을 받은 뒤 직접 수정합니다.
검증. 심은 코드가 실제로 이벤트를 발생시키는지 에이전트가 직접 돌려서 확인하고, 적어도 한 이벤트는 Live View에서 들어온 것을 확인하는 게 성공 기준입니다. 저희 실측에서는 이 단계에서 스테일 바이트 캐시가 걸렸는데, 에이전트가 원인을 먼저 격리하고 클린 빌드로 우회해 검증을 마치고 작업을 이어갔습니다. 다만 테스트 환경 배포와 실제 사용자 행동 발생은 사람의 몫입니다.
기록. 작업 결과를 요약하고 AGENTS.md에 믹스패널 설정과 이벤트, identity 규칙을 남깁니다. 이걸 읽고 다음 에이전트가 같은 규칙을 따라요. 저희 실측에서는 별도 작업 리포트도 함께 나왔습니다.
코드 작성 전에 에이전트가 정리하고 사람이 확인하는 4가지
이 부분이 실무적으로 가장 의미 있는 부분이라고 생각해요. 개발자와 기획자가 구현 직전에 맞춰보려다 확답이 안 와서 넘어가고, 결국 배포 후 데이터로 드러나던 것들이 있잖아요. 그 네 가지를 코드 작성 전에 확정하고 들어갑니다.
통제방식은 크게 둘로 나뉩니다. 1)에이전트는 코드에서 답을 찾고 스킬 규칙을 적용하며, 2) 제품 의미와 정책 판단은 사람이 확인합니다.
아래 네 가지가 통제 대상이예요.
단계
확인 사항
세부
1
발화 시점(trigger)
코드에서 후보를 찾고 제품 의미는 사람에게 확인합니다. 한 번 눌렀는데 세 번 찍히는 문제와 Order Completed의 completed가 어느 순간인지를 구현 전에 정의합니다
2
값(value)
코드를 읽어 값의 데이터 타입을 정하고 넣으면 안 되는 값은 거릅니다. 실측에서는 자유 입력 원문 대신 범주값과 길이 프록시를 써서 PII 수집을 피했습니다
3
유저 식별(identity/reset)
인증 흐름을 읽어 구현하고 복잡한 경우 추가로 확인합니다
4
규칙 집행(rule enforcement)
동적 이벤트명 금지 같은 규칙을 적용합니다
💡코드 접근이 안되는 상황이라면? 스펙 문서로 넘기는 developer handoff
Quick Start와 Full Implementation을 진행하다 코드베이스에 접근할 수 없을 때, 직접 코드를 수정하는 대신 개발자용 구현 스펙을 생성합니다.
이 경로를 developer handoff라고 하는데요. 산출물은 MIXPANEL_IMPLEMENTATION_SPEC.md 한 개이고, 여기에 이벤트와 프로퍼티 스펙, 바로 붙여 쓸 수 있는 코드, identify와 reset 호출 위치에 대한 힌트, 구현 맥락과 설정값, Live View 검증 절차가 정리됩니다.
개발자가 나중에 구현하도록 범위를 잡아두는 상황이 대표적이에요. 코드베이스에 접근하지 못하는 사용자가 개발자에게 스펙을 전달할 때, 또는 믹스패널을 처음 도입하는 개발팀이 코드 변경 전에 구현 예시와 적용 위치를 검토할 때 유용합니다. 에이전시나 외부 조직에서도 쓸 수 있고요.
결과적으로 개발자가 할 일은 스펙 문서를 검토해 코드에 적용하고 테스트 환경과 Live View에서 결과를 확인하는 것까지입니다.
참고로 Add Tracking은 기존 믹스패널 계측과 코드 접근을 전제로 만들어진 모드입니다. 코드 미접근 경로는 현행 skill.md 기준으로 정의돼 있지 않습니다.
결함을 검출하는 Audit 모드
Audit의 기능 소개는 3편에서 다뤘습니다. 여기서는 실제로 돌려본 결과를 봅니다.
환경. GitHub에 공개된 B2B 데모 사이트(AstroFlow)를 포크해 로컬 개발 서버를 빌드했습니다.
결함 세 종 시딩. 상품명을 test_product로 하드코딩, identify 호출을 의도적으로 누락, 이벤트가 두 번 발생하도록 더블 파이어를 심었습니다.
검출 결과. 시딩한 결함 세 개를 모두 잡아냈고, 의도하지 않았던 결함 세 건을 추가로 검출했습니다.
Audit이 만드는 것은 우선순위가 붙은 수정 목록입니다. 개별 이벤트 수정은 Add Tracking, 구조를 손봐야 하면 Full Implementation 경로로 이어집니다. 저희 실측에서는 이 전환까지 한 세션 안에서 연속으로 진행됐고, 이슈와 위치, 항목별 수정 방안이 파일과 라인 단위로 나왔습니다.
그런데, 코드는 고쳐졌는데, 데이터도 고쳐졌을까요?
Audit 진단서를 받은 기획자가 던지는 질문이 하나 있습니다.
고칠 곳은 진단서로 알았어요. 그런데 고친 다음 실제로 쌓이는 데이터가 맞는 데이터인지는 누가 확인해 주나요?
Audit은 구현 상태를 진단합니다. 코드와 identity 배치, 트래킹 플랜과의 차이를 봐요. 다만 트래킹 플랜상 이 프로퍼티가 대상 이벤트의 100%에 있어야 하는데 실제로는 몇 퍼센트인지, 특정 경로에서만 빠지는지처럼 기대값과 관측값을 모집단 수준에서 비교하는 것은 다른 층입니다. 문서와 코드와 관측 데이터, 이 세 정본이 서로 맞는지는 별도 작업이에요.
마켓핏랩이 자체 개발한 QA Skill이 이 층을 담당합니다. 두 스킬은 대체 관계가 아니라 직렬 관계예요.
구현 : Implementation Skill 구현 모드로 코드를 반영하고 Live View에서 기본 검증까지 합니다
진단 : 필요하면 Audit으로 구현 상태와 안티패턴을 점검해 수정 목록을 만듭니다
정량 검산 : 마켓핏랩 QA Skill이 기준값 대비 실수집 값을 정량 비교합니다
수정과 수렴 : 수정 후 재실행으로 차이가 줄었는지 확인하고 리뷰 큐를 운영합니다
정의한 프로퍼티에 값이 제대로 들어오고 있는지, 일부만 들어오고 있는지, 데이터 타입이 맞는지는 코드를 봐서는 알 수 없습니다. 실제로 쌓인 값을 봐야 알 수 있어요. 국내 고객사에서 계측을 새로 깐 뒤 첫 QA를 돌리면, 특정 프로퍼티가 절반만 채워져 들어오는 경우를 자주 만납니다. 웹뷰 경로나 서버 사이드 전송 경로에서만 누락되는 식이에요.
에이전트가 스킬을 활용해 심고, 마켓핏랩은 검산하고 수렴까지 운영합니다.
기획자와 개발자가 자주 묻는 질문
코드가 복잡해도 동작하나요. 에이전트 모델의 능력에 의존합니다. 공식 안내도 프로덕션 코드이므로 항상 사람이 리뷰하라는 쪽이에요. 실측에서는 시딩한 결함 세 종을 모두 검출하고 수정까지 연속 실행했습니다. 다만 같은 스킬을 두 번 실행했을 때 오토캡처 전환이나 이벤트 신설 같은 디테일이 달라졌습니다. 사람의 리뷰가 통제 지점이라고 보시면 됩니다.
따로 설치하거나 실행해야 하나요. 제품 내장 기능이 아닙니다. 콘솔의 역할은 토큰 발급과 skill.md URL 안내까지고, 실행은 코딩 에이전트가 해당 URL을 가져와 진행합니다. 소스코드는 고객 환경 밖으로 나가지 않고, 믹스패널로 가는 것은 검증 이벤트뿐이에요.
AI 사용이 MTU나 빌링에 잡히나요. 스킬은 고객의 코딩 에이전트 환경에서 실행되므로 AI 사용 비용은 사용자의 에이전트 요금제에 귀속됩니다. 믹스패널 빌링에 잡히는 것은 검증 과정에서 발생시키는 이벤트뿐이고 일반 이벤트와 같은 기준으로 계산됩니다.
무엇을 트래킹할지 정하는 단계에서도 쓸 수 있나요. 쓸 수 있습니다. Implementation skill은 '무엇을 트래킹할지' 정하는 설계부터 구현과 검증까지 연결합니다. 코드 접근 가부에 따라 경로는 달라지게 되는데, 코드에 접근할 수 있으면 에이전트가 코드와 기존 스키마를 읽어 이벤트 후보와 프로퍼티, 넣을 위치까지 제안하고 트래킹 플랜을 만듭니다. 사람이 확인하면 코드를 작성하고, 테스트 환경 배포와 Live View 확인까지 이어갑니다. 코드에 접근할 수 없으면 같은 트래킹 플랜을 코드 예시와 함께 MIXPANEL_IMPLEMENTATION_SPEC.md에 담아 개발자에게 넘길 수 있게 만듭니다. Quick Start는 이벤트 두 개짜리 미니 플랜, Full Implementation은 전체 플랜이에요. 필요한 입력은 코드베이스 접근 여부, 플랫폼, 기존 데이터 전송 경로, 규제 지역과 수집 동의 여부, 핵심 가치 행동입니다. 코드가 답할 수 있는 항목은 묻지 않아요. 설계 초안과 코드는 에이전트가 쓰고, 이벤트 의미와 트래킹 플랜 확정, 생성 코드 리뷰와 배포는 사람이 합니다.
이벤트 설치 속도가 빨라질수록, 검증 리소스 체계가 필요합니다
구현 속도가 병목이 아니게 되면 병목이 검증으로 옮겨갑니다.
지금까지 이벤트 추가가 느렸던 이유 중 큰 부분은 개발 리소스였어요. 구현 비용이 낮아지면 이벤트를 추가하는 속도와 빈도도 올라갑니다. 그런데 3편에서 다룬 Verified Mode 체크리스트를 떠올려 보세요. 이벤트 검증이 배포 속도를 따라갈 수 있는가라는 조건이 첫 번째였습니다.
구현이 빨라진 만큼 검증도 자동화되어야 하겠죠. 진단은 특정 시점의 상태를 보는 것이고, 데이터 품질을 유지하려면 검산은 반복 루프로 설계해야 하니까요. 수정하고, 재실행하고, 차이가 줄었는지 확인하고, 남은 항목을 리뷰 큐에 넣는 과정이 계속 돌아야 데이터가 신뢰할 만한 상태로 유지됩니다.
5편에서 이어집니다
마지막 편은 Headless입니다. 믹스패널 기능 전체를 파이썬 객체로 노출하는 오픈소스 SDK가 나왔어요. 분석을 코드로 재현하고 반복 실행으로 연결하는 방식이라, MCP와는 쓰임이 다릅니다. 저희가 실제로 자사 프로젝트에 적용해본 결과와 함께 정리했습니다.
지금 바로 해볼 수 있는 것
가볍게 시작하고 싶다면 : 개발 프로젝트 하나에 Audit 모드를 돌려보세요. 콘솔에서 프롬프트를 받아 코딩 에이전트에 붙여넣기만 하면 됩니다. 나온 fix list를 들고 커피챗을 요청해 주셔도 좋아요.
자료가 필요하다면 : 웨비나 발표 자료에 네 가지 모드 비교표와 Audit 실측 결과가 정리되어 있습니다. 솔루션즈 메일 주소(solutions@mfitlab.com) 혹은 슬랙으로 요청주시면 보내드려요.
제대로 정리하고 싶다면 : 계측을 새로 깔거나 대규모로 확장하는 단계라면 구현과 검산을 함께 설계하는 편이 낫습니다. 마켓핏랩은 Implementation Skill로 구현한 뒤 자체 QA Skill로 실수집 데이터를 검산하고, 수정과 재실행까지 운영 루프로 돌립니다.