Idea principale

Un quadro posto attorno alla produzione di software viene spontaneamente letto come un vincolo: regole, limiti, cose che non si ha il diritto di fare. Su un assistente, questa lettura è sbagliata nella maggior parte dei casi.

Lasciato da solo davanti a una codebase che non conosce, un assistente cerca. Prende un'API interna che non è quella giusta, entra da un punto d'ingresso deprecato, ricostruisce un componente che esisteva già, aggira l'architettura esistente perché non l'ha vista. Queste deviazioni consumano tempo, producono codice da buttare e generano incoerenza — non perché l'assistente sia scadente, ma perché l'informazione che gli avrebbe evitato la deviazione non era disponibile da nessuna parte.

Un catalogo delle API interne utilizzabili, una documentazione funzionale generata dal codice, una mappa tra concetti di business e punti d'ingresso tecnici, esempi di richieste, componenti di interfaccia riutilizzabili, convenzioni, file di istruzioni e skill: ognuno di questi oggetti elimina una ricerca. Il quadro non riduce lo spazio delle soluzioni, elimina il costo per entrarci.

Perché è importante

Ribalta l'argomento economico con cui si discute un investimento di piattaforma. Finché i binari vengono presentati come una protezione, si negoziano contro le scadenze e perdono. Presentati come la condizione di velocità di tutto ciò che verrà prodotto dopo, cambiano categoria di spesa.

Dice anche cosa distingue, per un assistente, una codebase accogliente da una chiusa: non la sua eleganza, ma la quantità di informazioni che mette a disposizione senza bisogno di indovinarle.

Sfumature e limiti

L'effetto presuppone che il quadro sia aggiornato. Un catalogo di API obsoleto è peggio di nessun catalogo: indirizza con sicurezza sulla strada sbagliata, e niente nell'output segnala l'errore.

E il quadro ha un costo di costruzione e di manutenzione, che si ripaga solo su una produzione ripetuta. Per un oggetto unico non si giustifica.

Domande aperte

• Tra questi binari, quali vanno scritti per gli umani e quali per un assistente, quando uno stesso file non riesce a servire bene entrambe le letture?