Inteligência de referência cruzada
O wrapup conecta dados de várias fontes:
- Commits do git cruzados com caixas marcadas das notas
- Decisões ligadas a mudanças no código
- Bugs correlacionados com arquivos modificados
- Estado do loop integrado com progresso das tarefas
Essa referência cruzada cria um quadro completo da sua sessão.
Seções de saída
| Seção | Descrição | Obrigatória |
|---|---|---|
| Feito | Trabalho concluído com evidências | Sim |
| Decisões | Decisões técnicas tomadas nesta sessão | Se houver |
| Alterado | Arquivos-chave e áreas de código modificadas | Sim |
| Em aberto | Trabalho não concluído e itens restantes | Se houver |
| Riscos | Riscos reais identificados | Se houver |
| Próximo | Próximos passos específicos e acionáveis | Obrigatória |
A seção “Próximo”
Essa é a seção mais importante. Ela precisa ser:
- Específica: “Adicionar lógica de refresh token em
src/auth.ts:45”, não “Continuar trabalho de auth” - Acionável: Uma sessão nova lendo só o “Próximo” precisa saber exatamente o que fazer
- Com referência a arquivo: Inclua referências
file:linesempre que possível
Critério de qualidade: “Qual arquivo, qual função, o que falta fazer?”
Detecção de riscos
A seção de Riscos sinaliza problemas reais:
- Mudanças não commitadas que podem se perder
- Tarefas blocked do task loop
- Testes falhando descobertos durante a sessão
- Conflitos de merge pendentes
Avisos genéricos são excluídos — só riscos concretos e específicos da sessão.
Atualização inteligente
Busca um wrapup existente da sessão atual (menos de 3 horas). Se encontrar, atualiza com dados novos. Senão, cria uma nova nota verde. Isso mantém suas notas limpas — sempre o resumo mais recente.
Quando usar
Rode /note-wrapup no fim de uma sessão de trabalho, antes de:
- Mudar para outro projeto
- Fazer uma pausa
- Passar para alguém do time
- Encerrar o dia