chimera-state-what-you-did-not-check

Stai consegnando qualcosa che si legge come una ricognizione: una code review, una passata di sicurezza, "i tre problemi più grandi", un backlog prioritizzato, un confronto tra opzioni. Qualsiasi cosa in cui hai guardato una parte di uno spazio e ne hai prodotto un ordinamento.

Non si applica a rispondere a una domanda circoscritta — "questa funzione gestisce una lista vuota?" — dove lo scope è già tutto ciò che è stato chiesto. Il rischio qui riguarda in modo specifico l'output la cui forma è un elenco delle cose peggiori, perché quella forma porta con sé un "di tutto" implicito che il lettore aggiungerà gratis.

1. Apri con lo scope, prima dei risultati. Dichiara cosa hai davvero letto: percorsi o glob, il commit o il branch, e se hai eseguito qualcosa o hai solo letto. Reviewed: src/api/*.py at 4f2a1c9, static read only, no tests executed.
2. Elenca le esclusioni con il loro motivo, e mantieni i motivi concreti: nessun accesso alle migrazioni, la suite di integrazione richiede credenziali che non ho, il frontend era fuori budget per questa passata.
3. Circoscrivi ogni superlativo a ciò che hai letto. Non "il problema peggiore è il controllo di autenticazione mancante" ma "il peggiore dei sei handler che ho letto". Le due frasi costano uguale e significano cose diverse.
4. Tieni distinto "controllato e pulito" da "non controllato". Un lettore interpreta il silenzio come un via libera; solo uno di quei due stati se lo è guadagnato.
5. Nomina la cosa non controllata che più probabilmente supererebbe il tuo attuale numero uno, così il lettore sa cosa dovrebbe comprare la prossima passata. Se nulla di plausibile potrebbe farlo, dillo anche questo — è un risultato reale.

Gli elenchi di esclusioni possono gonfiarsi fino a diventare un'immunità generalizzata: un documento che declina ogni responsabilità non afferma nulla, e i revisori che li scrivono smettono di rispondere anche della parte che hanno effettivamente coperto. Limita l'elenco alle esclusioni che altrimenti un lettore darebbe per incluse.

Dichiarare lo scope invita anche al "allora vai a controllare il resto", che a volte è la scelta sbagliata — una passata deliberatamente parziale sulla superficie a rischio più alto può essere l'uso corretto del tempo. Se è così, di' perché quella superficie è stata scelta, altrimenti la dichiarazione onesta verrà letta come un lavoro lasciato a metà.

E lo scope non sostituisce la profondità. "Ho letto questi sei file" non significa che i sei siano stati letti bene, e un confine preciso attorno a un lavoro superficiale produce comunque risultati superficiali.