n8n-workflow-architect

n8n ワークフローアーキテクト

Intelligent Automation Architect（IAA）— 本番環境で安定して稼働する自動化システムを構築するための戦略的ガイダンスです。

---

このスキルを使用する場面

次のような場合に、このスキルを呼び出してください。

1. 自動化プロジェクトを計画したい — 「営業パイプラインを自動化したいです」
2. 複数のサービスを連携する必要がある — 「Shopify、Klaviyo、Notionを使っています」
3. アーキテクチャに関する判断が必要 — 「これはn8nとPythonのどちらを使うべきですか？」
4. 実現可能性を評価したい — 「現在のスタックでXを自動化できますか？」
5. 本番環境向けのガイダンスがほしい — 「信頼性を高めるにはどうすればよいですか？」

---

基本理念

可能性より実用性

技術的に可能なことと、本番環境で実際に実用となることの間には、大きな隔たりがあります。このスキルは、次のようなシステムの構築を支援します。

• 土曜日の午前3時に障害が発生しない
• 維持するのに博士号が必要ない
• データセキュリティ、スケーラビリティ、状態管理に配慮している
• 技術的な巧妙さだけでなく、実際のビジネス価値をもたらす

---

アーキテクチャの意思決定フレームワーク

ステップ 1：スタックの分析

ユーザーがツールについて言及したら、次の項目についてそれぞれ評価します。

ツールのカテゴリ	よくある例	n8n のネイティブサポート	認証の複雑さ
E コマース	Shopify、WooCommerce、BigCommerce	はい	OAuth
CRM	HubSpot、Salesforce、Zoho CRM	はい	OAuth
マーケティング	Klaviyo、Mailchimp、ActiveCampaign	はい	API Key/OAuth
生産性	Notion、Airtable、Google Sheets	はい	OAuth
コミュニケーション	Slack、Discord、Teams	はい	OAuth
決済	Stripe、PayPal、Square	はい	API Key
サポート	Zendesk、Intercom、Freshdesk	はい	API Key/OAuth

アクション：n8n MCP の search_nodes を使用して、ノードが利用可能か確認します。

ステップ 2：ツール選択マトリクス

次の判断基準を適用します。

次の場合は n8n を使用します。

条件	理由
OAuth 認証が必要	n8n がトークンのライフサイクルを自動的に管理します
保守担当者が非技術者	ビジュアルワークフローは自己文書化されています
待機を含む複数日にわたるプロセス	組み込みの Wait ノードが処理の一時停止を担います
標準的な SaaS 連携	構築済みのノードにより定型コードが不要になります
1 回の実行あたり 5,000 件未満のレコード	メモリ制限の範囲内です
ビジネスロジックのノード数が 20 未満	ビジュアルの明瞭さを維持できます

次の場合は Python/Claude Code を使用します。

条件	理由
処理するレコードが 5,000 件を超える	ストリーム処理とメモリ管理が可能です
ファイルサイズが 20MB を超える	チャンク単位での処理が可能です
複雑なアルゴリズム	50 個以上のノードより、コードのほうが保守しやすいです
最先端の AI ライブラリが必要	最新のパッケージを利用できます
大規模なデータ変換	Pandas、NumPy による最適化が可能です
カスタム ML モデル	Python エコシステム全体にアクセスできます

ハイブリッドを使用する場合（複雑なシステムに推奨）：

n8n (Orchestration Layer)
├── Webhooks & triggers
├── OAuth authentication
├── User-facing integrations
├── Flow coordination
│
└── Calls Python Service (Processing Layer)
    ├── Heavy computation
    ├── Complex logic
    ├── AI/ML operations
    └── Returns results to n8n

---

ビジネススタックの簡易評価

ユーザーがスタックについて説明したら、次の分析を返します。

回答テンプレート：

## Stack Analysis: [User's Business Type]

### Services Identified:
1. **[Service 1]** - [Category] - n8n Support: [Yes/Partial/No]
2. **[Service 2]** - [Category] - n8n Support: [Yes/Partial/No]
...

### Recommended Approach: [n8n / Python / Hybrid]

**Rationale:**
- [Key decision factor 1]
- [Key decision factor 2]
- [Key decision factor 3]

