Definição curta

Conjunto dos objetos que um time de desenvolvimento disponibiliza para que um terceiro — humano ou assistente — produza na codebase sem precisar adivinhar como ela funciona: catálogo de APIs internas, componentes reutilizáveis, convenções, ambientes enquadrados, verificações automáticas, arquivos de instruções e skills.

Definição detalhada

No uso corrente, "colocar trilhos" significa impedir que alguém saia da estrada: a palavra pertence ao vocabulário da salvaguarda, e designa um limite imposto a alguém de quem se desconfia.

Nos artigos deste blog, o termo guarda esse sentido, mas não se reduz a ele, e é o segundo sentido o mais operante: um trilho é tanto o que indica o caminho quanto o que impede de sair dele. Um catálogo de APIs internas diz o que chamar, uma correspondência entre conceitos de negócio e pontos de entrada técnicos diz para onde ir, componentes de interface reutilizáveis dispensam reconstruir. O que se ganha ao colocá-los não é, antes de tudo, segurança: é tempo — aquele que o assistente gastaria procurando, errando a porta de entrada, ou reescrevendo o que já existe.

Os trilhos se distinguem, assim, pelo destinatário: eles não servem a quem os escreve, mas a quem produz depois.

Uso no domínio

O termo serve nas arbitragens de investimento em plataforma, e na discussão sobre a abertura de uma codebase a perfis não desenvolvedores. Ele permite colocar a questão de outro jeito, fora do ângulo da autorização: não "quem tem o direito de produzir?", mas "o que está preparado para que produzir seja possível?".

Sinônimos e variantes

"Plataforma interna", "base", "golden path" no vocabulário do platform engineering. A palavra trilhos continua mais ampla: ela cobre também os arquivos de instruções e as skills destinados aos assistentes, que o vocabulário de plataforma não abrange.

Não confundir com

• Salvaguarda — dispositivo cuja única função é impedir uma ação perigosa. Uma verificação de segurança na integração contínua é uma salvaguarda; ela faz parte dos trilhos, mas os trilhos não se reduzem a ela.
• Diretriz — regra escrita que codifica um jeito de trabalhar, dirigida a um agente. Uma diretriz é um dos trilhos possíveis, em forma de texto lido pelo assistente.
• Documentação — texto destinado a ser lido por um humano para entender. Alguns trilhos são documentação, outros são objetos executáveis: componentes, ambientes, verificações.

Exemplos

Um ambiente em que um Product Manager compõe telas internas, consultas, listas ou gráficos apoiando-se em APIs documentadas e validadas, com toda a camada operacional construída pelos desenvolvedores.

Ambiguidades / debates

A palavra é quase sempre entendida no sentido restritivo, e é isso que faz perder as arbitragens: apresentados como uma proteção, os trilhos são negociados contra uma data de entrega. A tensão entre os dois sentidos não está resolvida no uso geral; aqui ela é resolvida em favor do sentido duplo.