agentleFS
felvieirafelvieira/claude-skills-fv/skills/31-session-summary/SKILL.md

session-summary

Skill28 starsChanged 3 months agoApache-2.0View on GitHub

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".

10 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

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).

---
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.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.