O que handoff faz?
Escreva um documento de handoff que permita a um novo agente continuar este trabalho sem reler toda a conversa. Capture o estado e a intenção, não uma transcrição.
Onde salvar
Salve o handoff dentro do repositório do projeto atual — nunca no diretório temporário do SO, nunca inline no chat.
- Resolva a raiz do repositório: execute
git rev-parse --show-toplevel. Se falhar (não é um repositório Git), use o diretório de trabalho atual como fallback. - Garanta que um diretório
handoffs/exista nessa raiz; crie-o se estiver faltando. - Escreva em
handoffs/<slug>-handoff-<timestamp-UTC>.md, onde:<slug>é um tópico curto em kebab-case derivado da tarefa (ou dos argumentos, se algum foi passado), ex.:notebook-proxy-review.<timestamp-UTC>éYYYYMMDDTHHMMSSZ, ex.:20260527T144059Z. O timestamp mantém cada handoff distinto — nunca sobrescreva um handoff existente.
- Após escrever, imprima o caminho absoluto do arquivo que você criou.
O que escrever
Se argumentos foram passados para esta skill, trate-os como o foco da próxima sessão e direcione cada seção para eles.
Use estas seções. Mantenha cada uma dentro de seu limite; um handoff é um documento de referência, não um registro de tudo. Omita qualquer seção que esteja genuinamente vazia em vez de preenchê-la.
- Cabeçalho — título, data (UTC) e uma linha sobre para que serve a próxima sessão. (≤5 linhas)
- Objetivo — a meta e seu critério de sucesso. (≤3 frases)
- Estado atual — o que está feito, o que funciona, o que está verificado vs. assumido. (≤10 itens)
- Próximos passos — ações concretas e ordenadas para o próximo agente. (≤8 itens)
- Decisões-chave e justificativa — escolhas já feitas e o porquê, para que o próximo agente não as reabra. (≤8 itens)
- Armadilhas / minas terrestres — problemas já encontrados, surpresas, coisas que parecem prontas mas não estão. (≤8 itens)
- Arquivos e referências relevantes — caminhos e URLs para código, PRDs, planos, diffs, issues. Referencie-os; não inclua seus conteúdos inline. (≤12 entradas)
- Perguntas em aberto — decisões não resolvidas que precisam do usuário ou de trabalho adicional. (≤6 itens)
- Skills sugeridas — skills que o próximo agente deve invocar, cada uma com uma linha explicando por quê. (≤6 entradas)
Regras
- Não duplique conteúdo já capturado em outros artefatos (PRDs, planos, ADRs, issues, commits, diffs). Em vez disso, faça referência a eles por caminho ou URL.
- Não cole conteúdos grandes de arquivos ou saída completa de comandos no handoff. Aponte para a origem.
- Remova segredos e PII — qualquer coisa que corresponda a API_KEY / SECRET / TOKEN / PASSWORD / PRIVATE_KEY ou dados pessoais. Caminhos de arquivos locais são aceitáveis.