handoff · diff
git:20261017.a83b1b8 to git:20261017.21b1ed6
30 added, 21 removed. Audit A to A.
---
name: handoff
- description: Salva o "onde paramos" no vault pra continuar depois da compactação ou numa janela nova sem perder o fio. Use quando o medidor de contexto avisar, quando o usuário pedir /handoff, ou ao fechar uma etapa grande.
+ description: Salva o "onde paramos" e o conhecimento durável da sessão antes da compactação ou de trocar de janela. Use quando o medidor de contexto avisar, quando o usuário pedir /handoff, ou ao fechar uma etapa grande.
---
# Handoff
- Escreva a nota que você mesmo gostaria de receber se acordasse sem memória no meio deste trabalho. Ela volta pro contexto sozinha depois da compactação (ou do `/clear`), então precisa bastar pra continuar sem reler a conversa.
+ Três passos, nesta ordem, sem parar pra perguntar ao usuário quando foi o medidor que pediu.
- ## Formato
+ ## 1. Registrar o que é durável (`rubi_registrar`)
+ Agora o contexto inteiro está na sua frente e já foi pago, então extrair custa pouco. Registre os fatos desta sessão que valem além da tarefa:
+ - decisões, com o porquê;
+ - bugs, com a causa e a correção;
+ - armadilhas;
+ - conceitos novos;
+ - como fazer.
+
+ Ligue cada fato aos arquivos e aos outros nós. Use `substitui` quando uma decisão mudou.
+
+ ## 2. Resumos que faltam
+
+ Se você entendeu um módulo que está sem resumo no mapa, escreva 2-5 linhas com `rubi_escrever_resumo`.
+
+ ## 3. O handoff (`rubi_salvar_handoff`)
+
+ É a nota que você gostaria de receber se acordasse sem memória no meio do trabalho. Ela volta sozinha depois da compactação.
+
```markdown
# <tarefa em uma linha>
## Objetivo
O que o usuário quer no fim, com as palavras dele quando importar.
## Estado atual
- O que já está pronto e verificado. O que está pela metade (arquivo e ponto exato).
-
- ## Decisões
- - <decisão> — porque <motivo>. (Inclua o que foi descartado, pra não reabrir.)
+ O que está pronto e verificado. O que está pela metade (arquivo e ponto exato).
## Arquivos-chave
- - `caminho/arquivo.ext` — papel dele nesta tarefa
+ - `caminho/arquivo.ext`: papel nesta tarefa
## Próximo passo
- 1. A próxima ação concreta, com o comando ou arquivo.
- 2. ...
+ 1. A próxima ação concreta, com o comando ou o arquivo.
- ## Armadilhas
- - O que já deu errado e como contornar. Preferências do usuário que valem aqui.
+ ## Armadilhas desta tarefa
+ - O que já deu errado aqui e como contornar.
```
- ## Regras
-
- - Concreto: caminhos, nomes de função, comandos, números. Nada de "trabalhamos no módulo".
- - Curto: até ~1.500 palavras. Não reconte a conversa; registre o estado.
- - Não inclua segredos (tokens, senhas, .env).
- - Salve com a ferramenta `rubi_salvar_handoff` (servidor MCP `rubi`).
- - Se foi o medidor que pediu, salve e siga o trabalho sem perguntar nada ao usuário.
- - Se foi o usuário que pediu, diga onde salvou e que ele pode dar `/clear`: o handoff volta sozinho na janela nova.
- - Decisões que valem além desta tarefa também vão pra uma nota permanente (`rubi_salvar_nota`).
+ - Passe também `arquivos` com os arquivos-chave: eles ligam o handoff ao grafo.
+ - Seja concreto (caminhos, funções, comandos) e curto (até ~1.000 palavras). Não reconte a conversa.
+ - Não repita no handoff o que você registrou como fato: o fato já volta pela busca.
+ - Nada de segredos.
+ - Se foi o usuário que pediu, diga onde salvou e que ele pode dar `/clear`, porque o handoff volta sozinho na janela nova.