Handoff Context

Handoff Context — Briefing Acionavel pra Quem Chega Cego

> Inspiracao: mattpocock/skills/productivity/handoff (MIT). > Adaptado pra distinguir explicitamente de skill 31 (session-summary) (retrospectivo).

Diferenca vs skill 31 (session-summary)

| | Skill 31 session-summary | Skill 44 handoff-context (esta) | |---------------------|--------------------------|---------------------------------| | Foco temporal | Retrospectivo (o que foi feito) | Prospectivo (o que falta + como continuar) | | Audiencia | Proxima sessao minha (mesmo modelo, contexto recuperavel) | Outro agente / dev humano / sessao fresh cego | | Formato | Log markdown com decisoes e wikilinks | Pacote acionavel: setup commands + estado + 1 proximo passo | | Trigger natural | Fim de sessao (auto-save) | "passar bastao", "delega", "outro vai continuar" | | Output dir | D:\claude-memory\logs\ ou local | docs/handoffs/YYYY-MM-DD-.md | | Reuso esperado | "lembrar depois" | "executar agora sem perguntar" |

Resumo: session-summary registra, handoff-context delega.

Quando Usar

• voce vai parar (fim do dia, fim de sprint) e outro vai pegar amanha
• voce esta esgotando o contexto e vai abrir sessao fresca (compactacao iminente)
• task vai ser delegada pra agente externo (codex:rescue, freelancer, outro time)
• voce identificou que outra skill/agent deve continuar (handoff entre skills do pipeline)

Quando NAO Usar

• sessao curta sem interrupcao prevista — use skill 31 ao final
• task ja terminada — use skill 31 (resumo retrospectivo)
• duvida pontual — responda direto

Governanca Global

Segue GLOBAL.md, policies/handoffs.md (canonica), policies/persistence.md, policies/token-efficiency.md, policies/verification-before-completion.md (handoff so quando estado e verificavel).

Protocolo

1. Snapshot do estado real

git status --short
git branch --show-current
git log --oneline -5

Capturar:

• branch atual e divergencia vs main
• arquivos modificados nao commitados
• ultimos 5 commits (contexto recente)

2. Pendencias verificadas

Listar:

• testes: quais passam, quais falham, quais nao foram escritos
• build: verde, vermelho, ou nao tentado
• TODOs novos introduzidos nesta sessao (grep recente)

3. Proximo passo unico

Nao gerar roadmap. Um proximo passo concreto com:

• comando exato pra executar (ou arquivo:linha pra editar)
• resultado esperado
• criterio de sucesso

Se houver mais de um proximo passo possivel, escolher o mais bloqueador ou pedir AskUserQuestion.

4. Armadilhas conhecidas

Coisas que voce descobriu nesta sessao que economizam tempo pra quem chega:

• comandos que nao funcionam (e por que)
• arquivos que parecem relevantes mas nao sao
• decisoes ja tomadas (nao re-debater)
• dependencias com configuracao especial

5. Output canonico

Salvar em docs/handoffs/YYYY-MM-DD-.md:

---
date: YYYY-MM-DD
feature: 
target: human | agent | fresh-session
status: blocked | in-progress | ready-for-review
inspired-by: skill 44 handoff-context
---

# Handoff: 

## Setup (execute primeiro)

\`\`\`bash
git checkout 
git pull

\`\`\`

## Estado atual

- **Branch:**  (X commits ahead/behind main)
- **Build:** verde | vermelho | nao tentado
- **Testes:** / passam
- **Modificado:** 

## O que foi feito

- 
- 
- 

## Proximo passo (UM)

**Resultado esperado:** 
**Sucesso:** 

## Armadilhas (do que descobri)

- ⚠️ 
- ⚠️ 

## NAO faca

- ❌ 
- ❌ 

## Referencias

- session log: [[D:/claude-memory/logs/YYYY-MM-DD-...]]
- spec: 
- PRs relacionados: 

Handoffs (de saida desta skill)

• pra outro agente Claude: prompt = conteudo do .md salvo + "Continue daqui"
• pra dev humano: .md como issue/PR description
• pra fresh session: abrir nova sessao com primeiro prompt = ler docs/handoffs/.md

Anti-padroes

• ❌ Roadmap de 10 passos — esta skill produz 1 proximo passo
• ❌ Dump de tudo que foi feito — isso e skill 31, nao 44
• ❌ "Continue de onde parei" sem dizer onde parou
• ❌ Esconder armadilhas pra outro descobrir — registra
• ❌ Handoff sem comando de setup executavel

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: felvieira
• Source: felvieira/claude-skills-fv
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.