Cómo un equipo reemplazó una agencia de HubSpot de seis cifras con Claude Code

Una empresa de comercio electrónico mediana (~15 productos distribuidos en Shopify, Recharge, Digistore24, GoAffPro y anuncios) necesitaba migrar de Zoho CRM, Zoho Desk y KlickTipp a HubSpot Enterprise. Las cotizaciones de las agencias oscilaban entre 20k EUR (plantillas) y 80k EUR (objetos personalizados de nivel medio), pero ninguna ofrecía middleware personalizado integral para sincronización y conciliación. El equipo decidió construirlo por su cuenta con Claude Code (aplicación de escritorio, Opus 4.7, plan de suscripción).

Qué se construyó (en 4 meses, ~30 sesiones de 2-4 h cada una)

• 6 objetos personalizados + ~100 propiedades + asociaciones
• 5 integraciones con sistemas fuente en n8n autoalojado: Shopify, Digistore24, Recharge, GoAffPro, Cart-Notifier — cada una con patrón de bandeja de entrada, upserts idempotentes, conciliación, retroceso/reintento, registro de auditoría
• 1 servicio Cloud Run personalizado para sondeo de bandeja de entrada con cadencia de 15 s
• 10 etapas del ciclo de vida + capa de propiedades de embudo/segmento
• Flujo de trabajo agregador que rellena 9 propiedades de contacto a partir de objetos reflejo sincronizados (idempotente, cursor Postgres, programado con cron)
• Migración de KlickTipp: 202 etiquetas auditadas, objeto personalizado para registros de seminarios web, gobierno de consentimiento
• CAPI de Google Ads (11 acciones de conversión, conversiones mejoradas) + CAPI de Meta (píxel + servidor)
• 33 ADR (decisiones de arquitectura, solo anexar, nunca eliminar)

El autor estima que el entregable completo costaría entre 120 y 180k EUR en una agencia, y la mayoría no puede entregar la parte del middleware personalizado.

El cambio mental: Claude Code como sistema de registro

Solo ~20 % del repositorio es código. El otro 80 % es Markdown: decisiones de arquitectura, especificaciones de integración, manuales de operación, ADR, convenciones de nomenclatura, gobierno de consentimiento. El repositorio se convierte en la fuente única de verdad sobre cómo funciona el negocio en HubSpot. Cuando se necesita código (ayudantes de Python, scripts de relleno, servicio Cloud Run), Claude lo escribe. Para la lógica de flujo de trabajo, usan n8n; Claude crea o actualiza flujos de trabajo a través del servidor MCP de n8n.

El repositorio como memoria entre sesiones

Las sesiones de Claude Code no tienen estado. El equipo trata esto como una restricción de diseño: el estado vive en archivos. Prácticas clave:

• ADR capturan cada decisión de arquitectura con razonamiento y compensaciones: las nuevas sesiones los leen y no vuelven a debatir
• Archivos de especificación por integración/área con un encabezado de Estado: fuente única de verdad para el estado de implementación
• Comandos de barra inclinada (/implement, /verify, /new-task) imponen disciplina: compuerta de Definición de Hecho, comprobaciones de desviación, actualizaciones atómicas de estado
• Hojas de referencia para operaciones de HubSpot (cuáles funcionan mediante herramientas de API frente a llamadas directas a la API frente a clics en la interfaz de usuario) y errores conocidos (latencia del índice de búsqueda de HubSpot, enumeración frente a booleano en Recharge, condiciones de carrera en autenticación de n8n)