Codebase meno telepatiche. AI-readability per applicazioni Laravel

Abstract

Gli AI agent fanno ormai parte del workflow quotidiano di molti sviluppatori: leggono repository, rispondono a domande sul codice, propongono modifiche e supportano attività di review. Ma accedere ai file di un progetto non significa comprenderne davvero il comportamento.

Molte applicazioni Laravel sono “telepatiche”: richiedono conoscenza implicita o non scritta per essere capite. Regole di dominio sparse tra controller, model, policy, job, listener e test; decisioni architetturali mai documentate; nomi generici; convenzioni note solo al team.

Questo talk introduce l’AI-readability come qualità architetturale: rendere una codebase più esplicita, ispezionabile e verificabile anche dagli strumenti AI.

Vedremo come riesumare la conoscenza sepolta negli artifact Laravel — route, model, policy, job, eventi, listener, command e test — e trasformarla in contesto strutturato: manifest dell’applicazione, audit di leggibilità, prompt con fonti, diff architetturali e ADR inferiti da codice e test.

Il problema non è che l’AI non sappia leggere nella mente del team. Il problema è che troppe codebase lo richiedono.