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 제공.