14 — Continuidade de Sessão e Controle de Tokens
milestones 100k · 200k · 300k · 400k · live-state.md · diário · crash recovery · nova sessão
ETAPA 14/17
orquestrador · sessão
0
início
C
100k
CHECKPOINT
salva live-state.md
commit no worktree
D
200k
DIÁRIO
relatório de progresso
push diário obrigatório
A
300k
ALERTA
wrapper compacta
prefetch live-state.md
N
400k
NOVA SESSÃO
crash recovery
carrega live-state.md
live-state.md — ESTRUTURA
# live-state.md
## Sessão Atual
data: 2025-11-14 · tokens: 187k/400k
agente-atual: S-043 · task: #20
## Contexto do Projeto
stack: Next.js 14 + Supabase + OpenRouter
sprint: Sprint-03 · objetivo: CRUD users
## Tasks Abertas
#19 POST /users — S-042 [worktree aberto]
#20 GET /users/:id — S-043 [em revisão]
## Bloqueadores
nenhum no momento
Salvo no repo raiz: git commit -m "chore: live-state 100k"
Lido como PRIMEIRA ação de nova sessão (antes de qualquer tarefa)
CRASH RECOVERY — NOVA SESSÃO
1
Ler live-state.md → contexto completo da sessão anterior
2
git status em todos os worktrees ativos
3
Checar GitHub Issues abertas → tasks pendentes
4
Revisar diário mais recente → decisões tomadas
5
Identificar tarefa interrompida → continuar ou reassign
6
Atualizar live-state.md com nova sessão + tokens resetados
✓
Sessão restaurada — retomar o trabalho sem perda de contexto
Tempo médio de recuperação após crash: < 3 min se live-state.md estiver atualizado
400k sem live-state.md atualizado = retrabalho. Salvar é obrigatório.
worktrees: commits pendentes sobrevivem ao crash (branch local intacta)
RELATÓRIO DIÁRIO — 200k
# diário/2025-11-14.md
## Progresso
- Concluídas: #08, #10, #11
- Em andamento: #19, #20
- Bloqueadas: nenhuma
## Decisões Tomadas
- Optou-se por JWT stateless (issue #DECISAO-03)
## Gates
- #11 → PASSOU (tech + sec + privacy)
## Próximos Passos
- Finalizar PR #89 para #19
- Abrir worktree para #21
Arquivo commitado em diário/ no repo. Push obrigatório.
Agente gera o diário automaticamente ao atingir 200k tokens.
CONSUMO DE CONTEXTO — RÉGUA DE TOKENS
100k
200k
300k
400k
checkpoint
diário obrigatório
⚠ alerta · compactar
🔴 nova sessão
ETAPA 14
·
4 milestones de token · live-state.md obrigatório · crash recovery 6 passos · diário em 200k
TOKENS & SESSÃO
LEGENDA
C
Checkpoint (100k) — salva live-state.md + commit
D
Diário (200k) — relatório de progresso commitado
A
Alerta (300k) — compactação de contexto + prefetch
N
Nova Sessão (400k) — crash recovery obrigatório
live-state.md = arquivo de continuidade, lido primeiro em toda nova sessão
diário/ = pasta com um arquivo por dia (YYYY-MM-DD.md), sempre commitado antes do push
worktrees sobrevivem a crash: branches locais ficam intactas até merge ou delete manual
Wrapper do orquestrador injeta live-state.md automaticamente ao iniciar nova sessão após 400k
Contagem de tokens: monitorada pelo orquestrador a cada resposta; threshold configurável por projeto