Anderson LimaSoftware Developer
2 de março de 2026
7 min de leitura
4,440 visualizações
Toda vez que você abre uma sessão no Claude Code, ele carrega automaticamente alguns arquivos que podem estar consumindo demais os seus tokens
A primeira coisa foi entender exatamente o que o Claude Code carrega em cada sessão. A regra é simples:
CLAUDE.md (raiz do projeto): sempre carregado.claude/CLAUDE.md: sempre carregado@arquivo: expandidas inline (o @AGENTS.md estava injetando 713 linhas)MEMORY.md: sempre carregado (memória persistente entre sessões)O diagnóstico foi claro: AGENTS.md era o vilão, e os hooks estavam multiplicando chamadas desnecessárias.
O MEMORY.md tinha 70 linhas com informações que já existiam no CLAUDE.md:
Ação: Removemos tudo que já estava coberto pelos arquivos de projeto e mantivemos apenas informação exclusiva da memória:
# Project - Memory
## Dark Premium Theme (actual hex values)
- Background: #031426
- Emerald: #2BAE7B, #23C98E, #0A3D2E
...
## Pre-existing TS Errors (not ours)
- CreateGroupScreen: disabled prop on TextInput
- PaywallScreen: plan type mismatches
...
## Screens Redesigned (Feb 2026)
- Bets: BetsHub, MarketsList, MyBets...
Resultado: 70 linhas → 22 linhas (~70% de redução).
A regra de ouro: a memória só deve conter o que NÃO existe em nenhum outro arquivo de contexto.
Os hooks eram o custo oculto mais caro. Veja o que tínhamos:
| Hook | Evento | Frequência |
|---|---|---|
| Style validator | PreToolUse (Write/Edit) | Cada write/edit |
| i18n validator | PreToolUse (Write) | Cada write |
| Accessibility validator | PreToolUse (Write) | Cada write |
| Commit format | UserPromptSubmit | Cada mensagem |
| Session context | SessionStart | 1x por sessão |
O problema: cada Write disparava 3 chamadas de API separadas (uma para cada hook de validação). E o hook de commit rodava em toda mensagem do usuário, mesmo que 99% das vezes não fosse sobre commits.
Ação: Unificamos tudo em um único hook:
{
"PreToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "prompt",
"prompt": "Check if the tool input contains React Native/TypeScript code. If so, WARN about:\n1. STYLES: Inline StyleSheet.create()...\n2. I18N: Hardcoded user-facing strings...\n3. ACCESSIBILITY: Missing accessibilityRole..."
}
]
}
]
}
Resultado: 5 hooks → 1 hook. De até 4 chamadas extras por turno para no máximo 1 (e só quando escreve arquivo).
O SessionStart foi removido porque o .claude/CLAUDE.md já carrega o mesmo contexto. O UserPromptSubmit de commit foi removido porque rodava em toda mensagem para um caso raríssimo.
Software Developer
Ajudo founders a parar de lutar com decisões de arquitetura e começar a entregar. Após 10+ anos construindo produtos em três continentes, aprendi que o melhor código é invisível—ele funciona, escala e converte. Pós-graduado em arquitetura de software e soluções. Conecto profundidade técnica com resultados de negócio para entregar produtos que as pessoas realmente usam. Também mentoro desenvolvedores e criadores em programas ao vivo, podcasts e iniciativas de comunidade focadas em tecnologia inclusiva.
Produtos gratuitos e pagos para transformar ideias em uma base que você consegue executar.
13 produtos disponíveis
nextjs · boilerplate
Boilerplate de API em Python com FastAPI, organizado em Clean Architecture (router, service, repository e adapters por módulo). Inclui autenticação JWT com hashing bcrypt, MongoDB, testes com pytest e cobertura, Dockerfile e docker-compose para subir localmente, e documentação Swagger/OpenAPI automática. Repositório de origem privado; snapshot técnico verificado antes da publicação.
Ver produto
react · boilerplate
Base React Native para apps iOS e Android com Expo, Clean Architecture, MVVM, Firebase e módulos nativos. Referência técnica do VaiDeFut, com distribuição pública no Google Play e fluxo de publicação para iOS documentado.
Ver produto
nextjs · boilerplate
Kit gratuito e open source para começar com agentes de código em Claude Code, Codex, Gemini, Copilot e OpenCode. A licença MIT está confirmada no repositório público.
Ver produto
nextjs · boilerplate
Fundação AI-first white-label para lançar produtos SaaS com Next.js, chat, RAG, memória, tenants e documentação. O snapshot verificado documenta Supabase, não MongoDB; essa limitação está explícita. MongoDB, Redis e RabbitMQ exigem integração/configuração compatível.
Ver produto
nextjs · boilerplate
Edição avançada da base white-label e multi-tenant AI-first para acelerar produtos com Next.js, chat, RAG, memória e documentação. O snapshot verificado ainda não comprova uma camada Ultra distinta; a oferta mantém essa limitação transparente e explicita as trocas de provider, cache e filas.
Ver produto
nextjs · boilerplate
Base white-label e multi-tenant para transformar uma ideia em um SaaS AI-first com Next.js, chat, RAG, memória e segurança documentados. O snapshot verificado usa Supabase; o nome identifica o repositório de origem. Provider, cache e filas ficam explícitos; Redis e RabbitMQ são integrações configuráveis.
Ver produto
react · portfolio
Uma contribuição única para apoiar conteúdo técnico gratuito, pesquisa e a continuidade de projetos relevantes publicados por Anderson Lima. Você escolhe o valor; não é uma assinatura.
Ver produto
react · boilerplate
Starter React gratuito para criar uma suíte de testes confiável desde o primeiro commit, com Vitest, Testing Library, Playwright, Vite, TypeScript, Zustand, React Query, MirageJS e PWA. O repositório não declara uma licença SPDX; revise os termos antes de uso comercial.
Ver produto
react · portfolio
Monorepo público em React, TypeScript e Vite para explorar uma biblioteca de componentes com linguagem visual inspirada em interfaces nativas. O README atual é enxuto e não declara uma licença SPDX; trate como preview gratuito.
Ver produto
nextjs · saas
Boilerplate SaaS AI-first com Next.js, Supabase, Stripe e provider routing para começar do primeiro prompt e acelerar o caminho até um deploy real. As adaptações de IA, banco, e-mail, cache e filas ficam explícitas; Redis e RabbitMQ são integrações configuráveis.
Ver produto
react · saas
Starter kit React + TypeScript para SaaS multi-tenant com Firebase, Atomic Design, temas, PWA, telas de produto, MirageJS e chat com Gemini extensível a outros providers. Valide requisitos de produção, custos e integrações antes de publicar.
Ver produto
react · boilerplate
Starter React público com TypeScript, Zustand, React Query, Tailwind CSS, PWA e integrações de IA documentadas. O repositório não declara uma licença SPDX; revise os termos antes de uso comercial.
Ver produto
nextjs · saas
Landing page SaaS para Next.js, TypeScript e Tailwind CSS com SEO, temas, i18n, PWA e pontos de integração para auth, Stripe e IA. Uma base clara para sair da tela vazia e adaptar sua proposta.
Ver produtoContinue explorando tópicos similares
A comprehensive guide to spec-driven development workflows with AI coding assistants, featuring real-world Next.js examples and Claude Code commands.
Aprenda Model Context Protocol (MCP) na prática: conceitos, arquitetura e exemplos reais com Claude Code para criar agentes e workflows de IA escaláveis.
OpenAI e Anthropic chegaram a 2026 como as duas empresas mais importantes da corrida de IA aplicada. Este artigo reconstrói suas trajetórias, compara modelos, infraestrutura, investimentos, agentes, riscos e possíveis IPOs.
Checklist prático para validar segurança, custos, avaliações e observabilidade antes de colocar seu app com IA em produção.
Templates testados em produção, usados por desenvolvedores. Economize semanas de setup no seu próximo projeto.
Este foi o passo com maior impacto. Tínhamos dois arquivos carregados toda sessão:
AGENTS.md (713 linhas): guia completo com exemplos de código, checklists, padrões.claude/CLAUDE.md (116 linhas): resumo conciso do projetoO problema: 80% do AGENTS.md era redundante com o CLAUDE.md. Ambos tinham:
Ação em 3 passos:
.claude/CLAUDE.md de forma compacta@AGENTS.md do CLAUDE.md raizO CLAUDE.md raiz ficou assim:
See .claude/CLAUDE.md for full project context and rules.
Pay special attention to Real-Time Sync, Optimistic UI, and Component Guidelines.
E o .claude/CLAUDE.md absorveu o conteúdo único de forma concisa. Por exemplo, a seção de Real-Time Sync que tinha 6 linhas no AGENTS.md virou:
### Real-Time Sync & Optimistic UI
- **Local-First**: Use onSnapshot listeners, not getDoc/getDocs
- **Domain naming**: Repository subscriptions use watch prefix and return () => void unsubscribe
- **UI**: Call watch* in useEffect — avoid useFocusEffect refetch after CRUD
Resultado: 830 linhas → 135 linhas (~84% de redução).
O AGENTS.md continua existindo como documentação de referência — ele não foi deletado. Apenas não é mais carregado automaticamente em cada sessão.
Com o contexto otimizado, criamos uma skill global para resolver outro problema: usar o modelo certo para cada tarefa.
O Claude Code permite especificar o modelo ao criar subagents via o parâmetro model do Agent tool. Isso significa que podemos rotear tarefas automaticamente:
opus → arquitetura, planejamento, decisões complexas
sonnet → implementação de lógica de negócio
haiku → estilos, testes, i18n, boilerplate
Criamos a skill em ~/.claude/skills/smart-dispatch/SKILL.md:
---
name: smart-dispatch
description: Automatically routes tasks to optimal Claude models
(opus/sonnet/haiku) based on complexity. Use when implementing
features, fixing bugs, or any multi-step development work.
---
# Smart Model Dispatch
## Model Routing Rules
### opus — Complex reasoning & architecture
- Architecture planning and design
- Complex business logic implementation
- Feature planning and requirement analysis
### sonnet — Standard implementation
- Business logic (use cases, repositories, stores)
- Screen/component implementation with logic
- Firebase/API integration
### haiku — Fast, mechanical tasks
- Generating .styles.ts files
- Writing i18n translation files
- Creating boilerplate and mocks
- Writing unit tests
```markdown
A skill inclui regras claras de quando usar cada modelo e exemplos de dispatch paralelo:
```markdown
Exemplo: Implementa a feature Watchlist
1. [opus] Planeja arquitetura
2. [sonnet] Implementa domain + data layers
3. [sonnet] Implementa screen com ViewModel
4. [haiku] Gera .styles.ts, i18n, mocks
5. [haiku] Escreve testes unitários
Por ser uma skill global (em ~/.claude/skills/), ela funciona em qualquer projeto, não apenas no Vai ter fut.
Antes e depois em números:
| Métrica | Antes | Depois | Redução |
|---|---|---|---|
| Contexto por sessão | 830 linhas | 135 linhas | 84% |
| Hooks executados | 5 (até 4 por turno) | 1 (só em Write/Edit) | 80% |
| MEMORY.md | 70 linhas | 22 linhas | 70% |
| Chamadas de API extras | ~4 por turno | ~1 por turno | 75% |
E o Smart Dispatch garante que cada subtarefa usa o modelo com melhor custo-benefício, sem intervenção manual.
1. Audite seus arquivos de contexto regularmente. Conforme o projeto cresce, os arquivos vão acumulando duplicações. O que era útil há 3 meses pode estar redundante hoje.
2. Hooks "prompt" são chamadas de API. Cada hook do tipo prompt faz uma chamada separada ao modelo. Três hooks no mesmo evento = três chamadas. Unifique sempre que possível.
3. Nem tudo precisa rodar em toda mensagem. O hook de commit format rodava em 100% das mensagens para ser útil em 1% delas. Se algo é raro, não coloque no UserPromptSubmit.
4. Skills são grátis até serem invocadas. Diferente de hooks e CLAUDE.md, skills só consomem tokens quando chamadas. Use skills para conteúdo detalhado e mantenha o CLAUDE.md enxuto.
5. O modelo certo para a tarefa certa. Não faz sentido usar o Opus para gerar um arquivo .styles.ts. O Haiku faz o mesmo trabalho com fração do custo e tempo. Reserve poder computacional para onde ele importa.
O processo completo em 5 comandos mentais:
CLAUDE.md, AGENTS.md, MEMORY.md)O arquivo de skill é simples, global, e funciona em qualquer projeto. Copie o nosso como ponto de partida.