n8n Workflow Auditor

Workflow intelligence for auditing n8n exports before they become production automation.

This repo targets n8n-style AI engineering work: TypeScript, workflow automation, structured findings, validation, recovery paths, and context boundaries around LLM nodes.

Why This Exists

n8n-focused AI roles need proof that Alex can reason about workflow automation, LLM API boundaries, validation, and recovery behavior. This repo starts with a local auditor for exported n8n workflow JSON.

Current Status

Scaffolded but runnable. The first slice audits a committed workflow fixture and generates JSON and Markdown reports without needing an n8n instance or API keys.

Quick Start

bun install
bun run check

Generate the included sample audit:

bun run demo

Outputs:

• reports/customer-intake.audit.json
• reports/customer-intake.audit.md

Repo Shape

src/
  auditor.ts       deterministic workflow audit rules
  auditor.test.ts  focused behavior tests
  cli.ts           CLI entrypoint
  types.ts         workflow and report types
examples/
  workflows/       exported workflow fixtures
reports/           generated audit reports
docs/
  contracts/       audit report contract
  runbooks/        operator workflow

Portfolio Signal

This repo targets n8n and A.Team role signals: workflow automation, LLM APIs, structured generation, validation, recovery, context optimization, and tool-using AI systems.