O Substrato se Adapta: Design Systems, Documentação e Julgamento na Era dos Agentes

Em uma única semana do final de abril de 2026, três autores de três cantos não relacionados do mundo de software escreveram, em essência, o mesmo ensaio.

David Hoang argumentou que design systems agora são sistemas de inferência. Simon Aronsson decretou o fim do “pergunta para a Sarah.” Kent C. Dodds chamou julgamento de a última habilidade de engenharia que escala. Vocabulários diferentes, públicos diferentes, domínios diferentes. A convergência é o ponto.

Cada um estava observando agentes colidirem com o mesmo tipo de artefato. Tokens que guardam valores. Documentação que vive na cabeça das pessoas. Passos de implementação que costumavam ser o trabalho em si. E cada um chegou à mesma conclusão: o artefato, como está, não sobrevive a agentes em escala. O substrato tem que subir.

Esta é uma afirmação no nível do substrato, não uma afirmação de design, documentação ou engenharia. A camada por baixo do seu time — a que silenciosamente carregava significado entre pessoas, tempo e contexto — está sendo convocada para um trabalho que ela nunca foi projetada para fazer. Você não tem um problema de ferramenta. Você tem um problema de substrato.

Três autores, uma mudança

O argumento de Hoang é mais afiado onde dói mais. Em um sistema estático, um design token como --brand-blue: #0066FF é suficiente. Um designer humano lê o nome, infere a situação e aplica corretamente. Um agente não tem o mesmo contexto de corredor. Quando solicitado a desenhar um layout que nunca viu, o agente precisa fazer uma escolha defensável. #0066FF diz que cor renderizar. Não diz nada sobre o porquê.

A prescrição de Hoang: tokens têm que codificar intenção, não valores. --color-interactive-primary é uma decisão defensável sobre a qual o agente consegue raciocinar. #0066FF é uma amostra de tinta. O agente não precisa de uma paleta mais rica. Ele precisa de uma ontologia mais rica.

Aronsson faz a mesma jogada na documentação. O título do ensaio dele já é o diagnóstico: “O Fim do Pergunta para a Sarah.” Por duas décadas, times saudáveis de engenharia rodaram sobre conhecimento tribal. A pessoa sênior que sabia qual serviço era crítico. A PM que lembrava por que a migração havia sido pausada. O on-call que entendia que um alerta era falso positivo nas terças. Esse conhecimento vivia entre as sessões, na continuidade humana.

Agentes não têm continuidade. Toda sessão começa do zero. A frase que dá título ao ensaio: “o conhecimento que costumava viver entre as sessões agora precisa viver em algum lugar que sobreviva ao fim da sessão.” Se o conhecimento institucional do seu time era a Sarah, o conhecimento institucional do seu time agora é o que quer que as sucessoras da Sarah consigam carregar para dentro do contexto. ADRs, runbooks, logs de decisão. Não porque o compliance pediu. Porque seus agentes falham sem isso.

Dodds completa o triângulo pelo lado da engenharia. À medida que o custo de implementação despenca, a alavanca sobe na pilha. Escrever a função não é mais onde mora a dificuldade. “Quando o custo de atirar cai, escolher o alvo importa mais, não menos.” A habilidade que compõe não é velocidade de digitação; é o julgamento para escolher qual problema merece uma função em primeiro lugar. Implementação está virando uma commodity que o agente fornece. O gargalo é a pessoa decidindo o que vale a pena implementar.

Três domínios. Três autores. Uma mudança.

O padrão por baixo

Tire o vocabulário e o que sobra é idêntico. Em cada caso, um substrato estático bastava enquanto humanos carregavam o contexto faltante na cabeça. Em cada caso, os agentes chegaram sem esse contexto, e o substrato cedeu.

A correção, em cada caso, tem o mesmo formato. Mover o que era implícito para dentro do próprio substrato.

• Design: sair de valores e ir para intenção. O token tem que carregar o porquê.
• Documentação: sair da memória tribal e ir para decisões registradas. O ADR tem que carregar as alternativas rejeitadas, não só a vencedora.
• Julgamento: sair do “o time sabe” e ir para “o time escreve o que escolhe e por quê.” O log de decisão vira o artefato.

Não são três tendências. É uma tendência com três faces. O substrato subiu, e você tem que subir junto.

