Modulo 3.1: Ciclo de vida de uma sessao

🚀 Fase 1: inicializacao

A janela de oportunidade mais importante para memoria. Antes da primeira mensagem do usuario, Claude Code dispara hooks que podem injetar contexto.

📋 Hooks da fase init

Ordem de disparo no boot da sessao:

•SessionStart: roda uma vez, no inicio. Onde vai identidade + contexto.
•currentDir detection: Claude ja sabe cwd. Voce pode rotear memoria por projeto.
•Env collection: variaveis uteis para escolher prime.md especifico.
•CLAUDE.md loading: hierarquia projeto → user → system.

💡 Ponto de alavancagem

SessionStart e o hook #1 do curso. 90% dos ganhos de memoria vem dele. Trilha 4 detalha a implementacao.

💬 Fase 2: interacao (user prompt)

Para cada mensagem do usuario, Claude Code dispara hooks que podem modificar o prompt dinamicamente.

🔄 Hooks por turno

Dispara a cada mensagem:

•UserPromptSubmit: antes do modelo responder. Pode injetar contexto adicional baseado na pergunta.
•Stop: apos a resposta completa. Util para avaliar output ou capturar decisoes.

💡 Injecao dinamica

UserPromptSubmit e o hook mais flexivel. Pergunta sobre DB? Injeta schema. Pergunta sobre deploy? Injeta infra config. Trilha 4 modulo 5 cobre.

🔧 Fase 3: execucao de ferramentas

Claude chama ferramentas (Read, Write, Bash, etc.) o tempo todo. Hooks cercam cada call.

⚙️ Hooks PreToolUse / PostToolUse

Disparam antes/depois de cada tool call:

•PreToolUse: antes. Pode validar, bloquear (exit 2), ou logar.
•PostToolUse: depois. Pode auditar resultado ou capturar para memoria.
•Matcher por tool: so dispara para Bash, ou so para Write, etc.
•Uso raro para memoria: mais comum em compliance e observabilidade.

⚠️ Cuidado com latencia

Hook sincrono em PreToolUse bloqueia a ferramenta. Mantenha <100ms ou use async.

🌀 Fase 4: compactacao

Quando a sessao passa de ~170k tokens, Claude Code auto-compacta. Hook dispara ANTES disso.

📐 Timing do PreCompact

Sessao em expansao (turnos acumulam)
         │
         ▼ chega a ~170k tokens
 ┌───────────────────────┐
 │  PreCompact hook!     │ ← sua janela de acao
 │  Script injeta        │
 │  context.md           │
 └───────────┬───────────┘
             ▼
 Compactacao acontece (resumo automatico)
             │
             ▼
 PostCompact hook (opcional, observacao)
             │
             ▼
 Sessao continua com resumo + seu context.md preservado

💡 Unico hook dessa fase

PreCompact nao tem irmao. E a unica forma deterministica de sobreviver ao squeeze. Sem ele, contexto crit vira pedaco de resumo.

🏁 Fase 5: encerramento

Voce fecha a sessao. Hooks rodam em modo fire-and-forget porque nao ha usuario esperando.

🔚 Hooks de encerramento

Ordem tipica:

•Stop: apos ultima resposta do modelo. Sincrono.
•SessionEnd: quando sessao e finalizada. Ideal para jobs pesados.
•Transcript save: Claude salva JSONL. Voce pode ler no hook SessionEnd.
•Pode rodar em background: nohup python3 ... & — nao trava proxima sessao.

💡 Job da Trilha 6

SessionEnd + Gemini Flash = resumo automatico da sessao para context.md. Veremos implementacao.

🗺️ Mapa visual dos 18 hooks

Fixar o modelo mental: 18 pontos, 5 fases, 3 hooks criticos para memoria.

📐 Timeline completa

[INIT]        [INTERACAO]       [TOOLS]          [COMPACT]      [END]
  │              │                 │                │              │
  ▼              ▼                 ▼                ▼              ▼
SessionStart*  UserPromptSubmit* PreToolUse     PreCompact*    Stop
               Stop               PostToolUse    PostCompact    SessionEnd
                                  (por tool)                    TranscriptSave
  │              │                 │                │              │
  └────────▶ carregar memoria ▶ executar ▶ sobreviver ▶ arquivar ─┘

* = hooks CRITICOS para memoria (Trilha 4)

💡 Memorize as 5 fases

Init / Interacao / Tools / Compact / End. Sempre que pensar em hook, pergunte: qual fase? Resposta aponta o hook certo.

📝 Resumo do Modulo

✓

5 fases na sessao — init, interacao, tools, compact, end.

✓

Memoria usa 3 hooks — SessionStart, PreCompact, UserPromptSubmit.

✓

Conhecer todos evita reinvencao — muitos problemas ja tem hook pronto.

✓

Mapa temporal fixa o modelo mental — uma imagem vale 100 leituras de docs.

Proximo:

3.2 — Taxonomia: tabela de consulta rapida

← Voltar para Trilha Proximo Modulo →