A forma mais comum de enviar código para uma IA ainda é selecionar arquivos manualmente, compactar uma pasta ou colar trechos. Esse fluxo parece simples, mas esconde decisões importantes: quais arquivos foram excluídos, qual commit originou o contexto, se havia segredos no pacote e se a mesma seleção pode ser reproduzida depois.
O TreeSift nasceu para tratar esse handoff como um artefato de engenharia. O objetivo não é escolher magicamente o que a IA deveria ler, mas tornar a seleção determinística, explicável e verificável.
Quatro mecanismos sustentam esse desenho:
- Seleção determinística e regras de ignore respeitando o escopo de cada diretório
- Proveniência Git, hashes e manifests para reconstruir o estado do handoff
- Políticas conservadoras para segredos, binários e arquivos locais sensíveis
- Separação explícita entre dados do repositório e arquivos que contêm instruções para agentes
A principal decisão arquitetural foi evitar um classificador que decide quais arquivos são 'importantes'. Essa abordagem parece conveniente, mas cria comportamento oculto e torna difícil explicar por que um arquivo entrou ou saiu do contexto. No TreeSift, a seleção permanece controlada por regras observáveis.
O mesmo núcleo de seleção alimenta tanto os bundles de contexto quanto ZIP, TAR e TAR.GZ. Isso evita manter duas definições diferentes do que pertence ao projeto e reduz drift entre o que é analisado e o que é empacotado.
Snapshots e deltas permitem que interações posteriores enviem somente mudanças desde um handoff anterior. O ganho não é apenas redução de tokens; é preservação de uma linha de proveniência entre estados do projeto.
Context engineering deveria ser tratado como prompt engineering ou como uma etapa reproduzível do pipeline de software?
Quando contexto vira artefato, ele pode ser revisado, comparado, versionado e validado como qualquer outra saída do processo de engenharia.
Isso não elimina risco: detecção de segredos nunca é perfeita e estimativa de tokens não substitui o tokenizer real do modelo. A vantagem é tornar essas limitações explícitas em vez de escondê-las dentro de uma etapa manual.
Critério de design
Um agente deve receber o máximo de contexto possível, ou o contexto mínimo cuja origem e seleção conseguimos explicar?
Fontes e referências de apoio
Estas são algumas das obras, estudos e instituições usadas como base conceitual para os argumentos do texto.
Fonte primária para arquitetura, comportamento determinístico, políticas de segurança, manifests e workflow de contexto.