encerrar-sessao

name: encerrar-sessao description: Executar protocolo sistematico de encerramento de sessao do Cowork, assegurando que contexto, decisoes e artefatos produzidos tenham continuidade nas sessoes futuras. Faz inspecao de memory/today.md (arquivamento se > 100 linhas), atualizacao de state.md, revisao de decisoes-pendentes.md, verificacao de auto-memory, checagem de handoffs pendentes ao Claude Code, sugestao de registro de ADR se houver decisao, e checkpoint reflexivo (integra skill reflexao-pesquisa). Use SEMPRE que o usuario sinalizar encerramento ("encerrar sessao", "terminando aqui", "vamos fechar", "protocolo de encerramento", "fim de sessao", "reforcar encerramento"), ou quando detectar sinais de encerramento iminente (usuario pedindo resumo, revisao do que foi feito, ou expressando que vai parar). Tambem ativar proativamente quando a sessao tiver produzido 2+ artefatos substantivos ou 1+ decisao externa pendente e o usuario sinalizar encerramento.

Protocolo de Encerramento de Sessão

Skill para garantir que sessões produtivas do Cowork não se dissipem — que tudo o que foi discutido, decidido e produzido cause impacto nas sessões futuras. Complementa (não substitui) a skill reflexao-pesquisa.

Por que esta skill existe

A perda de continuidade entre sessões é um dos modos de falha mais recorrentes no projeto (registrado historicamente em MF-013 — Memory Bloat). As causas típicas:

1. Artefatos produzidos sem registro em memory/ — a sessão foi rica mas today.md não reflete
2. Decisões externas pendentes esquecidas — a Senadora, o orientador, o CEP têm "bolas no ar" que ninguém rastreia
3. Auto-memory desatualizada — o próximo Claude Cowork não sabe do que foi discutido
4. Handoffs não preparados — artefatos ficam no workspace local, não chegam ao repo-alvo
5. ADRs não registradas — decisões substantivas se dissolvem em prosa

Esta skill é a lista de checagem institucional contra esses modos de falha. Executada ao final de cada sessão, assegura que os mecanismos de continuidade foram alimentados.

Precedente do mecanismo: criada em 2026-04-18 após sessão rica sobre Plano de Governo (Anexo Metodológico Gaetani + Pacote de Triagem de Declarações), em resposta ao pedido explícito do Henrique de "protocolo de encerramento reforçado" para que o trabalho da sessão causasse impacto nas futuras.

Quando Ativar

Triggers explícitos (usuário sinaliza):

• "vamos encerrar", "terminando por aqui", "fechar a sessão"
• "protocolo de encerramento", "encerrar com cuidado", "reforçar encerramento"
• "resumir o que fizemos", "fazer o balanço", "checkpoint"

Triggers proativos (detectar sem ser pedido):

• Sessão produziu 2+ artefatos substantivos (documentos, decisões, estruturas)
• Sessão gerou 1+ decisão externa pendente (Senadora, orientador, CEP)
• Sessão modificou estrutura do repo/ecosistema (ADR nova)
• Usuário começa a falar em tom conclusivo ("foi produtivo", "muito bom", "acho que foi isso")

Ao ativar, informar o usuário de que está executando o protocolo e listar as etapas que vão ocorrer.

Protocolo de 7 Passos

Executar nesta ordem. Cada passo tem critério de saída explícito.

Passo 1 — Inventário da Sessão (2-3 min)

Fazer balanço estruturado do que a sessão produziu:

1. Artefatos criados: listar arquivos novos com caminho absoluto
2. Artefatos modificados: listar arquivos alterados
3. Decisões tomadas: o que foi decidido internamente (não precisa deliberação externa)
4. Decisões pendentes: o que precisa deliberação de outro ator (Senadora, orientador, CEP, colegas)
5. Handoffs implicados: artefatos que precisam ir para algum repo-alvo (via _cowork-inbox/)

Critério de saída: lista numerada dos 5 itens acima, na mensagem ao usuário.

Passo 2 — Checagem e Arquivamento de today.md (2 min)

Objetivo: assegurar que today.md não ultrapasse ~100 linhas (regra CLAUDE.md). Se ultrapassou, mover conteúdo antigo para archive/sessoes-[AAAA-MM-DD].md.

Comandos de referência (bash):

