Skill · paralelo × sequencial × híbrido

Decida a arquitetura antes de criar agentes

Uma skill que escolhe entre sequência, paralelismo e fluxo híbrido antes de executar — menos tokens, menos retrabalho, mais consistência.

Comparativo: paralelismo mal usado vs sequência inteligente com automação em paralelo
O que é

Uma etapa de arquitetura antes de trabalhos complexos

Agentes demais relendo o mesmo contexto desperdiçam tokens; sequência cega desperdiça tempo. A skill decide conscientemente — e só depois executa.

🚪 Portão de proporcionalidade

Primeira decisão: a tarefa exige divisão, múltiplos executores ou contexto extenso? Se não, executa direto — sem burocracia de plano.

⚖️ Matriz de decisão

Sinais pontuados para sequencial e paralelo, com limiar objetivo: diferença ≥ 2 pontos decide; empate ou diferença menor → híbrido.

💸 Executor mais barato

Script para o mecânico, modelo econômico para o estruturado, modelo avançado só para estratégia e criação. Nunca um agente esperando render.

Como funciona

Do pedido ao plano — antes do primeiro subagente

O fluxo separa raciocínio de execução: centraliza decisões, registra o contexto uma vez, automatiza o mecânico e paraleliza só o que é realmente independente.

Pedido Portão de proporcionalidade Decompor Matriz de decisão Plano compacto Execução Revisão central
1

Sequencial

Tarefas dependentes ou com muito contexto compartilhado. O aprendizado de uma etapa alimenta a seguinte.

2

Paralelo

Tarefas independentes, entradas congeladas, contexto pequeno por tarefa. Renders e conversões viram scripts em paralelo.

3

Híbrido

Padrão para projetos grandes: planejamento centralizado, especificação única, execução independente em paralelo, revisão central.

Pré-requisitos

O que você precisa

A skill é um pacote de arquivos Markdown — funciona em qualquer agente que suporte skills. O script de teste usa a CLI do Claude Code.

Um agente com skills

Claude Code, ChatGPT (upload do zip) ou Codex. O núcleo é universal; os mapeamentos por plataforma estão em references/.

# conferir a CLI (para Claude Code)
claude --version

Git

Para clonar o repositório com a skill, o guia e o script de teste.

git clone https://github.com/inematds/agenteexecuta

Bash (opcional)

Só para rodar o teste comportamental baseline × com skill.

bash --version
Guia de uso · passo a passo

Instalar e usar a skill

Do clone à validação comportamental, com comandos reais.

1

Clone o repositório

A skill vive na pasta arquiteto-de-execucao/, com SKILL.md, referências e script de teste.

git clone https://github.com/inematds/agenteexecuta
cd agenteexecuta
2

Instale no Claude Code

Copie a pasta da skill para o diretório de skills do usuário. Ela passa a ser acionada automaticamente antes de trabalhos com subagentes ou lotes.

cp -r arquiteto-de-execucao ~/.claude/skills/  # disponível na próxima sessão
3

Ou instale no ChatGPT / Codex

Use o zip pronto — ele inclui o agents/openai.yaml com a configuração de interface para o ecossistema OpenAI.

# suba este arquivo na criação da skill/GPT:
arquiteto-de-execucao-v2.zip
4

Use num trabalho grande

Peça uma tarefa com múltiplas entregas. A skill produz o plano compacto ANTES de criar qualquer subagente — estratégia, o que é sequencial/paralelo, executores, limites e risco principal.

# exemplo de pedido que ativa a skill:
"Produza 15 vídeos curtos da série X usando agentes. O guia de estilo tem 40 páginas."
5

Em dúvida, consulte a matriz

Sinais pontuados e limiar objetivo, com exemplos resolvidos (15 vídeos, pesquisa de mercado, migração, 500 arquivos).

cat arquiteto-de-execucao/references/decision-matrix.md
6

Valide o comportamento (baseline × com skill)

O script roda os 3 cenários de teste em modo headless e salva as respostas para leitura manual contra os critérios de references/test-scenarios.md.

./arquiteto-de-execucao/scripts/test-skill.sh              # fumaça: cenário 1, 1 rep
./arquiteto-de-execucao/scripts/test-skill.sh all both 5   # bateria completa
Exemplos

O princípio em números — e o plano que a skill produz

A economia não vem de "sequencial ser sempre melhor": vem de amortizar o custo do contexto compartilhado.

💰 Custo do contexto repetido

# 3 agentes relendo o mesmo material:
3 × (50k contexto + 20k execução) = 210k tokens

# 1 executor reutilizando o contexto:
50k + 20k + 20k + 20k = 110k tokens

📋 Plano compacto (saída da skill)

Estratégia: híbrida.
Sequencial: planejamento, spec e revisão final.
Paralelo: tarefas independentes e mecânicas.
Executores: avançado p/ decisões; econômico
  p/ checklist; scripts p/ render.
Contexto: PROJECT-SPEC.md + CHECKLIST.md.
Limites: 3 subagentes, 2 tentativas,
  retrabalho só dos reprovados.
Roadmap

Evolução da skill

Da versão monolítica à skill enxuta com validação comportamental.

v1
Skill originalMetodologia completa num SKILL.md extenso — bom conteúdo, mas corpo inchado, description ampla demais e sem "quando não usar".
v2
Versão atual — painel de controlePortão de proporcionalidade, description bilíngue focada em gatilho, corpo enxuto (~400 palavras), matriz com limiar objetivo, referências por plataforma (Claude Code, ChatGPT/Codex) e script de teste baseline × skill.
v3
Próximos passosBateria completa de validação (5+ repetições por cenário), condições vetadoras na matriz (dependência instável veta paralelismo, independente da soma) e ajuste do discurso conforme o ganho real medido sobre o baseline.