n8n-as-code
무엇인가
n8n-as-code는 저장소를 n8n 개발 워크스페이스로 전환하는 스킬 묶음이다. 워크플로를 `*.workflow.ts` 소스 파일로 두고, 에이전트가 노드 스키마·템플릿·검증 규칙에 근거해 워크플로를 생성·수정·배포하도록 규율한다. 규율 대상은 n8n 워크플로의 작성, 스키마 검증, 환경 간 승격, 저장소와 인스턴스 사이의 동기화다.
어떻게 동작하나
동작은 `skills/n8n-architect` 경로의 스킬을 중심으로 한다. 이 스킬이 워크스페이스 설정, n8n 컨텍스트 로드, 검증, 동기화 단계를 순서대로 처리한다. Claude Code에서는 플러그인으로 설치되어 자동 로드되고, 일반 에이전트에는 skills 디렉터리를 통해 노출된다. CLI의 `n8nac update-ai`가 에이전트 지시문을 생성하며 로컬 바이너리 경로를 직접 명시한다. `n8nac skills search`, `n8nac skills node-info`로 노드 스키마와 예시를 조회해 생성 근거로 삼는다. 번들에는 노드 스키마와 템플릿, 검증 규칙, 안전한 워크플로 조작 절차가 포함된다.
무엇과 다른가
프롬프트를 직접 쓰거나 일반 규칙 파일을 두는 방식과 달리, 스키마·템플릿·검증 규칙을 저장소에 번들로 두고 CLI 조회로 근거를 확보한다. 또 워크스페이스 컨텍스트(`n8nac env`)와 머신 로컬 인스턴스(`n8n-manager`)를 분리해, 시크릿과 런타임 상태를 저장소 밖에 남긴다. 동기화는 명시적이어서 `pull`·`push`·`promote`를 호출하지 않으면 아무것도 이동하지 않는다. `promote`는 대상 프로젝트 메타데이터를 다시 쓰고, 자격 증명과 지원되는 Execute Workflow 참조를 재매핑하며, `n8nac-promotion.json`에 소스-대상 바인딩을 기록한다.
어떻게 쓰나
Claude Code에서는 `/plugin marketplace add https://github.com/EtienneLescot/n8n-as-code` 후 `/plugin install n8n-as-code@n8nac-marketplace`로 붙이고, 이후 원하는 워크플로를 요청하면 `n8n-architect` 스킬이 설정·컨텍스트·검증·동기화를 처리한다. 일반 에이전트는 저장소의 skills 디렉터리에서 설치하며, 명시 경로를 요구하면 `skills/n8n-architect`를 지정한다. CLI 경로는 `npm install n8nac` 후 `n8nac env add Dev --base-url ... --workflows-path workflows/dev`, `n8nac env auth set Dev --api-key-stdin`, `n8nac env use Dev`, `n8nac update-ai` 순으로 워크스페이스를 만든다. 이후 `n8nac list`, `n8nac pull`, `n8nac push <path> --verify`, `n8nac promote --from Dev --to Prod --dry-run`으로 동기화와 승격을 수행한다.
전제와 한계
전제는 Claude Code 플러그인 환경이거나 skills 디렉터리를 읽는 에이전트, 그리고 접속할 n8n 인스턴스 URL과 API 키다. 번들 노드 스키마는 최신 안정 릴리스 기준으로 만들어지므로 인스턴스를 최신으로 유지해야 생성·검증 결과가 맞는다. n8n 공식 프로젝트가 아닌 독립 커뮤니티 프로젝트이며, VS Code·Cursor 확장과 CLI, OpenClaw는 별도 진입점이다. 프리릴리스(`@next`)를 쓸 때는 확장·CLI·스킬을 같은 태그로 맞춰야 한다.