Fase 06 · Orquestração
MCP, Subagents e a arquitetura de contexto
Conectar a IA às ferramentas do time e entender como todas as peças se encaixam ao redor do agente.
6.1 MCP — "o que você pode acessar"
O Model Context Protocol conecta o agente a ferramentas externas: APIs, bancos de dados, serviços. As descrições são carregadas quando conecta. Exemplos:
- Google Drive MCP — acessa/edita arquivos no Drive
- PostgreSQL MCP — query no banco, migrations
- Slack MCP — envia mensagens, lê canais
Não use MCP para
- Regras de código (isso é AGENTS.md)
- Workflows internos (isso é Skill)
- Coisas que não precisam de API externa
6.2 Fluxo real: bug investigado com MCPs
Bug no módulo billing — "cálculo errado de impostos em clientes internacionais"
- Git MCP — lê os últimos commits no módulo
- Jira MCP — puxa o ticket [JIRA-321] com o relato
- Datadog MCP — encontra nos logs:
TaxOverride not found 'EU' - Análise — o agente cruza código, logs e ticket e propõe a solução
Sem MCPs, esse cruzamento é você copiando e colando de 3 abas. Com MCPs, é um prompt.
6.3 Subagents — delegação com contexto isolado
- Cada subagent tem contexto isolado próprio (não polui o contexto principal)
- Podem usar modelos diferentes (mais barato para busca, mais forte para arquitetura)
- Bons para debugging, exploração e arquitetura em paralelo
- Fluxo: o agente principal delega → recebe resumo; subagents não spawnam outros
6.4 A arquitetura completa
Ao redor do agente principal (orquestrador) — que recebe suas instruções, consulta regras e docs, delega tarefas — orbitam:
| Peça | Papel | Quando carrega |
|---|---|---|
| Rules | Estilo de código, convenções, restrições de segurança | Sempre / sob demanda |
| AGENTS.md | Arquitetura, decisões de design, como o sistema funciona | Sempre presente |
| Skills | Workflows especializados, executados no contexto principal | Sob demanda |
| MCP | Ferramentas externas (APIs, bancos, Slack…) | Ao conectar (descrições sob demanda) |
| Subagents | Especialistas com contexto isolado; devolvem resumo | Quando delegado |
Checklist da fase
Marque cada item ao concluir. O progresso fica salvo neste navegador.