Não percas o teu trabalho com /clear — conhece session-handoff

Se alguma vez terminaste uma longa sessão de depuração, fizeste /clear e, uma semana depois, desejaste lembrar-te de qual das três opções de base de dados a equipa tinha excluído — isto é para ti.

O problema é pequeno, mas caro. Trabalhar com um agente de IA num projeto real produz uma camada de conhecimento que não existe em mais lado nenhum. Porque é que uma determinada biblioteca foi rejeitada. Qual ambiente de staging está avariado. O que é que o utilizador queria realmente dizer com "the gate." Não está no código. Não está no git. Está na conversa. E a conversa está prestes a ser apagada.

O teste de resgate

session-handoff é uma pequena Agent Skill que corre antes de limpares. Analisa a sessão em busca de factos e aplica uma pergunta decisiva:

"Se releres o repositório, isto seria recuperado?"

Se sim, descarta-o — o código é a fonte de verdade. Se não, talvez valha a pena guardar. Essa única heurística elimina cerca de 80% dos falsos guardados e impede que o ficheiro de memória de longo prazo se transforme em ruído.

Como funciona na prática

O fluxo tem sete passos, mas a experiência são dois: escreve um gatilho como "checkpoint before clearing," revê o que seria guardado, aprova. A skill depois escreve entradas estruturadas em markdown — user para função e ambiente, feedback para regras de trabalho, project para objetivos e decisões, reference para referências externas de sistemas — e atualiza um ficheiro de índice de uma linha para que sessões futuras o carreguem de forma barata.

Dois detalhes técnicos que tornam isto realmente utilizável:

• Normalização de datas. "Thursday" é convertido para 2026-05-21 no momento da extração, para que a entrada continue a fazer sentido daqui a três meses.
• Estrutura Why / How. Cada entrada de feedback ou project inclui o motivo (frequentemente um incidente passado) e quando a regra se aplica. Isso permite que o teu eu futuro avalie casos-limite em vez de seguir a nota às cegas.

Quem precisa disto

Se o teu trabalho envolve migrações de longa duração, implementações com múltiplas partes interessadas ou qualquer coisa em que acordos verbais sobrevivem à conversa que os produziu — isto é o que precisas. Líderes de plataforma, SREs, engenheiros contratados a entregar trabalho. Não porque seja engenhoso. Porque a alternativa é reconstruir o que já sabias, mal, três semanas tarde demais.

O repositório é aberto e a skill é pequena o suficiente para ler de uma só vez:

👉 github.com/andreab67/agent-skills/blob/main/session-handoff/SKILL.md