Definizione breve

Insieme degli oggetti che un team di sviluppo mette a disposizione perché un terzo — umano o assistente — possa produrre sulla codebase senza doverne indovinare il funzionamento: catalogo delle API interne, componenti riutilizzabili, convenzioni, ambienti delimitati, controlli automatici, file di istruzioni e skill.

Definizione dettagliata

Nell'uso corrente, «mettere dei binari» significa impedire di uscire di strada: la parola appartiene al vocabolario del guardrail e designa un limite imposto a qualcuno di cui non ci si fida.

Negli articoli di questo blog il termine conserva questo senso ma non si riduce a esso, ed è il secondo senso il più efficace: un binario indica la strada tanto quanto impedisce di uscirne. Un catalogo delle API interne dice cosa chiamare, una mappa tra concetti di business e punti d'ingresso tecnici dice dove andare, componenti di interfaccia riutilizzabili evitano di ricostruire. Quello che si guadagna posandoli non è anzitutto sicurezza, è tempo: quello che l'assistente passerebbe a cercare, a sbagliare ingresso o a riscrivere ciò che esiste.

I binari si distinguono così per il loro destinatario: non servono a chi li scrive, ma a chi produce dopo.

Uso nel dominio

Il termine si usa nelle decisioni di investimento sulla piattaforma e nella discussione sull'apertura di una codebase a profili che non sviluppano. Permette di porre la questione in termini diversi dall'autorizzazione: non «chi ha il diritto di produrre?» ma «che cosa è stato preparato perché produrre sia possibile?».

Sinonimi e varianti

«Piattaforma interna», «base comune», «golden path» nel vocabolario del platform engineering. La parola binari resta più ampia: copre anche i file di istruzioni e le skill destinati agli assistenti, che il vocabolario di piattaforma non comprende.

Da non confondere con

• Guardrail — dispositivo la cui unica funzione è impedire un'azione pericolosa. Un controllo di sicurezza in integrazione continua è un guardrail; fa parte dei binari, ma i binari non si riducono a questo.
• Directive — regola scritta che codifica un modo di lavorare a uso di un agente. Una direttiva è uno dei binari possibili, sotto forma di testo letto dall'assistente.
• Documentazione — testo destinato a essere letto da un umano per capire. Alcuni binari sono documentazione, altri sono oggetti eseguibili: componenti, ambienti, controlli.

Esempi

Un ambiente in cui un Product Manager compone schermate interne, strumenti di interrogazione, liste o grafici appoggiandosi ad API documentate e validate, mentre tutto lo strato operativo è stato costruito dagli sviluppatori.

Ambiguità / dibattiti

La parola viene quasi sempre intesa nel suo senso restrittivo, ed è questo che fa perdere le decisioni di investimento: presentati come una protezione, i binari si negoziano contro una data di consegna. La tensione tra i due sensi non è risolta nell'uso generale; qui è risolta a favore del senso doppio.