A pergunta de governança vem na sequência. Pela última década, governança foi um problema de “regras”: fazer cumprir padrões de código, fazer cumprir tokens de design, fazer cumprir gates de revisão. Esse enquadramento estava correto quando implementação era o gargalo. Está errado agora. O gargalo subiu. A governança precisa acompanhar.

A nova pergunta não é “como fazemos cumprir as regras” e sim “como mantemos o substrato que o agente precisa para tomar decisões defensáveis.” São trabalhos radicalmente diferentes. O primeiro é policiamento. O segundo é curadoria. A maioria dos times ainda está montada para o primeiro.

Por que isso bate em produção

A razão de isso importar agora, e não daqui a dezoito meses, é que o modo de falha não é teórico.

Um time que não promoveu seus tokens para intenção vai ver o agente gerar UI tecnicamente válida e contextualmente errada. Um time que não codificou seu conhecimento tribal vai ver o agente quebrar com confiança o serviço crítico que ninguém nunca documentou. Um time que não registrou seu julgamento vai ver o agente resolver o problema errado em velocidade impressionante. Nenhum desses casos parece falha de agente. Parecem falhas de substrato que o agente apenas expõe.

Já argumentamos isso pelo lado do design em Governança de Design na Era dos Agentes, e pelo lado da documentação em Codificando a Inteligência Institucional. O que é novo é a convergência. Quando três praticantes independentes escrevem o mesmo ensaio em uma semana, o custo de tratar cada um como tema de nicho sobe.

Este texto não estende o argumento de design nem o de documentação. Colapsa os dois. O substantivo é substrato.

Como é, na prática, “prontidão de substrato”

O teste honesto é desconfortável. A maioria dos times vai falhar em pelo menos um dos três.

Audite o substrato de design. Abra seu arquivo de tokens. Os nomes são amostras de tinta ou são decisões? --brand-blue é amostra de tinta. --color-interactive-primary é decisão. Se você não consegue dar a um agente um layout que ele nunca viu e confiar que ele escolha o token certo, seu design system ainda não atravessou.

Audite o substrato de documentação. Pegue as últimas três decisões de arquitetura do seu time. Cada uma está registrada com as alternativas rejeitadas incluídas? Não a vencedora — as perdedoras, e por que perderam. As alternativas rejeitadas são o que carrega a intenção adiante. Sem elas, o próximo agente (ou a próxima pessoa sênior, daqui a seis meses) vai re-litigar decisões que já estavam fechadas.

Audite o substrato de julgamento. Volte um mês na roadmap do seu time. De onde veio a escolha de alvos? Se a resposta é “intuição da pessoa staff”, você não tem um substrato de julgamento. Você tem um ponto único de falha que ainda não foi convocado a escalar para agentes que copiam o padrão dela mas não o raciocínio.

Se qualquer uma dessas três auditorias falha, você tem trabalho de substrato antes de trabalho de agente. A ordem importa. Colocar agentes em cima de um substrato despreparado produz saída rápida, confiante e errada. A sequência é substrato primeiro, agentes depois. Não o contrário.

O que sobrevive

O padrão que sobrevive à era dos agentes é aquele que coloca a intenção dentro do substrato onde humanos, agentes e o tempo conseguem ler. Tokens com nomes que se explicam. ADRs que preservam o que foi rejeitado. Logs de decisão que registram julgamento como artefato de primeira classe e não como modelo mental privado.

Não é uma nova pilha de ferramentas. É uma nova disciplina aplicada a artefatos que você já tem. O trabalho é pouco glamuroso, o payoff é estrutural, e o custo de pular isso escala com a seriedade com que seu time pretende usar agentes.

Hoang, Aronsson e Dodds não estavam se coordenando. Não precisavam. Cada um olhou seu canto do substrato e reportou o que viu. A mesma coisa.

O substrato subiu, e você tem que subir junto.

---

Fontes

• Hoang, David. “Design Systems are now Inference Systems.” Proof of Concept, abril de 2026.
• Aronsson, Simon. “The End of Just Ask Sarah.” simme.dev, abril de 2026.
• Dodds, Kent C. “The Last Software Engineer.” epicproduct.engineer, abril de 2026.

A Victorino faz auditoria de prontidão de substrato — design systems, documentação, logs de decisão — para times levando agentes de IA à produção: contato@victorino.com.br | www.victorino.com.br