Template de handoff de sessão no Claude Code: deixe contexto reutilizável para outra pessoa ou agente

Claude Code fica melhor quando a sessão sobrevive ao handoff

Muitas falhas vêm de contexto perdido entre sessões. Uma nota de handoff permite que outra pessoa, ou você amanhã, continue sem adivinhar.

Este artigo conecta o runbook da primeira tarefa ao template de bug report.

Template de handoff

# Claude Code Handoff

## Goal
- Objetivo de hoje:
- Não fazer hoje:

## Current state
- branch:
- last commit:
- dirty files:
- URLs relacionadas:

## What changed
- Mudanças:
- Arquivos tocados:
- Intenção:

## Verification
- Comandos executados:
- Resultado:
- Revisão visual:

## Risks
- Áreas frágeis:
- Não tocar:
- Não verificado:

## Next prompt
Na próxima sessão, comece com git status e o diff recente.
Confirme que não contradizem este handoff antes de editar.

Bom exemplo

## Goal
- Adicionar links internos de /en/products/ para os 3 artigos de 25/5
- Não alterar a estrutura de pricing hoje

## Verification
- npm.cmd run build: sucesso
- production /en/products/: 200
- mobile 390px: sem overflow horizontal

## Risks
- Gumroad link prioriza inglês
- Conferir corpos não ingleses em URL pública

Omissões comuns

• Escrever só build OK sem URL pública
• Deixar dirty files sem explicação
• Esconder pendências com “parece OK”
• Não deixar o próximo prompt

Handoff não é diário. Ele deve permitir reiniciar em 5 minutos.

Próximo passo

Para uso individual, fixe o ritual com o cheatsheet gratuito. Para equipes, combine Setup Guide e Prompt Templates. Para adoção guiada, veja consultoria.

Handoff deve ser mais completo que commit message e mais curto que diário

A nota de handoff é dado operacional. Commit message costuma faltar verificação e riscos; diário é longo demais. Guarde estado atual, motivo da mudança, verificação, áreas frágeis e próximo prompt.

Revise este handoff:
1. não contradiz git status
2. o motivo cabe em uma frase
3. build e URL pública estão separados
4. riscos não verificados estão explícitos
5. o próximo prompt permite continuar

Em site multilíngue, registre URL pública, idioma, largura mobile e estado dos CTAs. Build aprovado não prova que a página pública está correta.