Projekt-Template

Code-First n8n Projekt-Template

Clone-und-los Projekt-Template für code-first n8n-Entwicklung mit n8nac, Code-Mode und Beads Issue-Tracking. Enthält Scaffold-Skripte, Pre-Commit Secret-Detection, Credential-freie Validierung und CI/CD für GitHub Pages — alles vorkonfiguriert für Claude Code und Codex.

GitHub Repository → Architektur ansehen

4 Scripts

4 Kategorien

3 AI Agent Files

5 Lifecycle Steps

Code-First n8n Project Template

$ git clone template && cd project

$ npm install

$ npm run setup:n8n -- http://n8n:5678

$ npm run new-workflow -- agents/my-bot

Scaffold → Develop → Validate → Push

workflows/

agents/ — AI agent workflows

pipelines/ — Data processing

triggers/ — Event-driven

utilities/ — Helper workflows

Architektur

Pipeline

Clone + Setup

Template klonen, npm install, n8n-Instanz verbinden mit setup:n8n Script.

Scaffold

new-workflow.sh erzeugt Verzeichnisstruktur mit README, workflow.ts und test.json.

Develop + Validate

Lokal entwickeln mit credential-freier Validierung vor dem Push.

Push + Test

n8nac push deployt, n8nac test verifiziert live auf der n8n-Instanz.

Tech Stack

Technologien

Workflow

n8nn8nacCode-Mode

Tooling

BeadsGitHub PagesPre-Commit Hooks

AI Agents

CLAUDE.md@AGENTS.mdAGENTS.md

Engineering Decisions

Architektur-Entscheidungen

Entscheidung

Clone-und-los statt Generator

Ein einfaches Git-Template zum Klonen statt eines CLI-Generators. Keine Abhängigkeit von einem Scaffolding-Tool — alles liegt im Repo.

Entscheidung

Drei AI-Agent-Dateien

CLAUDE.md, @AGENTS.md und AGENTS.md decken Claude Code, Codex und n8nac ab. Jeder Agent bekommt passende Instruktionen ohne manuelles Setup.

Entscheidung

Pre-Commit Secret Detection

check-secrets.sh als Git-Hook verhindert versehentlich committete API-Keys und Tokens. Aktivierung mit einem einzigen git config Befehl.