2026-03-10//LOG
Janela de 1M de Tokens Mudou Como Eu Projeto Arquitetura
Faz umas semanas que to usando o Claude com janela de contexto de 1M de tokens e preciso falar sobre como isso muda TUDO na forma de arquitetar software. Nao eh melhoria incremental. Eh outro jeito de trabalhar.
Antes: eu ficava escolhendo a dedo quais arquivos mandar pra IA. "Toma o service, toma a interface do repository, toma o teste." Eu era o curador, decidindo que contexto importava. Metade das vezes esquecia algo e a IA me dava conselho que conflitava com restricao que ela nem sabia que existia. Resultado: ficava microgerenciando contexto em vez de focar no problema.
Agora: mando TUDO. Codebase inteiro. Models, services, repositories, controllers, testes, configs, migrations. Tudo. E falo "dado TUDO isso, como implemento a feature X?"
A diferenca eh ABSURDA.
Quando o Claude ve o codebase INTEIRO, ele pega coisa que tu esqueceu que existia. "Vi que tu tem um padrao parecido no OrderService, a gente segue a mesma abordagem?" "Teu BaseRepository ja faz soft delete, nao precisa implementar de novo." "Isso ia conflitar com o event listener registrado no EventServiceProvider." Bicho, ele conhece teu codigo melhor que tu.
Decisoes de arquitetura viram CONVERSAS com contexto completo. Descrevi um modulo novo pro TOPO Contabil e o Claude, que ja tinha visto toda a estrutura Clean Architecture, sugeriu o layout exato de pastas, definicoes de interface e bindings de DI que casavam com todos os outros modulos. Nao porque eu expliquei o padrao. Porque ele VIU o padrao em dezenas de arquivos.
O que mudou na pratica:
REFATORACAO. Mando "refatora o fluxo de pagamento pra usar strategy pattern" e o Claude ve TODO arquivo que toca em pagamento. Todo controller, todo service, todo teste, todo event listener. Monta um plano de refatoracao completo que leva em conta TODAS as dependencias. Antes eu refatorava uma camada e descobria tres que quebraram. Agora ele ja avisa antes.
CODE REVIEW. Colo o diff inteiro do PR mais o contexto do codebase em volta. O Claude pega inconsistencia que nenhum reviewer humano pegaria porque nenhum ser humano segura 50 arquivos na cabeca ao mesmo tempo. "Esse endpoint novo nao segue o padrao de middleware das outras rotas autenticadas." Ouro puro.
DEBUGGING. Em vez de "aqui ta o erro e aqui ta o arquivo," mando so "aqui ta o erro" e deixo o Claude rastrear pela call stack inteira sozinho. Acha a causa raiz tres camadas abaixo num arquivo que eu nem ia pensar em olhar.
DOCUMENTACAO. O Claude gera doc de arquitetura precisa porque ele realmente VE a arquitetura. Nao a minha descricao dela. O codigo de verdade. A doc referencia nomes reais de classe, assinaturas reais de metodo, relacionamentos reais. Nada de doc desatualizada.
O tradeoff eh custo e velocidade. Mandar 500K tokens de contexto nao eh barato e o tempo de resposta sobe. Aprendi a ser estrategico. Pra pergunta rapida, ainda uso contexto focado. Mas pra decisao de arquitetura, refatoracao grande e debug complexo, contexto completo vale cada centavo.
Isso tambem mudou como eu ESTRUTURO projeto. Fiquei mais disciplinado com Clean Architecture porque sei que uma IA vai ler o codebase inteiro regularmente. Fronteira clara, nomenclatura consistente, padrao previsivel. Eh tipo escrever codigo otimizado pra compreensao humana E de maquina ao mesmo tempo.
Na Yooga a gente tem testado isso pro sistema de PDV. Codebase grande, centenas de arquivos em multiplos bounded contexts. Poder perguntar "como um pagamento flui do terminal ate o modulo fiscal" e receber resposta precisa que referencia codigo real eh de arrepiar.
A era do "deixa eu te passar os arquivos relevantes" ta morrendo. A era do "toma tudo, tu descobre o que importa" ta comecando. E honestamente? A IA eh melhor em descobrir o que eh relevante do que eu.
Mais uma coisa: isso muda a economia de organizacao de codigo. Monorepo fica MAIS atraente quando tua ferramenta de IA consegue engolir tudo. O custo de navegar codebase grande cai pra zero quando teu assistente ja leu tudo.
A gente mal ta arranhando a superficie do que isso significa pra dev. E eu to aqui pra ver acontecer.