あるチームが6桁のHubSpot代理店をClaude Codeで置き換えた方法

ある中堅eコマース企業（Shopify、Recharge、Digistore24、GoAffPro、広告で約15製品を展開）は、Zoho CRM、Zoho Desk、KlickTippからHubSpot Enterpriseへの移行を必要としていました。代理店の見積もりは2万ユーロ（テンプレートベース）から8万ユーロ（中級カスタムオブジェクト）までありましたが、同期・調整のためのエンドツーエンドのカスタムミドルウェアを提供できる代理店はありませんでした。そこでチームは、Claude Code（デスクトップアプリ、Opus 4.7、サブスクリプションプラン）を使って自社で構築することを決定しました。

構築したもの（4ヶ月間、各2〜4時間のセッション約30回）

• 6つのカスタムオブジェクト + 約100のプロパティ + 関連付け
• 5つのソースシステム統合（セルフホストn8n上）：Shopify、Digistore24、Recharge、GoAffPro、Cart-Notifier — それぞれインボックスパターン、冪等なupsert、調整、バックオフ/リトライ、監査証跡を実装
• 1つのカスタムCloud Runサービス（15秒間隔でインボックスをポーリング）
• 10のライフサイクルステージ + ファネル/セグメントプロパティレイヤー
• 同期ミラーオブジェクトから9つのコンタクトプロパティをバックフィルする集約ワークフロー（冪等、Postgresカーソル、cron駆動）
• KlickTipp移行：202タグの監査、ウェビナー登録用カスタムオブジェクト、同意ガバナンス
• Google Ads CAPI（11のコンバージョンアクション、拡張コンバージョン）+ Meta CAPI（Pixel + サーバーサイド）
• 33のADR（アーキテクチャ決定、追記のみ、削除しない）

著者は、完全な成果物は代理店から12万～18万ユーロかかると推定しており、ほとんどの代理店はカスタムミドルウェア部分を提供できないとしています。

マインドセットの転換：Claude Codeを情報源として活用

リポジトリの約20％だけがコードです。残りの80％はMarkdown：アーキテクチャ決定、統合仕様、ラン북、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の認証競合）についてまとめています。