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.