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.