31 Session Summary

---
name: session-summary
description: |
  Skill de resumo de sessao para handoff entre sessoes. Consolida o que foi feito, decisoes tomadas,
  artefatos produzidos, pendencias e proximos passos. Facilita continuidade sem perder contexto.
  Trigger em: "resumo", "summary", "o que foi feito", "handoff retrospectivo", "encerrar sessao",
  "salvar sessao", "continuar depois", "recap".
allowed-tools: Read, Write, Glob, Grep
metadata:
  argument-hint: "[--save | --show]"
---

# Session Summary

O Session Summary consolida o trabalho realizado durante uma sessao para garantir continuidade entre sessoes. Registra acoes, artefatos, decisoes, pendencias e proximos passos, permitindo que outro dev ou agente retome o trabalho sem perder contexto.

## Governanca Global

Esta skill segue `GLOBAL.md`, `policies/execution.md`, `policies/persistence.md`, `policies/token-efficiency.md`, `policies/tool-safety.md`, `policies/handoffs.md` e `policies/evals.md`.

## Quando Usar

- ao encerrar uma sessao de trabalho
- ao passar contexto para outro dev ou agente
- quando a sessao foi longa e complexa com multiplas skills
- quando retomar trabalho apos pausa prolongada

## Quando Nao Usar

- para substituir documentacao formal do projeto
- para sessoes triviais com apenas 1 comando executado
- para registrar decisoes de arquitetura (usar Documenter)

## Entradas Esperadas

- historico da sessao atual
- artefatos criados ou modificados
- git log recente
- estado do pipeline

## Saidas Esperadas

- resumo em `docs/context/session-YYYY-MM-DD.md` **dentro do repo consumidor** (mesmo diretorio do projeto, versionavel/portavel — sem depender de vault pessoal de nenhum usuario)
- copia identica em `D:\claude-memory\logs\YYYY-MM-DD-<projeto>-session.md` quando o vault pessoal (`D:\claude-memory\`) existir na maquina (ver `policies/memory-write-rules.md`) — os dois arquivos tem o mesmo conteudo, o local do repo e a fonte canonica que outras skills do kit (ex: `/catalog-project`) devem ler
- atualizacao de `docs/context/current-focus.md`

## Responsabilidades

1. Consolidar acoes realizadas durante a sessao
2. Listar artefatos produzidos ou modificados
3. Registrar decisoes importantes tomadas durante a sessao
4. Identificar pendencias e blockers encontrados
5. Recomendar proximos passos priorizados

## Formato do Resumo

> Segue `policies/memory-write-rules.md`: preâmbulo "For future Claude", frontmatter rico, recency markers em claims externos, anti-fabricação (seção vazia é correta — não invente conteúdo de preenchimento).

```markdown
---
date: YYYY-MM-DD
type: session-summary
project: <slug>
tags: [session, <projeto>, <temas>]
ai-first: true
---

# Resumo de Sessao — YYYY-MM-DD

## For future Claude
Este resumo é de uma sessão sobre [tema] em [projeto], salvo em [data]. Cobre [o que foi feito] e deixa [pendência principal]. [Caveat de staleness se houver — ex: "decisões de stack podem ter mudado depois".]

## Pipeline Executado
[nome do pipeline ou descricao]

## O que foi feito
- [acao 1]
- [acao 2]
- [acao 3]

## Artefatos Produzidos
| Artefato | Caminho | Status |
|---|---|---|
| Componente Header | src/components/Header.tsx | criado |
| Teste unitario | tests/header.test.ts | criado |
| Auditoria | docs/repo-audit/current.md | atualizado |

## Decisoes Tomadas
- [decisao 1 e justificativa]
- [decisao 2 e justificativa]

## Pendencias / Blockers
- [ ] [pendencia 1]
- [ ] [pendencia 2]

## Proximos Passos Recomendados
1. [passo 1]
2. [passo 2]
3. [passo 3]
```

## Integracao com Outras Skills

- **Orchestrator (09)**: aciona o Session Summary ao final do pipeline
- **Context Manager (08)**: persiste o resumo e atualiza o foco atual
- **Cost Tracker (30)**: anexa custos da sessao ao resumo quando disponivel

**Checkpoint antes de salvar:** reler o resumo perguntando "alguém que não viu a sessão consegue retomar só com isso?" — se um "Próximo Passo Recomendado" não nomeia arquivo/comando concreto, ou uma "Decisão Tomada" não diz o porquê, reescrever aquele item antes de persistir. Resumo vago custa mais caro na próxima sessão do que o tempo de deixá-lo específico agora.

## Evidencia de Conclusao

- resumo salvo em `docs/context/session-YYYY-MM-DD.md` (repo consumidor)
- copia salva em `D:\claude-memory\logs\` quando o vault existir na maquina
- `docs/context/current-focus.md` atualizado
- pendencias e proximos passos claros e priorizados

## Handoff

Entregar:

- caminho do resumo da sessao
- estado das pendencias e blockers
- proximos passos priorizados

Seguir `policies/handoffs.md`.

## Codigo Limpo

Manter resumos concisos, objetivos e reutilizaveis para continuidade eficiente entre sessoes.