Escrito originalmente em francês. Traduzido por IA — o sentido foi preservado, não a prosa.
Ideia principal
Um enquadramento colocado em torno de uma produção de software é lido espontaneamente como restrição: regras, limites, coisas que não se tem o direito de fazer. No caso de um assistente, essa leitura é falsa na maioria dos casos.
Deixado sozinho diante de uma base de código que não conhece, um assistente procura. Ele pega uma API interna que não é a certa, entra por um ponto de entrada obsoleto, reconstrói um componente que já existia, contorna a arquitetura existente porque não a viu. Esses desvios consomem tempo, produzem código para jogar fora e fabricam incoerência — não porque o assistente seja ruim, mas porque a informação que teria evitado o desvio não estava disponível em lugar nenhum.
Um catálogo de APIs internas utilizáveis, uma documentação funcional gerada a partir do código, uma correspondência entre conceitos de negócio e pontos de entrada técnicos, exemplos de consultas, componentes de interface reutilizáveis, convenções, arquivos de instruções e skills: cada um desses objetos elimina uma busca. O enquadramento não reduz o espaço das soluções, ele elimina o custo de entrar nele.
Por que isso importa
Isso inverte o argumento econômico com que se discute um investimento em plataforma. Enquanto os trilhos forem apresentados como proteção, eles são negociados contra prazo e perdem. Apresentados como a condição de velocidade de tudo o que vier a ser produzido depois, mudam de categoria de despesa.
Isso também diz o que distingue uma base de código acolhedora de uma base fechada para um assistente: não a beleza dela, mas a quantidade de informação que ela disponibiliza sem que seja preciso adivinhar.
Nuances e limites
O efeito pressupõe que o enquadramento esteja atualizado. Um catálogo de APIs vencido é pior que nenhum catálogo: ele aponta com segurança para o caminho errado, e nada na saída sinaliza o erro.
E o enquadramento tem um custo de fabricação e de manutenção, que só se paga numa produção repetida. Ele não se justifica para um objeto único.
Questões em aberto
- Entre esses trilhos, quais precisam ser escritos para humanos e quais para um assistente, quando um mesmo arquivo não consegue servir bem às duas leituras?