n8n Automation Squad

Squad de 5 agentes de IA especializados em desenhar, construir e debugar workflows complexos no n8n — incluindo agentes de IA, sistemas RAG (Retrieval-Augmented Generation) e integrações entre 400+ ferramentas.

Squad construído com expertise técnica profunda em n8n — não mind-cloned de pessoa específica, porque n8n é território onde frameworks vencem personas. Cada agente domina uma camada do stack: workflow design, AI agent design, RAG, integrations.

Sumário

• O que é
• Quem está incluído
• Para que serve
• Estrutura do repositório
• Instalação
• Como usar
• Validação
• Diferencial vs ChatGPT/Claude vanilla
• Limitações importantes
• Pré-requisitos do usuário
• Pricing sugerido
• Exemplos completos
• Tasks do squad

O que é

Um squad no padrão squads.sh é um conjunto coordenado de agentes especializados sob um orquestrador. Este squad é desenhado para um caso de uso específico:

Equipe que precisa automatizar processos com n8n e quer ir além do trial-and-error — workflows resilientes, agentes de IA práticos, RAG corporativo e integrações que aguentam produção.

O squad não acessa sua instância n8n nem executa workflows ao vivo. Ele gera workflow JSON exportável, prompts, schemas e configs que você importa e roda.

Quem está incluído

/automation-chief

/workflow-architect

/ai-agent-designer

/rag-specialist

/integration-engineer

Os arquivos formais de cada agente vivem em

agents/

. As skills executáveis no Claude Code vivem em

.claude/skills/

(ver Instalação).

Para que serve

• Workflows de automação corporativa — CRM sync, lead routing, billing automation
• Agentes de IA práticos — chatbots com tools, agents que pesquisam + decidem + agem
• Sistemas RAG completos — base de conhecimento da empresa acessível via chat
• Integrações complexas — orquestrar 5-15 SaaS com lógica condicional
• Migrations Zapier/Make → n8n — economizar custo + ganhar poder de customização
• Custom nodes em TypeScript — quando native node não existe ou é insuficiente

Estrutura do repositório

n8n-automation-squad/
├── squad.yaml                # Manifest do squad (squads.sh schema)
├── agents/                   # 5 agentes — fonte canônica
│   ├── automation-chief.md
│   ├── workflow-architect.md
│   ├── ai-agent-designer.md
│   ├── rag-specialist.md
│   └── integration-engineer.md
├── tasks/                    # 6 tasks operacionais
│   ├── triage-automation-request.md
│   ├── design-workflow.md
│   ├── design-ai-agent.md
│   ├── design-rag-pipeline.md
│   ├── wire-integrations.md
│   └── consolidate-workflow-json.md
├── config/
│   └── settings.yaml
├── examples/                 # 3 exemplos completos
│   ├── 01-lead-enrichment-routing.md
│   ├── 02-rag-chatbot-suporte.md
│   └── 03-ai-agent-email-triage.md
├── cts-history/              # Histórico interno de construção (CTS lifecycle)
├── install.sh                # Instalador das skills no Claude Code
├── INSTALL.md                # Instruções de instalação detalhadas
└── README.md

Instalação

Pré-requisitos

• Claude Code instalado
• macOS / Linux / WSL
• bash ou zsh

Auto-install

git clone https://github.com/lucascharao/n8n-automation-squad.git
cd n8n-automation-squad
./install.sh

O instalador pergunta:

• [1] Global — instala em

  ~/.claude/skills/

• [2] Projeto-local — instala em

  <projeto>/.claude/skills/

Manual

# Global
cp -r .claude/skills/* ~/.claude/skills/

# Projeto-local
cp -r .claude/skills/* /caminho/projeto/.claude/skills/

Verificação

Abra o Claude Code:

/automation-chief

Resposta esperada:

🧭 Auto Chief pronto. Qual automação?

Desinstalação

rm -rf ~/.claude/skills/{automation-chief,workflow-architect,ai-agent-designer,rag-specialist,integration-engineer}

⚠️ Nota sobre as skills: as 5 skills executáveis ficam em

.claude/skills/

e são versionadas a partir da versão 1.0.0. Se cloná-las e o diretório não estiver presente, atualize seu clone (git pull) ou re-clone.

Como usar

Modo orquestrado (recomendado)

/automation-chief

> "Quero criar um agente que recebe lead via formulário, enriquece com Apollo,
   classifica com OpenAI, roteia pra time certo no Slack e cria deal no HubSpot.
   Volume: ~200 leads/dia. n8n self-hosted (Docker)."

O

/automation-chief

Modo specialist direto

Se você sabe exatamente o que quer:

/workflow-architect          # Estrutura macro + error handling + JSON exportável
/ai-agent-designer           # LLM step ou agent completo (LangChain)
/rag-specialist              # Pipeline RAG completo com eval
/integration-engineer        # APIs, OAuth, webhooks, custom nodes

Pipeline típico (lead routing com IA)

1. Triage (

   /automation-chief

   ) → decide: workflow + LLM step (não agent)
2. Workflow design (

   /workflow-architect

   ) → trigger + nodes + error handling
3. AI step (

   /ai-agent-designer

   ) → LLM classification com structured output
4. Integrations (

   /integration-engineer

   ) → Apollo + HubSpot + Slack
5. Consolidate (

   /automation-chief

   ) → workflow JSON final + ops runbook

Tempo total: 2-4h dependendo de complexidade.

Validação

O squad está em conformidade com o schema squads.sh:

npm install -g squads
squads validate /caminho/n8n-automation-squad

Score atual: 100/100 SAFE — zero errors, zero warnings.

Diferencial vs ChatGPT/Claude vanilla

Limitações importantes

• Squad NÃO acessa sua instância n8n — gera workflow JSON exportável que você importa
• Squad NÃO testa execução real — você roda e cola erros para debug
• Squad pressupõe n8n self-hosted (Docker), n8n.cloud ou Desktop — não cobre alternatives proprietárias
• Custom nodes em TypeScript — squad escreve, você builda + deploya
• Credenciais nunca são geradas/armazenadas pelo squad — apenas templates com placeholders

Pré-requisitos do usuário

• n8n instalado (self-hosted Docker, n8n.cloud ou Desktop)
• Conhecimento básico de n8n (saber importar workflow JSON, configurar credentials)
• Para agentes: API key OpenAI / Anthropic / Google / OSS via Ollama
• Para RAG: vector store configurado (Pinecone, Supabase pgvector, Qdrant, Weaviate)

Se faltar pré-requisito, o

/automation-chief

guia o setup antes de avançar.

Pricing sugerido

/rag-specialist

Mercado-alvo: dev / no-code builders / equipes de automação corporativa. Mercado n8n explodindo em 2026 (alternativa principal a Zapier/Make em casos complexos).

Exemplos completos

Ver pasta

examples/

1. 01-lead-enrichment-routing.md — formulário → Apollo enrichment → IA classifica → Slack routing → HubSpot deal
2. 02-rag-chatbot-suporte.md — base de conhecimento corporativa acessível via chat com eval
3. 03-ai-agent-email-triage.md — agente que lê emails, decide ação e executa via tools

Tasks do squad

Cada task tem entrada, saída e checklist formais em

tasks/

n8n Automation Squad v1.0 — Sellable Edition Schema: squads.sh | Score: 100/100 SAFE