🚀 SessionStart: a injecao deterministica
O hook mais importante do curso. Substitui a incerteza do CLAUDE.md por 100% de confiabilidade.
Hook que dispara ANTES da primeira mensagem do usuario. Seu script retorna additionalContext que vai para o prompt.
E o hook mais simples e de maior impacto. Comecar por aqui da resultado visivel em 15 minutos.
Deterministic boot, context injection.
Um settings.json com hook SessionStart que chama cat prime.md e retorna como additionalContext.
Sentir o "funciona!" antes de complicar e o combustivel do resto da trilha.
Minimal config, quick win.
Mesmo experimento do modulo 1.3, mas agora com SessionStart injetando a palavra. Resultado: 10/10.
Ver a propria diferença de 70 -> 100% e o momento "eureka" do curso.
Before/after, validation.
Template curto com identidade + foco atual. Destino do modulo 4.2.
O que voce injeta e tao importante quanto o fato de injetar.
Prime template, token budget.
Seu script le cwd do input e carrega prime.md diferente por projeto.
Um hook atende N projetos sem duplicacao.
Scoped memory, cwd routing.
Se sua palavra-codigo nao volta: (1) permissoes, (2) path do script, (3) JSON output invalido, (4) conflito com settings outro nivel.
Evita horas perdidas nos primeiros 30 minutos.
Troubleshooting runbook.
📄 prime.md — escrevendo sua identidade
O arquivo que SessionStart injeta. Decidir o que colocar e arte tanto quanto engenharia.
Cinco linhas em formato "Chave: valor". Simples e legivel tanto para voce quanto para o modelo.
Template fixo elimina paralisia na hora de escrever.
Schema, key-value.
Se passar de 200, refatore. O que nao couber vai para contexto critico ou long-term.
Disciplina de budget mantem o arquivo util.
Token discipline.
Ver versao de dev backend, content creator e team lead lado a lado para calibrar o seu.
Comparar exemplos ajuda mais que seguir regras abstratas.
Worked examples.
Historico pessoal, projetos antigos, preferencias irrelevantes para o trabalho atual.
Cada linha a mais inflaciona o custo de toda sessao.
Anti-patterns, signal density.
Identidade muda lentamente. Se voce edita toda semana, e outra coisa (provavelmente contexto critico).
Disciplina de raridade reforça o papel.
Edit cadence.
Pause o video, abra o editor, escreva seu prime.md. Nao siga: faça. Template em labs/prime-md/.
Curso sem execucao e so entretenimento.
Active learning.
🛟 PreCompact: sobrevivendo ao squeeze
O hook que salva horas de trabalho. Re-injeta contexto critico antes do resumo automatico.
Quando Claude Code detecta que precisa compactar (proximo do limite), dispara PreCompact antes.
Entender a janela temporal ajuda a decidir o que injetar.
Trigger timing, survival window.
O arquivo de contexto critico (modulo 4.4). Injetar garante que ele sobreviva ao resumo.
Sem isso, o resumo apaga decisoes e voce volta a sugerir coisa ja descartada.
Critical context injection.
Mesmo script do SessionStart (cat context.md) mas associado ao evento PreCompact.
Reuso do script reduz manutencao.
Reusable hook.
Sessao com muitos arquivos grandes lidos propositalmente para forçar compactacao. Ver o hook agir.
Testar em condicao controlada e melhor que esperar acontecer em producao.
Controlled experiment.
Antes: pergunte "qual o projeto ativo?". Forçe compactacao. Pergunte de novo. Resposta bate? Sobreviveu.
Verificacao direta fecha o loop de confiança no hook.
A/B validation.
Nao injete o CLAUDE.md todo (duplica). Nao injete o log da sessao (sobrecarrega).
PreCompact mal feito piora em vez de ajudar.
Idempotency, signal density.
📌 context.md — escrevendo contexto critico
O post-it do seu trabalho. Atualiza frequentemente. Sobrevive compactacao.
Cinco linhas: Projeto ativo, Foco atual, Bloqueios, Ultima decisao, Proximo passo.
Template fixo e rapido de atualizar e de ler.
Schema, fixed-fields.
Atualizar ao final da sessao ou primeiro minuto da proxima. Nao e pesado.
Disciplina de atualizacao e o que define se o sistema funciona.
Update ritual.
SessionEnd chama Gemini Flash para resumir a sessao e atualiza context.md sozinho.
Remove o unico trabalho manual do sistema.
Auto-update, LLM assisted.
Cada projeto tem seu proprio context.md. Hook escolhe qual carregar pelo cwd.
Evita mistura de contextos entre projetos.
Project isolation.
Se CLAUDE.md diz "projeto A" e context.md diz "projeto B", Claude tende a seguir context.md (mais recente).
Saber isso evita duplicar informacao volatil em CLAUDE.md.
Layer precedence.
Template em labs/context-md/. Edite agora para o seu projeto real.
Na proxima sessao voce ja ve o benefício.
Active learning.
💬 UserPromptSubmit: injecao por turno
O hook mais flexivel. Injeta contexto diferente dependendo do que voce perguntou.
Quando o contexto nao e fixo: "se a pergunta e sobre DB, carregue schema; se e sobre deploy, carregue infra".
Transforma memoria em biblioteca dinamica.
Dynamic injection, topic routing.
Grep na pergunta: se contem "SQL" carrega schema.md; se contem "nginx" carrega config.md.
Nao precisa LLM para comecar. Keyword e suficiente em 80% dos casos.
Keyword routing.
Usa embeddings para achar as 3 memorias mais proximas da pergunta. Injeta as 3 como contexto.
Ampliacao natural para quando keyword nao basta.
Semantic retrieval.
Cap de ~1000 tokens por turno. Se passar, reescreva o hook para priorizar.
Injetar demais por turno polui e piora respostas.
Per-turn budget.
Se o contexto e estavel (mesmo por 90% das perguntas), SessionStart ja resolve.
Evita complicar desnecessariamente.
YAGNI.
Script que le o prompt do stdin, faz grep por topicos, carrega memorias relevantes, retorna JSON.
Base que voce adapta para qualquer necessidade.
Router pattern.
🎯 Lab completo: palavra-codigo
Experimento controlado ponta a ponta. 10 sessoes com CLAUDE.md vs 10 com hook. Medir.
Diretorio com CLAUDE.md e prime.md, ambos contendo a palavra. Script que automatiza as 10 rodadas.
Lab reproduzivel e base para qualquer comparacao futura.
Reproducible setup.
10 sessoes novas. Mesma pergunta. Anote quantas respondem com a palavra.
Dado que voce precisa para defender a solucao para si mesmo e outros.
Baseline measurement.
Mesmo lab com hook ativado. Mesmas 10 sessoes. Contar de novo.
Valida a hipotese do curso em sua propria maquina.
Treatment group.
Tabela: sessao | rodada A resposta | rodada B resposta | match esperado.
Dado concreto > argumentacao.
Result matrix.
Sessao longa forcando compactacao. Pergunta a palavra-codigo depois do squeeze. Pre vs Post hook.
Valida a segunda peça do trio.
Long-session test.
Com 3 hooks voce resolveu o problema. Proximas trilhas sao sobre escalar: mais memoria, mais conhecimento.
Marcar o checkpoint deixa claro quanto ja foi conquistado.
Milestone.