### Integration Complexity: [Low/Medium/High]
- Auth complexity: [Simple API keys / OAuth required]
- Data volume: [Estimate based on use case]
- Processing needs: [Simple transforms / Complex logic]

### Next Steps:
1. [Specific action using other n8n skills]
2. [Pattern to follow from n8n-workflow-patterns]
3. [Validation approach from n8n-validation-expert]

---

よくあるビジネスシナリオ

シナリオ 1：E コマースの自動化

スタック：Shopify + Klaviyo + Slack + Google Sheets

結論：n8n のみ

• すべてのサービスにネイティブノードがあります
• OAuth が自動的に処理されます
• 標準的な Webhook パターンです
• 使用するもの：n8n-workflow-patterns → webhook_processing

シナリオ 2：AI を活用したリードの評価

スタック：Typeform + HubSpot + OpenAI + カスタムスコアリング

結論：ハイブリッド

• n8n：Typeform Webhook、HubSpot 同期、通知
• Python/Code Node：複雑なスコアリングアルゴリズム、AI プロンプト
• 使用するもの：n8n-workflow-patterns → ai_agent_workflow

シナリオ 3：データパイプライン／ETL

スタック：PostgreSQL + BigQuery + 1 日あたり 50k 件以上のレコード

結論：n8n のトリガーと Python

• n8n：スケジュールトリガー、成功／失敗の通知
• Python：バッチ処理、ストリーミング、変換
• 理由：大規模なデータセットでは、n8n のメモリ制限があるため

シナリオ 4：複数ステップの承認ワークフロー

スタック：Slack + Notion + Email + 3 日間の待機期間

結論：n8n のみ

• 遅延に使える組み込みの Wait ノード
• Slack／Notion のネイティブ連携
• 人による承認パターンが組み込まれています
• 使用するもの：n8n-workflow-patterns → scheduled_tasks

---

本番環境対応チェックリスト

自動化を本番環境で稼働させる前に、次の項目を確認してください。

可観測性

• エラー通知ワークフローがある
• データベースへの実行ログ記録
• 重要な処理経路のヘルスチェックワークフロー
• 重大度に応じた構造化アラート

冪等性

• 重複する Webhook の処理
• 作成前の確認パターン
• 決済用の冪等性キー
• 安全に再実行できる機能

コストへの配慮

• AI API のコストを算出し、承認を得ている
• レート制限を文書化している
• 繰り返し呼び出しに対するキャッシュ戦略
• 適切なモデルサイズの選択（Haiku と Sonnet と Opus）

運用管理

• 技術者以外のスタッフも利用できるキルスイッチ
• 影響の大きい処理の承認キュー
• すべての処理の監査証跡
• 設定の外部化

デプロイ前にワークフローを検証するには、n8n-validation-expert スキルを使用してください。

---

他の n8n スキルとの連携

このスキルは、他のスキルを調整する計画レイヤーとして機能します。

┌─────────────────────────────────────────────────────────────┐
│                  n8n-workflow-architect                      │
│            (Strategic Decisions & Planning)                  │
└─────────────────────────────────────────────────────────────┘
                              │
         ┌────────────────────┼────────────────────┐
         ▼                    ▼                    ▼
┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
│ n8n-workflow-   │  │ n8n-node-       │  │ n8n-validation- │
│ patterns        │  │ configuration   │  │ expert          │
│ (Architecture)  │  │ (Node Setup)    │  │ (Quality)       │
└─────────────────┘  └─────────────────┘  └─────────────────┘
         │                    │                    │
         └────────────────────┼────────────────────┘
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                     n8n MCP Tools                            │
│    (search_nodes, validate_workflow, create_workflow, etc.) │
└─────────────────────────────────────────────────────────────┘

スキルの引き継ぎガイド：

アーキテクトの判断後	引き継ぎ先
パターンの種類を特定	詳細な構造については n8n-workflow-patterns
必要なノードを特定	設定については n8n-node-configuration
Code ノードが必要	n8n-code-javascript または n8n-code-python
式が必要	正しい構文については n8n-expression-syntax
検証の準備が完了	デプロイ前チェックについては n8n-validation-expert
ノード情報が必要	n8n MCP → get_node_essentials、search_nodes

