O problema da passagem
Quando você começa uma nova sessão do Claude Code, todo o contexto se perde. Você precisa explicar de novo no que estava trabalhando, quais arquivos importam e o que falta fazer.
O /note-context resolve isso criando uma nota azul fixada com tudo o que a próxima sessão precisa.
Seções de saída
| Seção | Conteúdo |
|---|---|
| Cabeçalho | projeto @ branch | N mudanças não commitadas |
| Trabalhando em | Tarefa atual, específica e clara |
| Arquivos-chave | 3-5 arquivos mais importantes com anotações de ~5 palavras |
| Estado | Propósito da branch, resumo do não commitado, progresso do loop |
| Decisões-chave | Decisões tomadas só nesta sessão |
| Perguntas em aberto | Itens não resolvidos e incógnitas |
| Retomar com | Instruções exatas para a próxima sessão |
Formato dos arquivos-chave
Cada arquivo recebe uma anotação curta:
src/auth.ts — Middleware de validação JWT (refatorando)
src/api/users.ts — Novo endpoint, precisa de testes
tests/auth.test.ts — 3 testes falhando no refreshMáximo 5 arquivos. Só os mais relevantes.
A seção “Retomar com”
Essa é a seção crítica. Critério de qualidade:
Ler SÓ “Retomar com” precisa dizer a uma sessão nova exatamente o que fazer em seguida.
Bom:
Retomar com: Corrigir o fluxo de refresh token em src/auth.ts:45.
A função validateToken precisa checar a expiração do token
e chamar refreshToken() antes de retornar 401.
Rodar os testes com: npm test -- authRuim:
Retomar com: Continuar trabalhando no auth.Sempre fixada
A nota de contexto é sempre:
- Azul
- Fixada sobre todas as janelas
- Atualizada se tiver menos de 3 horas, senão cria uma nova nota
Só uma nota de contexto ativa por vez — sempre o snapshot mais recente.
Modo sem git
Funciona sem repositório git. Pula seções relacionadas ao git (branch, mudanças não commitadas) e foca no estado das notas e no contexto que você fornece.
Timestamp
Cada nota de contexto inclui a hora exata:
Contexto 19 de fev. de 2026 23:15