Como uma Equipe Substituiu uma Agência HubSpot de Seis Dígitos pelo Claude Code

Uma empresa de e-commerce de médio porte (~15 produtos em Shopify, Recharge, Digistore24, GoAffPro e anúncios) precisava migrar do Zoho CRM, Zoho Desk e KlickTipp para o HubSpot Enterprise. Os orçamentos das agências variavam de 20 mil euros (modelo padronizado) a 80 mil euros (objetos personalizados de nível médio) — mas nenhum oferecia middleware personalizado de ponta a ponta para sincronização/reconciliação. A equipe decidiu construir tudo por conta própria com Claude Code (aplicativo desktop, Opus 4.7, plano de assinatura).

O que foi construído (em 4 meses, ~30 sessões de 2 a 4 horas cada)

• 6 Objetos Personalizados + ~100 propriedades + associações
• 5 integrações com sistemas de origem no n8n auto-hospedado: Shopify, Digistore24, Recharge, GoAffPro, Cart-Notifier — cada uma com padrão de inbox, upserts idempotentes, reconciliação, backoff/retry, trilha de auditoria
• 1 serviço personalizado no Cloud Run para polling de inbox a cada 15 segundos
• 10 estágios de ciclo de vida + camada de propriedades Funil/Segmento
• Workflow agregador que preenche 9 propriedades de contato a partir de objetos espelho de sincronização (idempotente, cursor Postgres, cron)
• Migração KlickTipp: 202 tags auditadas, objeto personalizado para registros em webinars, governança de consentimento
• CAPI do Google Ads (11 ações de conversão, conversões aprimoradas) + CAPI do Meta (Pixel + server-side)
• 33 ADRs (decisões de arquitetura, somente adição, nunca excluídas)

O autor estima que a entrega completa custaria de 120 a 180 mil euros de uma agência — e a maioria não consegue entregar a parte de middleware personalizado.

A Mudança Mental: Claude Code como Sistema de Registro

Apenas ~20% do repositório é código. Os outros 80% são Markdown: decisões de arquitetura, especificações de integração, runbooks, ADRs, convenções de nomenclatura, governança de consentimento. O repositório se torna a fonte única da verdade sobre como o negócio funciona no HubSpot. Quando o código é necessário (helpers Python, scripts de backfill, serviço Cloud Run), Claude escreve. Para a lógica do workflow, usam n8n — Claude constrói/atualiza workflows via servidor MCP do n8n.

Repositório como Memória Entre Sessões

As sessões do Claude Code são sem estado. A equipe trata isso como uma restrição de design: o estado vive em arquivos. Práticas principais:

• ADRs capturam cada decisão de arquitetura com raciocínio e trade-offs — novas sessões os leem e não rediscutem
• Arquivos de especificação por integração/área com cabeçalho Status — fonte única da verdade para o estado da implementação
• Comandos de barra (/implement, /verify, /new-task) impõem disciplina — gate de Definição de Pronto, verificações de desvio, atualizações atômicas de status
• Folhas de dicas para operações HubSpot (que funcionam via ferramentas de API vs chamadas diretas de API vs cliques na interface) e bugs conhecidos (latência do índice de busca HubSpot, enumeração-vs-bool Recharge, corridas de autenticação n8n)