Idea principale

Un file di contesto all'inizio accoglie tutto ciò che arriva. Le informazioni sul palazzo, i fornitori, i cantieri — e, mescolate a queste, le istruzioni che dicono come trattare un omonimo, dove mettere la soglia tra piccoli e grandi debitori, come riconoscere la stessa persona sotto due cognomi. Tutto è utile, tutto è nello stesso posto, e il file supera le mille righe.

Eppure questi due contenuti non sono della stessa natura. Gli uni descrivono il condominio, gli altri descrivono il modo di descriverlo: è come mescolare la ricetta con gli ingredienti. La regola si scrive a freddo e vale finché non la si cambia; il materiale si scrive man mano che arrivano le email e non smette mai di crescere. Tenerli insieme fa sì che la parte stabile venga riletta ogni volta che la parte mobile si ingrossa, e che non si possa modificare l'una senza attraversare l'altra.

Un directives.md da una parte, un context.md dall'altra: la separazione non risolve il problema del volume — il materiale continua a gonfiarsi — ma rende possibile il resto. Finché le regole sono sepolte in ciò che governano, nessuna suddivisione successiva si può fare in modo pulito, perché non si sa che cosa vada duplicato in ogni pezzo e che cosa debba restare unico.

Perché è importante

Indica la prima suddivisione da fare, e non è quella che si crede. Davanti a un file troppo grande, il riflesso è tagliarlo per argomento; estrarre prima ciò che non è argomento — le regole — costa poco ed evita di ricopiare le stesse istruzioni in quindici file tematici.

Fornisce anche una domanda diagnostica applicabile a qualunque documento di lavoro condiviso con un agente: ogni paragrafo descrive il dominio, o il modo di trattarlo?

Sfumature e limiti

Il confine non è sempre netto. «I debitori sotto i cento euro si seguono a parte» è una regola di trattamento che contiene un fatto sul condominio, e andrà rivista insieme al fatto.

E la separazione aggiunge un file da tenere: se le direttive non vengono più rilette, continuano a essere applicate senza che nessuno ricordi perché esistono.

Domande aperte

• Dove mettere una regola che vale per un solo file tematico — nel file di regole comune, o accanto al materiale che riguarda?