O golden path foi desenhado para um usuário que pergunta. Se a documentação estava ambígua, o desenvolvedor buscava quem sabia. Se a opção certa não estava clara, usava o julgamento de quem conhece o contexto da empresa. O caminho funcionava porque havia um humano no meio completando o que estava subentendido.
O agente chegou nesse mesmo caminho. E não perguntou nada.
O que o humano completava em silêncio
Plataformas internas carregam premissas implícitas. O desenvolvedor que provisiona um ambiente sabe, sem que ninguém precise dizer, que banco de produção não se toca sem aprovação. Sabe que "escolha a região" quer dizer a região padrão da empresa, não qualquer uma disponível. Sabe que o template para serviços de baixo tráfego não é o mesmo para sistemas críticos.
Esse conhecimento mora nas pessoas. O agente não faz parte de nenhuma conversa de corredor, então não o tem.
Um levantamento recente com mais de 130 mil desenvolvedores mediu o efeito desse contexto implícito faltando. Em código novo e bem documentado, o ganho de produtividade com IA chega a 90%. Em bases de código desconhecidas, sem especificação explícita do que é o quê, a produtividade cai 19% em relação ao trabalho sem assistência. O agente não falhou porque é menos capaz. Falhou porque não tinha o contexto que o humano levaria da memória do projeto.
O contrato que precisa ser legível para uma máquina
Em agosto, o time de engenharia do Datadog publicou uma análise de como plataformas internas precisam mudar para servir agentes como usuários formais. A mudança principal não é de interface. É de contrato.
Capacidades expostas para agentes precisam ter entradas e saídas com tipos explícitos, esquemas estáveis e versionados, e limites e categorias de erro que uma máquina consiga ler sem interpretação. Um endpoint que retorna "erro inesperado" atende ao desenvolvedor, porque ele vai olhar o log e entender. Para o agente, é um beco sem saída.
A exigência é a mesma que o spec-driven development faz da especificação de produto: o que for ambíguo para uma máquina vai ser executado com a interpretação errada ou vai parar. Não há julgamento intermediário para compensar.
O que muda é onde essa exigência chega. Não é mais só sobre prompts e specs de produto. É sobre as APIs do próprio IDP. O contrato que a equipe de plataforma expõe para o agente precisa ser completo o suficiente para ser executável sem intervenção.
O dispatch que o humano não precisava
Quando o desenvolvedor acessa uma API de plataforma, usa credenciais que carrega desde o login e conhece intuitivamente o escopo do que está fazendo. Se avança além do esperado, alguém percebe no code review.
O agente vai usar as permissões que tiver. Se elas são amplas demais, ele age com um escopo que ninguém autorizou conscientemente.
O que o Datadog descreve como "dispatch" é a camada que resolve isso. Antes de cada tarefa, o agente passa por um ponto explícito de autorização: o sistema verifica o que está sendo pedido, define os limites da operação e emite credenciais que existem só pelo tempo daquela tarefa. Quando a tarefa termina, elas expiram.
É o princípio de menor privilégio de sempre, operacionalizado de um modo que funciona para um sistema que não tem julgamento próprio sobre o que é seguro tocar.
O que o agente expõe
O agente funciona como um teste de estresse do design da plataforma. Não porque seja difícil ou pouco cooperativo, mas porque executa exatamente o que está escrito, não o que estava subentendido.
Toda ambiguidade escondida porque os desenvolvedores sabiam preencher, toda permissão larga porque "ninguém usa tudo isso", todo golden path que funcionava porque você sabia explicar os cantos difíceis — tudo aparece quando o agente chega.
Veera Ravindra Divi, da Platform Engineering, colocou assim: a responsabilidade do time de plataforma migra de controlar quem constrói para definir o que é construção segura. É uma diferença de locus de controle. Não um porteiro que decide caso a caso, mas uma plataforma que torna o caminho errado mais difícil de percorrer do que o certo.
Isso não é novo como princípio. É o que uma boa plataforma interna já deveria fazer. O agente traz urgência, porque você não consegue adiar a explicitação do contrato quando o usuário não vai pedir pra tirar uma dúvida antes de executar.
E o efeito colateral que vale notar: uma plataforma que o agente consegue usar sem ajuda é mais clara e mais segura do que qualquer uma que dependia do bom senso de quem chegava nela.
Referências
- Candace Shamieh, Shlomo Benyaminov, James Eastham – Golden Paths for AI agents: What changes when platform users aren't human? (Datadog, 25 ago 2026)
- Veera Ravindra Divi – Your Newest Platform User is an AI Agent — Build it a Golden Path (Platform Engineering, 24 jun 2026)
- Matt Li – AI Tools for Developer Productivity in 2026: What Actually Works (Second Talent, 27 ago 2026)