Comment une équipe a remplacé une agence HubSpot à six chiffres par Claude Code

Une entreprise de e-commerce de taille moyenne (~15 produits sur Shopify, Recharge, Digistore24, GoAffPro et publicités) avait besoin de migrer de Zoho CRM, Zoho Desk et KlickTipp vers HubSpot Enterprise. Les devis d'agence allaient de 20 000 € (solution standardisée) à 80 000 € (objets personnalisés intermédiaires) — mais aucun ne proposait un middleware personnalisé de bout en bout pour la synchronisation/raccordement. L'équipe a décidé de le construire elle-même avec Claude Code (application de bureau, Opus 4.7, abonnement).

Ce qui a été construit (en 4 mois, ~30 sessions de 2 à 4h chacune)

• 6 objets personnalisés + ~100 propriétés + associations
• 5 intégrations de systèmes source sur n8n auto-hébergé : Shopify, Digistore24, Recharge, GoAffPro, Cart-Notifier — chacune avec modèle inbox, upserts idempotents, réconciliation, backoff/répétition, piste d'audit
• 1 service Cloud Run personnalisé pour l'interrogation de la boîte de réception à une cadence de 15 secondes
• 10 étapes du cycle de vie + couche de propriétés Funnel/Segment
• Workflow agrégateur qui remplit 9 propriétés de contact à partir d'objets miroirs synchronisés (idempotent, curseur Postgres, piloté par cron)
• Migration KlickTipp : 202 tags audités, objet personnalisé pour les inscriptions aux webinaires, gouvernance du consentement
• Google Ads CAPI (11 actions de conversion, conversions améliorées) + Meta CAPI (Pixel + côté serveur)
• 33 ADR (décisions d'architecture, ajout-only, jamais supprimées)

L'auteur estime que le livrable complet coûterait entre 120 000 et 180 000 € auprès d'une agence — et la plupart ne peuvent pas fournir la partie middleware personnalisée.

Le changement de mentalité : Claude Code comme système d'enregistrement

Seulement ~20% du dépôt est du code. Les 80% restants sont du Markdown : décisions d'architecture, spécifications d'intégration, runbooks, ADR, conventions de nommage, gouvernance du consentement. Le dépôt devient la source unique de vérité pour la façon dont l'entreprise fonctionne dans HubSpot. Lorsque du code est nécessaire (assistants Python, scripts de remplacement, service Cloud Run), Claude l'écrit. Pour la logique des workflows, ils utilisent n8n — Claude construit/met à jour les workflows via le serveur MCP n8n.

Le dépôt comme mémoire entre les sessions

Les sessions Claude Code sont sans état. L'équipe traite cela comme une contrainte de conception : l'état vit dans les fichiers. Pratiques clés :

• ADR capturent chaque décision d'architecture avec justification et compromis — les nouvelles sessions les lisent et ne redébattent pas
• Fichiers de spécification par intégration/domaine avec un en-tête Statut — source unique de vérité pour l'état de l'implémentation
• Commandes slash (/implementer, /verifier, /nouvelle-tache) imposent une discipline — passerelle Définition-de-Terminé, vérifications de dérive, mises à jour atomiques du statut
• Aide-mémoires pour les opérations HubSpot (qui fonctionnent via les outils API vs appels API directs vs clics UI) et les bugs connus (latence d'index de recherche HubSpot, énumération-vs-bool Recharge, courses d'authentification n8n)