Skills reais · quality gate · frameworks

O ferramental da fábrica

Moldes de referência, um quality gate que executa de verdade e a documentação dos frameworks aplicados. E o salto da nova versão: squads técnicos saem com 11 skills de engenharia reais embutidas — código que funciona, não placeholder.

4 templates-molde

agent-template (6-level)

Estrutura completa de agente preenchida nos 6 níveis. Use como molde pra entender qual conteúdo cabe em cada nível.

templates/agent-template.md

skill-template (Anthropic format)

SKILL.md com frontmatter oficial, trigger keywords, edge cases e integração com tools. Pronto pra colar na .claude/skills/.

templates/skill-template.md

command-template (slash command)

Slash command pro Claude Code com argumentos, subcomandos e exemplos de uso, em estrutura padronizada.

templates/command-template.md

squad-template (multi-agente)

Squad coordenado: 1 orchestrator + N especialistas + M validadores, com routing matrix, handoff protocol e escalation rules.

templates/squad-template.md

Quality gate executável

O gate roda e bloqueia — e um squad de engenharia de exemplo (api-forge) gerado pela própria fábrica passou com score A+ (9,43/10).

Gate · agente

Agent Quality Gate

Frontmatter completo (name, description, model, tools)
6 níveis preenchidos, sem TODOs
Mínimo 3 examples canônicos input/output
Edge cases documentados (mínimo 3)
Voice DNA consistente em todos os outputs
Constraints e vetos explícitos
Smoke tests rodáveis
Instruções de instalação claras

fora do padrão → bloqueado pelo gate

Gate · skill

Skill Quality Gate

Frontmatter Anthropic completo
"When to use" com triggers explícitos
Examples (mínimo 2 cenários)
Output esperado documentado
Integração com tools/MCPs declarada
Edge cases e fallbacks definidos

fora do padrão → bloqueado pelo gate

4 frameworks documentados

Você lê pra entender por que a fábrica decide do jeito que decide.

framework-react

Paper ICLR 2023 (Shunyu Yao). Reason + Act intercalados — como modelar comportamento de agente.

data/framework-react.md

framework-agentic-patterns

Andrew Ng: Reflection, Tool Use, Planning, Multi-agent — quando usar cada um e combinações eficazes.

data/framework-agentic-patterns.md

framework-anthropic

Documentação oficial: prompt chaining, routing, parallelization, orchestrator-workers, evaluator-optimizer.

data/framework-anthropic.md

framework-willison

Práticas pragmáticas: eval-driven, tools testáveis, prompt simples vence prompt complexo.

data/framework-willison.md

As skills da fábrica são internas — os squads gerados saem com skills reais

Você invoca via /agent-factory e os agentes consultam moldes, gate e frameworks sozinhos. A novidade: squad técnico de engenharia sai com 11 skills de engenharia reais empacotadas. Pra estudar um molde direto: cat templates/agent-template.md