Padrão de Handoffs em Fluxos de Trabalho do Claude: Divisão em Dois Arquivos vs. Resumo em Um Documento
Sessões longas no Claude degradam devido à degradação de contexto. Handoffs resolvem isso comprimindo informações-chave em um documento e iniciando um novo agente. Duas implementações estão sendo discutidas na comunidade: a skill /handoff de Matt Pocock e uma abordagem alternativa de divisão em dois arquivos usada no framework multiagente APM.
Skill de Handoff de Matt Pocock
A skill de Pocock compacta a conversa em um único documento. Ela aponta para artefatos existentes em vez de reafirmá-los, e o próximo agente continua a partir daí. Ela também encadeia entre threads: /grill-with-docs → /handoff → /prototype → /handoff de volta. O repositório está disponível em mattpocock/skills.
Abordagem de Divisão em Dois Arquivos (Framework APM)
Uma abordagem alternativa, incorporada ao framework multiagente APM para Claude Code em maio de 2025, divide o handoff em dois artefatos:
- Arquivo de narrativa persistente — registra o que foi feito, decisões tomadas e por quê. Ele reside no projeto e deixa um rastro durável.
- Prompt efêmero — instrui o agente que entra sobre como reconstruir o contexto a partir do código e do arquivo de narrativa persistente.
A principal diferença: o agente que entra reconstrói a partir do estado durável do projeto (código + narrativa), não apenas da conversa compactada. Persistir a narrativa também a torna visível quando vários agentes estão envolvidos, permitindo rastrear qual agente está trabalhando com um resumo versus contexto de primeira mão. Isso facilita o gerenciamento de lacunas de contexto.
O autor abriu uma issue no repositório de Pocock com essas ideias: mattpocock/skills#235.
Questões-chave
- Um único documento compactado é suficiente para handoffs?
- Ou a divisão em dois arquivos (narrativa persistente + prompt efêmero) proporciona melhor reconstrução de contexto e rastreabilidade multiagente?
A discussão continua. Ambas as abordagens são válidas, dependendo se você precisa de um resumo rápido ou de workflows multiagente de longa duração com gerenciamento de lacunas de contexto.
📖 Leia a fonte completa: r/ClaudeAI
👀 See Also
Claude-Skills Maintainer Solicita Feedback sobre Biblioteca de 181 Habilidades de Agentes
Reza, mantenedor do claude-skills, está pedindo feedback da comunidade sobre sua biblioteca de código aberto que contém 181 habilidades de agentes, 250 ferramentas Python e 15 personas de agentes que funcionam em 11 ferramentas de codificação de IA. Ele está questionando se a abordagem de habilidades isoladas é eficaz e quer opiniões sobre habilidades ausentes, agentes baseados em personas e integrações de ferramentas.
PTC construído pelo usuário para Claude Code mostra economia de 40-65% de tokens em tarefas de análise, não em escrita de código.
Um desenvolvedor criou uma implementação local de Chamada Programática de Ferramentas (PTC) chamada Thalamus para o Claude Code e analisou 79 sessões reais, encontrando economia de 40-65% em tokens em tarefas de análise, mas quase zero economia em tarefas de escrita de código. O agente usou execute() principalmente para computação geral em Python, em vez de agrupar chamadas de ferramentas.
Sentinel: Plataforma de Agentes Auto-Hospedada para Assinantes do Claude Code
Sentinel é uma plataforma de agentes gratuita e de código aberto que roda diretamente no seu token OAuth do Claude Code existente, sem sobrecarga de API. Oferece uma interface de operador limpa com automação de navegador em tempo real via VNC integrado e inclui recursos como controle de Git, logs de rastreamento de sessão e memória hierárquica estruturada.
Servidor MCP de Rust de Código Aberto Dá ao Claude Capacidades Completas de Gerenciamento de Email
Um desenvolvedor criou um servidor MCP baseado em Rust que fornece ao Claude 25 ferramentas para gerenciamento abrangente de e-mail, incluindo busca IMAP, envio SMTP, suporte à API Microsoft Graph e gerenciamento de múltiplas contas com autenticação OAuth2.