5 agentes · 3 tiers

Os 5 agentes da fábrica.

Squad organizado em 3 tiers. Tier 1: orchestrator único. Tier 2: especialistas executores. Tier 3: validação. Cada um com responsabilidade clara, output específico, handoff documentado.

Tier 1 · Orchestrator

🏭

@factory-chief

Orchestrator · Triage · Routing · Delivery

O que faz: Recebe TODO pedido, faz triage com 3 perguntas-chave, decide pipeline (agente / skill / squad), distribui pra especialistas, coordena handoffs, gerencia entrega final.

Quando chamar: Sempre. É a porta de entrada. Você nunca chama @architect ou @qa-sentinel direto — sempre via factory-chief.

Inputs: Briefing do usuário (idealmente com objetivo, input, output esperados).

Outputs: Pacote final entregue + instruções de instalação.

Frameworks aplicados: Orchestrator-Workers Pattern (Anthropic), Routing (Claude Code).

Tier 2 · Especialistas

🏗️

@architect

Agent Design · 6-level structure

O que faz: Desenha arquitetura 6-level do agente (Loader, Identity, Capabilities, Behavior, Constraints, Examples). Decide patterns aplicáveis (ReAct, Reflection, Tool Use, Planning).

Quando chamar: Etapa 03 do pipeline. Após briefing completo + research. Orquestrado pelo factory-chief.

Frameworks: Hybrid Loader Architecture (Squad Creator Pro), Agentic Design Patterns (Andrew Ng).

✍️

@promptsmith

Persona · Voice DNA · Prompts

O que faz: Escreve persona (background, valores, expertise), voice DNA (vocabulário, tom, gatilhos), exemplos de fala. Garante consistência de identidade através de todos os outputs.

Quando chamar: Etapa 04 do pipeline. Após arquitetura definida. Recebe specs do @architect.

Frameworks: Voice DNA framework (Mind Clones), prompt engineering (Anthropic best practices).

⚒️

@skillforger

Skills · Commands · Tasks

O que faz: Cria SKILL.md no formato oficial Anthropic com frontmatter completo, slash commands, tasks atomicas, integração com tools/MCPs. Pacote pronto pra colar no .claude/.

Quando chamar: Etapa 05 do pipeline. Após persona definida. Pode ser chamado standalone via create-skill.

Frameworks: Anthropic SKILL format spec, Claude Code commands API.

Tier 3 · Validação

🛡️

@qa-sentinel

QA · Smoke Tests · Validation

O que faz: Roda checklist de 8 critérios (frontmatter OK, 6 níveis preenchidos, 3+ examples, edge cases cobertos, voice consistente, no invention, validation rodável, instalação documentada). Roda smoke tests. Calcula score 0-100.

Quando chamar: Etapa 06 do pipeline. SEMPRE. Sem QA, sem entrega. Score < 80 = REPROVADO, devolve pra reescrita.

Inputs: Pacote completo do agente (md + skill + commands).

Outputs: Relatório de qualidade com score + lista de correções priorizadas.

Frameworks: Eval-driven development (Simon Willison), Reflection pattern (Andrew Ng).

Routing matrix

Quem entra primeiro pra cada tipo de pedido:

Pedido	Entrada	Pipeline
Criar agente novo	@factory-chief	1→2→3→4→5→6→7
Criar skill standalone	@factory-chief	1→2→5→6→7 (pula 3+4)
Criar squad multi-agente	@factory-chief	1→2→3→4→5→6→7 (loop por agente)
Validar agente existente	@factory-chief → @qa-sentinel	direto pra QA
Refinar persona	@factory-chief → @promptsmith	direto pra promptsmith
Auditar arquitetura	@factory-chief → @architect	direto pra architect

Workflow padrão

USUÁRIO
  ↓
@factory-chief (briefing + triage + research)
  ↓
@architect (arquitetura 6-level)        [PARALELO]
  ↓                                    ↓
@promptsmith (persona + voice DNA)
  ↓
@skillforger (SKILL.md + commands)
  ↓
@qa-sentinel (smoke tests + score 0-100)
  ↓
APROVADO? → @factory-chief (delivery)
REPROVADO? → volta pro especialista que falhou