Un file README è il documento di apertura di un repository software. Spiega a cosa serve il progetto, come installarlo e come iniziare a usarlo. Nello sviluppo sicuro, un buon README aiuta gli utenti a capire il codice prima di eseguire qualsiasi cosa e spesso include passaggi di configurazione, dipendenze ed esempi di utilizzo.
Nel cyber security, i file README sono importanti perché gli aggressori possono sfruttare quella fiducia. Un README convincente può nascondere comandi dannosi all'interno di istruzioni di installazione ben curate, facendo sembrare legittimo un progetto falso sia alle persone sia agli strumenti automatici. I difensori dovrebbero considerare non attendibile il testo di configurazione basato su README finché la fonte non è verificata, soprattutto quando richiede comandi shell, installazioni di pacchetti o esecuzione guidata da agenti. Controllare la cronologia del repository, l'identità del manutentore, le firme e i riferimenti upstream aiuta a ridurre il rischio di attacchi alla supply chain e di social engineering.


