EtienneLescot/n8n-as-code

解決する課題

n8nのワークフロー開発を、純粋なビジュアルインターフェースから、コード中心でAIエージェントが活用可能なワークスペースへと変革します。これにより、開発者はバージョン管理（GitOps）を利用し、プロフェッショナルなIDEでワークフローを編集できるようになります。また、AIエージェントがn8n環境のリアルタイムなコンテキストに基づいてワークフローを構築・デバッグすることが可能になります。

仕組み

このプロジェクトは、n8nのJSONベースのワークフローと開発者のエディタとの間のギャップを埋めるツール群を提供します。

• CLIと拡張機能: VS Code/Cursor拡張機能およびCLI (n8nac) により、環境管理、エディタとn8nインスタンス間のワークフロー同期、および検証を行います。
• TypeScript変換: n8nのJSONワークフローを読みやすい .workflow.ts ファイルに変換し、人間とAIエージェントの両方が修正しやすくします。
• エージェントスキル: ノードのスキーマ、ドキュメント、検証ルールを含む「スキル」レイヤーを提供します。これをAIエージェント（Claude CodeやCursorなど）に組み込むことで、有効なn8nワークフローを生成させることができます。
• 環境管理: 複数のn8n環境（Dev、Prodなど）を管理し、n8n-manager を通じてローカル管理インスタンスをサポートします。

対象ユーザー

• n8nユーザー: ビジュアルエディタの枠を超えて複雑なワークフローを扱いたい方。
• 開発者: 自動化パイプラインにGitOpsを導入したい方。
• AIエンジニア: n8nワークフローを自律的に作成・保守できるエージェントを構築している方。

ハイライト

• エージェント対応コンテキスト: AIエージェントが安全に作業するための、根拠に基づいた指示とスキーマを提供します。
• GitOpsスタイルの同期: 差分レビューと競合解決を伴う、明示的なプル/プッシュワークフロー。
• TypeScriptオーサリング: ワークフローをTypeScriptに変換し、可読性と保守性を向上。
• 環境プロモーション: 認証情報や参照を再マッピングしながら、ワークフローをある環境から別の環境へ移行するツール。
• IDE統合: VS CodeおよびCursorのネイティブサポートと、統合されたAgent Workbench。