Ideia

Um enquadramento técnico explícito acelera um assistente em vez de limitá-lo

Info

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?