한 팀이 6자리 수 허브스팟 에이전시를 클로드 코드로 대체한 방법

중견 전자상거래 기업(Shopify, Recharge, Digistore24, GoAffPro, 광고 등 약 15개 제품)은 Zoho CRM, Zoho Desk, KlickTipp에서 HubSpot Enterprise로 마이그레이션해야 했습니다. 에이전시 견적은 20,000유로(템플릿 기반)에서 80,000유로(중간 수준의 커스텀 객체)까지 다양했지만, 동기화/조정을 위한 종합적인 커스텀 미들웨어를 제공하는 곳은 없었습니다. 팀은 Claude Code(데스크톱 앱, Opus 4.7, 구독 플랜)로 직접 구축하기로 결정했습니다.

구축된 내용(4개월, 각 2~4시간 세션 약 30회)

• 6개 커스텀 객체 + 약 100개 속성 + 연결
• 5개 소스 시스템 통합(자체 호스팅 n8n): Shopify, Digistore24, Recharge, GoAffPro, Cart-Notifier — 각각 인박스 패턴, 멱등적 업서트, 조정, 백오프/재시도, 감사 추적 포함
• 1개 커스텀 Cloud Run 서비스(15초 주기로 인박스 폴링)
• 10개 라이프사이클 단계 + 퍼널/세그먼트 속성 레이어
• 동기화 미러 객체에서 9개 연락처 속성을 백필하는 집계 워크플로우(멱등적, Postgres 커서, 크론 기반)
• KlickTipp 마이그레이션: 202개 태그 감사, 웨비나 등록용 커스텀 객체, 동의 거버넌스
• Google Ads CAPI(11개 전환 액션, 향상된 전환) + Meta CAPI(픽셀 + 서버 측)
• 33개 ADR(아키텍처 결정, 추가 전용, 삭제 불가)

저자는 전체 결과물이 에이전시 기준 120,000~180,000유로에 달할 것으로 추정하며, 대부분의 에이전시는 커스텀 미들웨어를 제공할 수 없다고 말합니다.

사고 전환: 시스템 오브 레코드로서의 Claude Code

리포지토리의 약 20%만 코드입니다. 나머지 80%는 마크다운입니다: 아키텍처 결정, 통합 명세, 런북, ADR, 명명 규칙, 동의 거버넌스. 리포지토리는 비즈니스가 HubSpot에서 어떻게 운영되는지에 대한 단일 진실 공급원이 됩니다. 코드가 필요할 때(Python 도우미, 백필 스크립트, Cloud Run 서비스) Claude가 작성합니다. 워크플로우 로직은 n8n을 사용하며, Claude는 n8n MCP 서버를 통해 워크플로우를 구축/업데이트합니다.

세션 간 메모리로서의 리포지토리

Claude Code 세션은 상태가 없습니다. 팀은 이를 디자인 제약 조건으로 간주합니다: 상태는 파일에 존재합니다. 주요 관행:

• ADR은 모든 아키텍처 결정을 이유와 트레이드오프와 함께 기록합니다. 새 세션에서 이를 읽고 재논의하지 않습니다.
• 명세 파일은 통합/영역별로 Status 헤더와 함께 작성됩니다. 구현 상태에 대한 단일 진실 공급원입니다.
• 슬래시 명령어(/implement, /verify, /new-task)는 규율을 강화합니다. 완료 정의 게이트, 드리프트 검사, 원자적 상태 업데이트를 포함합니다.
• 치트 시트는 HubSpot 작업(API 도구 vs 직접 API 호출 vs UI 클릭), 알려진 버그(HubSpot 검색 인덱스 지연, Recharge 열거형 vs 부울, n8n 인증 경쟁)에 대해 제공됩니다.