| name | handoff |
| description | Use ao PAUSAR/encerrar uma sessão de trabalho (grava o estado atual em docs/STATE.md para retomar depois) ou ao RETOMAR (lê docs/STATE.md e a spec ativa e recompõe o contexto, propondo o próximo passo). Mantém a continuidade entre sessões de humanos e agentes. Acione com /handoff. |
Skill: Handoff de sessão (pause / resume)
Mantém a continuidade do projeto via docs/STATE.md — a memória de trabalho volátil
(diferente do ADR, que é decisão durável). Detecte a intenção pelo pedido ou pergunte.
Modo PAUSE (pausar / encerrar)
Atualize docs/STATE.md com o estado real desta sessão:
- Em andamento / próximo passo — a feature/spec ativa e a próxima ação concreta
(específica: "implementar AC-3 no adapter X", não "continuar a feature").
- Decisões recentes — o que foi decidido. Se for difícil de reverter, crie/atualize o ADR
e linke; o STATE só resume.
- Bloqueios — o que trava e quem/como destrava.
- Ideias adiadas / todos — o que ficou de fora de propósito, com o gatilho para reconsiderar.
- Consolide
docs/lessons.md (condicional — só se houve aprendizado): a captura das lições é
inline durante o trabalho, não aqui. No handoff você revisa e poda: alguma lição duplicada?
alguma já estabilizou → promova pro destino durável (ADR / glossary / CLAUDE.md / TESTING)
e remova de lessons.md, deixando só o link em "Promovidas". Não force entradas vazias.
- Marque a data e o autor. Se houver
SPEC_DEVIATION aberto, registre como bloqueio.
- Ofereça um commit (
docs: handoff — atualiza STATE) se for repositório git.
Seja conciso e acionável. O STATE é para alguém (ou um agente) retomar frio amanhã.
Modo RESUME (retomar)
- Leia
docs/STATE.md e a spec.md/tasks.md da feature ativa citada nele.
- Se houver MCP conectado e relevante (Jira/Confluence), e a trava de conta estiver validada,
atualize o contexto com o que mudou lá fora.
- Resuma onde paramos em poucas linhas: feature ativa, último passo, bloqueios abertos.
- Proponha o próximo passo (o "Em andamento / próximo passo" do STATE) e confirme com o
usuário antes de executar.
Regras
- STATE.md é volátil; ADR é durável. Não escreva decisão estrutural só no STATE.
lessons.md é staging: no handoff só consolida/poda — a captura é inline durante o trabalho.
Lição que estabilizou tem que sair de lá; se está só crescendo, a poda falhou.- Não invente progresso: relate fielmente o que foi feito, o que falta e o que está bloqueado.
