Orchestrador de Subagentes

Uma habilidade de coordenação paralela e ciente de cotas para Antigravity 2.0. Transforma uma grande tarefa em um conjunto de missões de agente isoladas e eficientes — sem estourar sua cota semanal.

Use esta habilidade quando

• A tarefa abrange 3+ arquivos ou componentes
• Você quer que vários agentes trabalhem ao mesmo tempo
• Você já atingiu problemas de cota no meio de uma tarefa
• A tarefa envolve tanto planejamento QUANTO construção
• Você precisa que o agente de navegador + agente de código + agente de terminal rodem juntos

Não use esta habilidade quando

• Editando um único arquivo ou corrigindo um bug
• Escrevendo um script rápido com menos de 50 linhas
• Fazendo apenas uma pergunta ou gerando um plano

Fase 1 — DECOMPOSIÇÃO (antes de qualquer agente rodar)

Antes de iniciar qualquer subagente, o orquestrador DEVE produzir um Resumo da Missão. Anuncie:

"Executando habilidade subagent-orchestrator. Decompondo tarefa em missões isoladas."

Em seguida, exiba um Resumo da Missão neste formato:

MISSION BRIEF
─────────────────────────────────────────
Goal: [one sentence, what done looks like]
Total Agents: [N]
Quota Strategy: [FLASH / SONNET / MIXED]
Expected Token Cost: [LOW / MEDIUM / HIGH]

AGENTS:
[1] ID: agent-001
    Role: [e.g. Planner / Builder / Tester / Browser]
    Scope: [exact files or URLs this agent touches]
    Model: [Gemini Flash / Claude Sonnet]
    Input: [what it receives]
    Output: [what it produces]
    Depends on: [none / agent-001]

[2] ...
─────────────────────────────────────────

Aguarde a aprovação do usuário no Resumo da Missão antes de prosseguir. Se o usuário editar, atualize e reconfirme. Nunca pule esta etapa.

Fase 2 — ROTEAMENTO DE COTA

Antes de atribuir modelos, aplique esta árvore de decisão:

Is this task > 20 files OR > 500 lines of new code?
  YES → Use Gemini Flash for all agents. Reserve Sonnet for final review only.
  NO  → Is this task creative UI / complex logic / API design?
          YES → Use Sonnet for builder agent, Flash for all others.
          NO  → Use Gemini Flash for everything.

Regras de custo de modelo (nunca viole estas):

• Claude Opus → NUNCA use em subagentes. Muito caro.
• Claude Sonnet → Máximo de 1 subagente por missão.
• Gemini Flash → Padrão para todos os subagentes. Rápido, barato, pool de cota separado.
• Subagente de navegador → Sempre roda em seu próprio pool. Use com moderação (máximo 1 por missão).

Fase 3 — ISOLAMENTO DE CONTEXTO

Cada subagente recebe um pacote de contexto com escopo. Nunca dê a todos os agentes a base de código completa.

Para cada agente, prepare:

AGENT CONTEXT PACKET — agent-[ID]
Files to read: [list only what this agent needs]
Files to write: [list only what this agent will create/edit]
Do NOT read: [explicitly exclude irrelevant files]
Knowledge: [paste only the relevant section of GEMINI.md]

Regra: Se um agente não precisar de node_modules, package-lock.json, .next/ ou dist/ — adicione-os a um .antigravityignore antes que o agente rode.

Fase 4 — EXECUÇÃO PARALELA

Inicie os agentes na ordem de dependência:

Round 1 (no dependencies): Run agents in parallel
Round 2 (depends on Round 1): Wait for all Round 1 outputs, then run
Round 3 (final): Integrate + verify

Entre as rodadas, o orquestrador DEVE:

1. Coletar o artefato de saída de cada agente
2. Executar uma verificação pontual de 3 pontos:
   • O agente permaneceu dentro de seu escopo atribuído?
   • Existem conflitos de importação/exportação com as saídas de outros agentes?
   • Algum agente produziu um placeholder ("TODO", "implementar depois")?
3. Se alguma verificação falhar → reexecute esse agente com o contexto corrigido. NÃO continue.

Fase 5 — RECUPERAÇÃO DE ERROS

Se um subagente falhar ou produzir saída quebrada:

RECOVERY PROTOCOL
─────────────────────────────────────────
1. Do NOT re-run the full mission.
2. Identify the exact failure point.
3. Spawn a single repair agent with:
   - Only the broken file(s) as scope
   - The error message as context
   - Model: Gemini Flash (cheapest for repairs)
4. Validate the repair before continuing.
─────────────────────────────────────────

Nunca propague uma saída quebrada para o próximo agente. Sempre corrija antes de seguir em frente.

Fase 6 — VERIFICAÇÃO DE INTEGRAÇÃO

Após todos os agentes completarem, execute uma varredura final de integração:

• Todas as importações resolvem corretamente
• Nenhum nome de função/variável duplicado entre arquivos
• Nenhum valor codificado que deveria ser variáveis de ambiente
• Nenhum console.log deixado em arquivos de produção
• Tipos são consistentes entre componentes (TypeScript)
• A compilação seria bem-sucedida (npm run build verificado mentalmente)

…