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
Cocall.ai MCP: Chamadas Telefônicas de Saída com Encaminhamento para Humano em Tempo Real
Cocall.ai é um MCP para Claude que permite fazer chamadas telefônicas de saída com um modelo de fala para fala full-duplex. Ele pode pausar uma chamada no meio para fazer uma pergunta específica em vez de adivinhar, navegar por menus IVR e transferir chamadas para você quando necessário.
Hippo v0.21.0: Memória Bioinspirada para Agentes de IA com Suporte a Múltiplas Ferramentas
O Hippo v0.21.0 introduz configuração com um único comando para várias ferramentas de programação com IA, incluindo Claude Code, OpenCode, OpenClaw, Codex, Cursor e Pi. O sistema de memória apresenta decaimento, fortalecimento de recuperação e consolidação sem dependências de tempo de execução.
Ferramenta Local RAG Construída com Nemotron Nano 9B v2 e Chamada de Ferramentas vLLM
Um desenvolvedor criou uma ferramenta de pesquisa RAG local-first que roda inteiramente em uma única GPU usando Nemotron Nano 9B v2 Japanese no vLLM com plugins de parser personalizados para chamadas de ferramentas. O sistema apresenta um fluxo de extração-execução em duas etapas com extração de palavras-chave bilíngue e busca paralela FTS5/DuckDuckGo.
A extensão OpenClaw roteia solicitações através do Claude Code CLI em vez da API
Uma extensão do OpenClaw inicia o binário CLI do Claude como um subprocesso, roteando solicitações através do Claude Code CLI em vez da API da Anthropic. Isso oferece a experiência completa do Claude Code pela taxa fixa de um plano máximo.