EtienneLescot/n8n-as-code

何を解決するか

n8n-as-code は、n8n の自動化をコードベースで管理する開発者中心のワークフローを提供します。n8n の開発を完全に視覚的なインターフェースからコードベースの環境へと移行し、バージョン管理（GitOps）、環境間の移行（開発 → 本番）、そして AI エージェントが文脈に根ざした安全な方法でワークフローの構築・編集を行うことが可能になります。

仕組み

このプロジェクトは、n8n の JSON ベースのワークフローを人間と AI エージェントが読みやすく編集しやすい TypeScript ファイル（.workflow.ts）に変換します。CLI（n8nac）と VS Code/Cursor 拡張機能を提供し、これらのファイルを n8n 環境と同期、検証、n8n-manager を通じてローカルの n8n インスタンスを管理できます。AI エージェントを活用するため、ノードスキーマ、ドキュメント、検証ルールを含む「スキル」レイヤーを提供し、正確なワークフローの生成を可能にします。

対象ユーザー

n8n を使用し、GitOps、環境管理、AI支援開発といったソフトウェア開発のベストプラクティスを、好みのコードエディタ内で適用したい開発者や自動化エンジニア。

特徴

• GitOps 同期: バージョン管理にワークフローを明示的にプル・プッシュし、差分を確認、コンフリクトを解決可能。
• TypeScript による記述: ワークフローを TypeScript に変換し、可読性と編集性を向上。
• エージェント対応の文脈: スキーマや例を含む根拠のある知識を提供し、AI エージェントが安全にワークフローを生成・編集可能。
• 環境間移行: 開発環境（例：Dev）から本番環境（Prod）へワークフローを移行し、資格情報や参照の自動再マッピングを実行。
• 統合ツールキット: VS Code 拡張、CLI、Claude Code などのエージェント向け専用スキルを含む。