Afrexai N8N Mastery

# n8n Workflow Mastery — Complete Automation Engineering System

You are an expert n8n workflow architect. You design, build, debug, optimize, and scale n8n automations following production-grade methodology. Every workflow you create is complete, functional, and follows the patterns in this guide.

---

## Phase 1: Quick Health Check (Run First)

Score the current n8n setup (1 point each, /10):

| Signal | Check |
|--------|-------|
| Workflow naming | Consistent `[Category] Description` format? |
| Error handling | Every workflow has error trigger node? |
| Credentials | Using n8n credential store (not hardcoded)? |
| Versioning | Workflow descriptions include version/changelog? |
| Monitoring | Error workflow connected to notification channel? |
| Retry logic | HTTP nodes have retry on failure enabled? |
| Execution data | Pruning configured (not filling disk)? |
| Sub-workflows | Complex logic broken into reusable sub-workflows? |
| Environment vars | Using env vars for URLs/configs (not magic strings)? |
| Documentation | Each workflow has description explaining purpose? |

**Score 0-3:** Critical — follow this guide start to finish.
**Score 4-6:** Gaps — focus on missing areas.
**Score 7-10:** Mature — jump to advanced patterns.

---

## Phase 2: Workflow Architecture & Design

### 2.1 Workflow Strategy Brief

Before building, answer these in a YAML brief:

```yaml
workflow_brief:
  name: "[Category] Brief Description"
  problem: "What manual process does this eliminate?"
  trigger: "What starts this workflow? (webhook/schedule/event/manual)"
  inputs:
    - source: "Where does data come from?"
      format: "JSON/CSV/form/email/database"
      volume: "How many items per run? Per day?"
  outputs:
    - destination: "Where does data go?"
      format: "API call/email/database/file/notification"
  error_handling: "What happens when it fails?"
  sla: "How fast must it complete? Acceptable delay?"
  dependencies:
    - service: "External API/service name"
      a...

# n8n Workflow Mastery

The definitive agent skill for designing, building, debugging, and scaling n8n automations. Goes far beyond API wrappers — this is a complete methodology.

## Install

```bash
clawhub install afrexai-n8n-mastery
```

## What You Get

- **Quick health check** — score your n8n setup in 60 seconds (/10)
- **Workflow architecture** — naming conventions, complexity tiers, layout patterns
- **15+ trigger patterns** — webhook security, schedule patterns, polling with dedup
- **Code node library** — map, filter, dedupe, paginate, rate limit (copy-paste ready)
- **Error handling architecture** — error triggers, retry with backoff, circuit breakers, dead letter queues
- **6 integration patterns** — CRM sync, email pipeline, approval flows, AI classification
- **Sub-workflow design** — when to extract, interface contracts, orchestrator pattern
- **State management** — static data patterns, dedup caches, external state
- **Security checklist** — HMAC verification, credential management, PII handling
- **Performance optimization** — 8-priority stack, batch templates, memory optimization
- **Testing methodology** — unit/integration/smoke/load testing for workflows
- **4 complete workflow templates** — lead capture, report generator, AI ticket classifier, payment sync
- **Advanced patterns** — fan-out/fan-in, event-driven, feature flags, queue pattern
- **100-point quality rubric** — score any workflow across 8 dimensions
- **12 natural language commands** — just describe what you need

Zero dependencies. Works with any n8n instance (self-hosted or cloud).

## Quick Start

Tell your agent:
> "Build an n8n workflow that captures form submissions, enriches leads, adds to HubSpot, and alerts sales on Slack"

The skill provides complete, production-ready workflow designs — not placeholder nodes.

## ⚡ Level Up

Need industry-specific automation playbooks? Check out our context packs:

- **SaaS Context Pack** ($47) — Complete SaaS automation: onboarding, billin...