program-ai-memory-handoff

<!-- ai-memory-managed: routing-skill --> # ai-memory Session Continuity & Handoffs Esta skill orienta a passagem de bastão (*handoff*) entre sessões e agentes de IA utilizando o [ai-memory](https://github.com/akitaonrails/ai-memory). Os handoffs são transitórios e de uso único, destinados a preservar o estado mental e os próximos passos para a sessão seguinte, não devendo ser confundidos com documentação perene de wiki. --- ## 🧰 Ferramentas deste Cluster - `memory_handoff_accept`: Consome o handoff pendente quando o usuário questiona "onde paramos?" e o bloco injetado no início da sessão não estiver visível. - `memory_handoff_begin`: Cria um handoff conciso de transição quando a sessão está sendo encerrada ou quando o usuário pede explicitamente para salvar o contexto para a próxima execução. - `memory_handoff_cancel`: Invalida um handoff pendente criado por engano através do seu `handoff_id` exato. --- ## 🔄 Ciclo de Vida do Handoff 1. **Injeção Automática no Início da Sessão**: - Os hooks de ciclo de vida (`session-start`) buscam e consomem automaticamente o handoff pendente, injetando-o no contexto inicial do modelo com a marcação `📥 ai-memory: pending handoff`. - Se essa mensagem já constar no contexto, responda a partir dela diretamente e **não** chame `memory_handoff_accept` novamente (pois handoffs são de uso único). 2. **Criação ao Fim da Sessão**: - Chame `memory_handoff_begin` apenas no encerramento da conversa ou por solicitação explícita. - Mantenha o sumário ultra-conciso (2 a 3 frases) e concentre os detalhes nos pontos de dúvidas abertas (*open questions*) e próximos passos (*next steps*). 3. **Compartilhamento**: - Por padrão, o handoff pertence ao operador que o gerou. Utilize `shared: true` apenas quando solicitado expressamente que qualquer operador do projeto possa receber a transição.