Gerenciamento de contexto no Claude Code: /context, /compact, CLAUDE.md e Obsidian

Muitas sessões de Claude Code perdem qualidade porque logs antigos, arquivos lidos e decisões temporárias ocupam o contexto. Gerenciar contexto é separar o que precisa estar agora do que pode ficar em notas.

/context mostra uso atual, /compact resume a conversa, /clear começa de novo e /memory verifica arquivos carregados.

A meta é manter a sessão principal focada enquanto pesquisa longa, notas cruas e logs antigos ficam fora da janela ativa.

Think of the context window as the working desk

A janela de contexto contém histórico, arquivos lidos, saída de ferramentas, CLAUDE.md, auto memory, rules e skills. Quando enche, restrições importantes competem com saída antiga.

What enters context	Why it gets heavy	Practical response
Conversation	Long discussion and side quests	Cut by task boundary
Files	Reading huge files whole	Search first, then read narrow ranges
Tool output	Long logs and repeated failures	Summarize into a note
Memory	Oversized CLAUDE.md	Move details to rules or docs

Use /context, /compact, /clear, and /memory differently

/context mostra uso. /compact resume e continua. /clear serve para fronteira real de tarefa. /memory mostra CLAUDE.md e auto memory.

/context all
/compact focus on files changed, failing tests, and next command
/clear
/memory

Set a context budget before the task

Antes de começar, defina objetivo, escopo, fora de escopo, critérios de pronto e comandos de verificação. Não leia o repo inteiro se rg e poucos arquivos bastam.

# narrow discovery before asking Claude to read files
rg -n "getUserById|User not found|auth middleware" src tests
git diff --stat
npm test -- --runInBand

Copy-paste runbook for long work

Este runbook ajuda em refactor, segurança, artigo longo e experimento de conversão. Mantém a sessão pequena e deixa recibo.

## Task brief
- Objective:
- In scope:
- Out of scope:
- Files likely involved:
- Done when:
- Verification commands:

## Handoff receipt
- Changed files:
- Commands run:
- Result:
- Remaining risk:
- Next best action:

What survives compaction

Depois de /compact, CLAUDE.md da raiz e auto memory voltam. Arquivos aninhados e rules por path voltam quando arquivos correspondentes são lidos.

# CLAUDE.md

## Compact Instructions
- Keep the current business objective and monetization hypothesis.
- Keep changed files, verification commands, deploy state, and blockers.
- Drop raw logs unless a line explains the root cause.
- If article work is in progress, preserve slug, locale list, and quality gaps.

Three use cases: code, content, conversion

1. Em refactor grande, delegue pesquisa ampla a subagent ou sessão separada.
2. Em publishing, pesquisa bruta fica no Obsidian, regras editoriais no CLAUDE.md e MDX final no repo.
3. Em conversão, guarde métrica, hipótese, mudança e resultado como ticket pequeno.

Common failures and fixes

1. /compact não é backup completo; é resumo. Restrições duráveis ficam em arquivos.
2. Após discovery grande, comprima em nota curta antes de implementar.
3. Auto memory não é documentação compartilhada. Convenções compartilhadas vão no CLAUDE.md versionado.

How Obsidian fits in

This workflow works with CLAUDE.md best practices, token optimization, prompt engineering, and Obsidian workflow. Team setup can start from consultation page.

Place	Best information
CLAUDE.md	Short rules needed every session
Obsidian	Long research, hypotheses, article ideas
MDX / docs	Published content, specs, handoff notes
Auto memory	Local preferences and repeated learnings

What was verified

O artigo foi atualizado com docs oficiais de context window, commands e memory. Official references: context window, commands, memory, and common workflows.