---

プランモードの有効化

複雑なアーキテクチャ上の判断では、プランモードに入り、次の作業を行います。

1. ビジネスの全体像を分析する
2. すべての連携ポイントを評価する
3. データフローのアーキテクチャを設計する
4. 障害要因とその緩和策を特定する
5. 実装ロードマップを作成する

プランモードを有効にする条件：

• ユーザーが 3 つ以上のサービスの連携を必要としている
• n8n と Python のどちらが適切か不明確
• 影響の大きい自動化（決済、顧客データ）
• 複雑な複数ステップのプロセス
• AI／ML コンポーネントが関与する

プランモードの出力構成：

## Automation Architecture Plan

### 1. Business Context
[What problem are we solving?]

### 2. Stack Analysis
[Each service, its role, integration complexity]

### 3. Recommended Architecture
[n8n / Python / Hybrid with rationale]

### 4. Data Flow Design
[Visual representation of the flow]

### 5. Implementation Phases
Phase 1: [Core workflow]
Phase 2: [Error handling & observability]
Phase 3: [Optimization & scaling]

### 6. Risk Assessment
[What could go wrong, how we prevent it]

### 7. Maintenance Plan
[Who maintains, what skills needed]

---

クイック判断フロー

START: User wants to automate something
  │
  ├─► Does it involve OAuth? ────────────────────► Use n8n
  │
  ├─► Will non-developers maintain it? ──────────► Use n8n
  │
  ├─► Does it need to wait days/weeks? ──────────► Use n8n
  │
  ├─► Processing > 5000 records? ────────────────► Use Python
  │
  ├─► Files > 20MB? ─────────────────────────────► Use Python
  │
  ├─► Cutting-edge AI/ML? ───────────────────────► Use Python
  │
  ├─► Complex algorithm (would need 20+ nodes)? ─► Use Python
  │
  └─► Mix of above? ─────────────────────────────► Use Hybrid

---

MCP ツールの連携

アーキテクチャの計画中に、次の n8n MCP ツールを使用してください。

計画フェーズ	使用する MCP ツール
スタック分析	search_nodes - ノードが利用可能か確認
パターン選択	list_node_templates - 類似するワークフローを検索
実現可能性の確認	get_node_essentials - 機能を把握
複雑さの見積もり	get_node_documentation - 認証と設定の要件を確認
テンプレートの参照	get_template - 既存のパターンを調査

---

注意すべき危険信号

次のようなパターンが見られた場合は、ユーザーに警告してください。

危険信号	リスク	推奨事項
「AI にすべてやらせたい」	コストの急増、予測不能な動作	AI の対象を特定のタスクに限定し、結果をキャッシュする
「何百万行もの処理が必要」	メモリ不足によるクラッシュ	n8n のループではなく、ストリーミング処理を使う Python
「ワークフローにノードが 50 個ある」	保守不能	コードブロックにまとめるか、ワークフローを分割する
「エラー処理は後で追加する」	気付かないまま障害が発生する	最初からエラー処理を組み込む
「どんな入力でも動くようにする」	脆弱なシステム	想定される入力を定義して検証する
「インターンが保守する」	単一障害点	視覚的に分かりやすい n8n を使い、十分に文書化する

---

概要

このスキルが答える質問：「自社のビジネススタックと要件を踏まえると、この自動化を構築する最も賢い方法は何ですか？」

主な成果物：

1. スタックの互換性分析
2. n8n、Python、ハイブリッドのいずれを選ぶかの推奨
3. パターンとスキルの引き継ぎ
4. 本番環境への対応に関するガイダンス
5. プランモードによる実装ロードマップ

連携先：

• 実装の詳細については、すべての n8n-* スキル
• ノードの検索とワークフローの作成については、n8n MCP ツール
• 複雑なアーキテクチャ上の判断については、プランモード

---

関連ファイル

• tool-selection-matrix.md - 詳細な判断基準
• business-stack-analysis.md - 一般的な SaaS 統合ガイド
• production-readiness.md - リリース前チェックリストの詳細