🎯 O que e contexto critico
Contexto critico e o estado ativo do seu trabalho. O que voce esta fazendo agora, por que, e o que vem depois. Muda quase toda sessao.
📌 Os 5 campos essenciais
Template que serve desde dev solo ate team lead.
- •Projeto ativo: nome e escopo
- •Foco atual: o que voce esta tentando fazer
- •Bloqueios: esperando alguem ou decidindo algo
- •Ultima decisao: com data e razao
- •Proximo passo: acao concreta
🛟 Sobrevivencia a compactacao
Aqui esta o diferencial tecnico: contexto critico tem seu proprio hook (PreCompact) que re-injeta antes do resumo automatico. Sem isso, sessoes longas perdem o fio.
📐 Com e sem PreCompact
SEM PreCompact hook:
Sessao 170k tokens ──▶ [compactacao] ──▶ resumo
Resultado: contexto virou 2 frases vagas.
COM PreCompact hook:
Sessao 170k tokens ──▶ [hook injeta context.md]
──▶ [compactacao]
──▶ resumo + context.md intacto
Resultado: voce continua sabendo projeto, foco, bloqueios.💡 Momento de injecao
PreCompact dispara ANTES da compactacao. O conteudo injetado entra no prompt e e preservado no resumo. Trilha 4 mostra a implementacao.
📝 Template: 5 campos essenciais
Template fixo reduz friccao. Voce sabe o que escrever e Claude sabe o que ler.
📐 context.md template
## Projeto ativo payments-v2 (migracao do sistema de pagamentos) ## Foco atual Implementar retry logic no webhook da Stripe ## Bloqueios - Aguardando API key de staging do time de infra - Precisa decidir: usar idempotency key ou dedup DB? ## Ultima decisao Escolhemos FastAPI sobre Flask (2026-04-20) por suporte async ## Proximo passo Escrever teste de integracao para webhook chunked
💡 Dica de formatacao
Use headers markdown (##). O modelo parseia melhor que texto corrido.
🔁 Quando atualizar
A disciplina de atualizacao define se o sistema funciona. Tres opcoes em ordem de automatismo:
Manual (fim da sessao)
Voce edita context.md antes de fechar. 30 segundos, zero automacao. Funciona se voce tem disciplina.
SessionEnd hook (semi-auto)
Hook pergunta 'quer atualizar context.md?' e voce edita. Friccao baixa, voce decide.
SessionEnd + Gemini Flash (full auto)
Hook chama Gemini para resumir sessao e atualizar context.md sozinho. Zero esforço. Trilha 6 cobre.
💡 Comece manual
Nao automatize antes de sentir o valor manualmente. Uma semana de uso manual da clareza do que automatizar.
🚫 O que NAO colocar
Erros classicos que transformam context.md em lixo. Cada antipattern tem uma camada correta de destino.
✓ Vai em context.md
- ✓Nome do projeto atual
- ✓Ultima decisao importante (com data)
- ✓Bloqueios atuais
- ✓Proximo passo concreto
✗ NAO vai em context.md
- ✗Historico completo da sessao (vai para long-term)
- ✗Identidade pessoal (vai para prime.md)
- ✗Arquivos que voce tocou (vai para Plans/Tasks)
- ✗Regras gerais de codigo (vai para CLAUDE.md)
📌 Analogia: post-it no monitor
O post-it perfeito: voce olha, em 2 segundos sabe onde parou, continua trabalhando. Context.md tem que passar esse teste.
⚠️ Teste de 2 segundos
Leia o seu context.md. Em 2 segundos voce deve saber: projeto, foco, proximo passo. Se demora mais, esta prolixo. Corte.
💡 Formato importa
Headers markdown + frases curtas + bullets. Evite paragrafos. Velocidade de leitura e o criterio.
📝 Resumo do Modulo
Proximo:
2.3 — Memoria de Trabalho (sessao, descartavel)