Skip to content

Hi, I’m Roberto. I build things with Laravel, and with solder and wood.

Notes on PHP packages, home automation, synthesizers and DIY, written as I go.

More about me →

Latest posts

See all →

Without evals, every change is a guess

Why an AI agent needs evals before its next prompt or model change, what makes an agent harder to evaluate than a single LLM call, and the task, run and grade loop every eval is built on.

Books

See all →

Latest video

See all →

Glowing LED Christmas tree star

The Christmas LED topper glowing on top of the tree. Music: "Stacks Of Stuff" by Simon Panrucker and "Little Star" by Manuele Atzeni.

Next talk

See all →

International PHP Conference Munich 2026 · Munich, Germany

Less Telepathic Codebases: AI-Readability for Laravel Applications

AI agents are now part of many developers’ daily workflows: they read repositories, answer questions about code, suggest changes, and support review activities. But having access to a project’s files does not mean truly understanding its behavior. Many Laravel applications are “telepathic”: they require implicit or unwritten knowledge to be understood. Domain rules are scattered across controllers, models, policies, jobs, listeners, and tests; architectural decisions are never documented; names are generic; conventions are known only to the team. This talk introduces AI-readability as an architectural quality: making a codebase more explicit, inspectable, and verifiable by AI tools as well. We will see how to unearth the knowledge buried in Laravel artifacts — routes, models, policies, jobs, events, listeners, commands, and tests — and turn it into structured context: application manifests, readability audits, source-grounded prompts, architectural diffs, and ADRs inferred from code and tests. The problem is not that AI cannot read the team’s mind. The problem is that too many codebases require it to.