Compactar arquivos CLAUDE.md para Reduzir a Inflação do Prompt do Sistema no Claude Code

Otimizando o Uso de Contexto do Claude

O Claude Code injeta arquivos CLAUDE.md em todas as conversas como contexto de prompt do sistema, incluindo CLAUDE.md de nível de projeto, arquivos globais em ~/.claude/CLAUDE.md e arquivos do sistema de memória persistente. Cada caractere nesses arquivos consome contexto que o Claude processa antes de atender às solicitações do usuário, potencialmente reduzindo o desempenho quando a relação sinal-ruído é baixa.

A Abordagem de Compressão

O autor propõe remover a decoração legível por humanos e manter apenas o sinal legível por máquina usando estas regras:

• Remover decoração markdown: Cabeçalhos (##), negrito (**), itálico (*), regras horizontais (---)
• Colapsar prosa para notação: Usar pares chave-valor compactos ou listas delimitadas por pipe em vez de frases explicativas
• Remover estruturação redundante: Eliminar frases como "Esta seção contém..." ou "A tabela a seguir mostra..."
• Deduplicar contexto entre arquivos: Manter informações idênticas em um local canônico
• Comprimir formatação de tabelas: Substituir tabelas markdown verbosas por notação compacta

Exemplos Antes e Depois

Exemplo de Tabela de Índice de Diretório:

Antes (tabela markdown):

## Diretórios
| Diretório | O que | Quando ler |
|-------------|-----------------------------|---------------------------------------|
| src/ | Código-fonte da aplicação | Trabalhando na lógica da aplicação |
| infra/ | Arquivos Terraform e Ansible | Modificando a infraestrutura |
| docs/ | Documentação de arquitetura | Entendendo o design do sistema |
| scripts/ | Scripts de implantação e utilitários | Executando ou editando fluxos de trabalho de implantação |

Depois da compressão:

Dirs: src/=código-fonte da aplicação | infra/=terraform+ansible | docs/=documentação de arquitetura | scripts/=scripts de implantação+utilitários

Exemplo de Instruções do Sistema de Memória:

Antes:

## Sistema de Memória
A memória persistente fica em `/path/to/memory/`.
**Início da sessão**: Leia `memory/_index.md` para restabelecer o contexto ao fazer trabalho substancial neste repositório.
**Durante o trabalho** — Escreva na memória quando algo significativo acontecer:
- Uma descoberta ou achado não óbvio → adicione a `memory/discoveries.md`
- Uma nova habilidade aplicada ou aprendida → atualize `memory/skills.md`

Depois da compressão:

Memory: /path/to/memory/
session-start: leia _index.md para trabalho substancial
during-work (escreva apenas em eventos significativos, sinal não ruído):
discovery → adicione memory/discoveries.md
skill learned → atualize memory/skills.md

Resultados da Compressão

O autor alcançou as seguintes reduções entre os arquivos:

• _index.md: 3.560 → 2.036 caracteres (redução de 43%)
• discoveries.md: 11.260 → 5.609 caracteres (redução de 50%)
• interests.md: 4.315 → 2.561 caracteres (redução de 41%)
• skills.md: 16.176 → 5.353 caracteres (redução de 67%)
• career-timeline.md: 17.882 → 5.027 caracteres (redução de 72%)
• ~/.claude/CLAUDE.md: 2.350 → 1.495 caracteres (redução de 36%)

Sistema de memória total compactado: 60.264 caracteres com aproximadamente 60-70% de redução em geral. O CLAUDE.md do projeto foi compactado ainda mais agressivamente.