EtienneLescot/n8n-as-code

해결하는 문제

n8n-as-code는 n8n 자동화를 개발자 중심의 워크플로우로 관리할 수 있도록 합니다. n8n 개발을 순수한 시각적 인터페이스에서 코드 기반 환경으로 전환하여, 버전 관리(GitOps), 환경 전환(Dev → Prod), 그리고 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 등 에이전트 전용 스킬 포함.