# Contar linhas do today.md
wc -l /sessions/*/mnt/Claude-Cowork-Doutorado/.claude/memory/today.md

# Se > 100 linhas, separar conteúdo: manter últimas entradas em today.md, mover resto para archive/

Decisão:

• Se today.md < 80 linhas: apenas adicionar bloco da sessão atual
• Se today.md > 100 linhas: arquivar entradas anteriores em archive/sessoes-[data].md, manter só sessão atual

Formato padrão do bloco de sessão atual em today.md:

## Sessão [DATA] — [Título sintético]

**Artefatos produzidos:**
- [lista]

**Decisões internas:**
- [lista]

**Decisões pendentes (externas):**
- [ver decisoes-pendentes.md item D-XXX]

**Próximos passos:**
- [lista]

Critério de saída: today.md atualizado com bloco da sessão, contagem de linhas confirmada ≤ 100.

Passo 3 — Atualização de state.md (3 min)

state.md é o snapshot estrutural do projeto (estado dos repos, ADRs contadas, Banco de Insights contado, Plano de Governo status). Atualizar somente o que mudou na sessão.

Seções típicas a revisar:

• Marcos Recentes (adicionar novo marco para a sessão)
• ADRs (incrementar contador se foi criada ADR nova)
• Banco de Insights (incrementar se foram adicionadas fichas)
• Status de subprojetos (ex.: linha "Plano de Governo")

Comandos de referência: Edit tool com old_string/new_string para updates pontuais. Para inserção de seção nova (ex.: "Marcos Recentes"), preferir bash com Python heredoc se o Edit estiver bloqueado.

Critério de saída: state.md reflete o estado real do projeto após a sessão.

Passo 4 — Revisão de decisoes-pendentes.md (3 min)

Este arquivo rastreia as "bolas no ar" aguardando decisão externa. Executar:

4.1 Algum item foi resolvido nesta sessão? Se sim, mover para archive/decisoes-resolvidas.md e registrar a resolução (data + substância + link para eventual ADR).

4.2 Alguma decisão externa nova surgiu nesta sessão? Se sim, adicionar item novo com ID (D-XXX), título, ator-decisor, contexto, opções em aberto, e "Como retomar em sessão futura" (passo-a-passo para o próximo Claude).

4.3 Itens antigos precisam de atualização? Se algum artefato relevante ao item foi produzido, anexar ao item.

Formato de item:

### D-XXX — [Título]
**Status:** Aguardando [ator] | **Criado:** [data] | **Revisão sugerida:** [data]
**Contexto:** [o que motivou]
**Opções em aberto:** [lista]
**Artefatos relacionados:** [caminhos]
**Como retomar em sessão futura:**
1. [passo]
2. [passo]

Critério de saída: decisoes-pendentes.md reflete o estado real das bolas no ar.

Passo 5 — Verificação de Auto-Memory (2 min)

Auto-memory (em spaces/.../memory/) persiste entre conversas do Cowork e é mais durável que memory/ (que é parte do repo). Avaliar:

5.1 A sessão gerou informação relevante para sessões futuras que não é derivável do código/git? Exemplos:

• Preferências ou ambições pessoais do Henrique (ex.: Nova Secretaria)
• Pacotes produzidos aguardando deliberação externa
• Pivôs estratégicos ou mudanças de rumo
• Precedentes de protocolo/mecanismo ("isto foi criado em resposta a X")

Se sim, criar/atualizar auto-memory file na pasta spaces/.../memory/ e adicionar pointer em MEMORY.md.

5.2 Auto-memories antigas precisam de atualização? Se a sessão modificou realidade de alguma auto-memory (ex.: "Progresso em [data]:"), atualizar.

Tipos disponíveis (conforme auto memory system): user, feedback, project, reference.

Critério de saída: MEMORY.md consistente; auto-memories que descrevem a sessão atual estão presentes.

Passo 6 — Handoffs Pendentes ao Claude Code (variável)

Objetivo: identificar artefatos que precisam ir para repo-alvo via _cowork-inbox/.

6.1 Algum artefato da sessão vai para repo no GitHub? Típico: documentos do 04-plano-governo/, fichas de 06-banco-insights/, ADRs em .claude/memory/decisions.md.

6.2 O handoff tem urgência?

• Alta: se a sessão produziu artefato que bloqueia outro trabalho (ex.: ADR aprovada)
• Média: se há acúmulo de 3+ artefatos prontos
• Baixa: se há apenas um artefato e não há pressa

6.3 Se há handoff a preparar: sugerir invocação da skill handoff-cowork-cc imediatamente ou registrar no bloco "Próximos passos" do today.md.

Critério de saída: usuário está ciente dos handoffs pendentes e decidiu quando executar.

Passo 7 — ADR e Checkpoint Reflexivo (3-5 min)

7.1 A sessão gerou decisão substantiva que merece ADR?

Critérios para ADR (registrado em .claude/memory/decisions.md):

• Decisão arquitetural (estrutura de pastas, protocolo novo)
• Decisão de escopo (o que entra/não entra na tese)
• Decisão metodológica (como algo será feito daqui em diante)

Se sim, sugerir redação de ADR-XXX no formato simplificado (contexto, decisão, alternativas, consequências).

7.2 Checkpoint reflexivo (se ainda não foi feito nesta sessão)

Invocar as 3 perguntas da skill reflexao-pesquisa (P1 dado de pesquisa, P2 conexão com PS/OE, P3 aprendizado) e registrar respostas ao final do bloco da sessão em today.md.

Se o contador de sessões sem reflexão profunda atingir 3+, sugerir sessão de Reflexão Profunda (Modo 2 da skill reflexao-pesquisa) como próxima atividade.

Critério de saída: usuário recebeu oferta de ADR e checkpoint reflexivo foi realizado.

Formato da Mensagem de Encerramento

Ao completar os 7 passos, produzir mensagem final estruturada:

## Protocolo de Encerramento — [DATA]

### 1. Inventário da sessão
[lista estruturada de artefatos/decisões]

### 2. Memory/ atualizada
- today.md: [status, contagem de linhas]
- state.md: [o que foi atualizado]
- decisoes-pendentes.md: [itens novos/resolvidos]

### 3. Auto-memory
- [arquivos criados/atualizados em spaces/]

### 4. Handoffs pendentes
- [lista com urgência]

### 5. ADR sugerida
- [se aplicável]

### 6. Checkpoint reflexivo
- P1: [...]
- P2: [...]
- P3: [...]

### 7. Para a próxima sessão
- [3-5 próximos passos ordenados por prioridade]

Integração com Outras Skills

Indicadores de Qualidade do Protocolo

Para monitorar se o próprio protocolo está funcionando:

TODO — Aperfeiçoamentos Pendentes (v1.0 -> v2.0)

Esta skill foi criada em 2026-04-18 em sua versão 1.0, com o compromisso explícito de voltar para aperfeiçoá-la após 2-3 usos in vivo. Pontos de atenção:

1. Automatização parcial: atualmente o protocolo descreve passos, mas muitos dependem de avaliação do Claude em cada sessão. Avaliar se alguns podem ser scriptados (ex.: contagem automática de linhas do today.md, sugestão automática de arquivamento).

2. Métricas de calibração: os "Indicadores de Qualidade" acima são chutes iniciais. Após 3 sessões usando a skill, revisar se os limiares fazem sentido empírico.

3. Integração com INDEX.md de subprojetos: quando a sessão toca um subprojeto com INDEX próprio (ex.: 04-plano-governo/INDEX.md), o protocolo deve atualizar o INDEX também. Ainda não explicitado.

4. Gatilho proativo refinado: a heurística "2+ artefatos substantivos" é grosseira. Calibrar com casos reais.

5. Mecanismo anti-ritualização: risco de o protocolo virar ritual vazio (checar caixas sem substância). Incluir perguntas que forçam o Claude a explicar o porquê de cada movimento, não só relatar.

6. Captura de sinais não-ditos: casos em que o usuário não sinaliza encerramento mas a sessão claramente acabou (última interação foi há X minutos, contexto está saturado). Heurística a desenvolver.

7. Teste adversarial: após 2-3 usos, fazer simulação: "se eu esquecer completamente desta sessão, o próximo Claude conseguiria continuar?" Se a resposta for não, o protocolo falhou.

Revisão agendada: após >=3 usos in vivo. O próprio Henrique ou o Claude devem convocar revisão ao detectar que a skill está sendo invocada rotineiramente.

Valor Acadêmico da Skill

Esta skill é, ela própria, dado de pesquisa:

• [A] Evidência de que a gestão de projetos complexos em colaboração H-IA requer mecanismos institucionais explícitos de continuidade — não basta confiar na memória do modelo.
• [B] Padrão de Session Memory Architecture aplicado: protocolo de encerramento como mecanismo anti-drift. Relacionado ao Padrão 8 do ia-collab-os v2.4.
• [AB] A criação da skill em resposta ao pedido explícito do Henrique ("protocolo de encerramento reforçado") é evento rastreável: o pesquisador-gestor identificou falha no sistema e o sistema (via Claude) construiu a mitigação. Esse é um ciclo PA canônico (identificação -> ação -> reflexão -> artefato institucional).

Registrar: quando a skill intervém proativamente, o Henrique segue? Quando intervém e ele rejeita, qual é a razão? Isso é dado para PS3 (colaboração H-IA) e OE4 (padrões H-IA).