The PrestaShop core README now contains an instruction you'd never seen in an open source project of this scale: "If using AI tools to write code, make sure your agent has read the .ai/CONTEXT.md file."
TL;DR — If you only have 30 seconds: PrestaShop added a
.ai/folder to its core repo with 57 domain contexts, 22 component contexts, pre-generated indexes, and reusable skills. It's an AI agent onboarding system, versioned directly alongside the code. It's an approach I should have adopted earlier on my own modules.
🧠 What the .ai/ Folder Actually Is
The first time I saw this folder on the is clear on this point: AI-generated code submitted as a contribution must meet the same quality standards as any other contribution.
Concretely, that means verifying the generated code:
- Follows the CQRS pattern where required
- Does not use
ObjectModelin new code - Respects multistore constraints
- Includes appropriate tests
This isn't a free pass. It's accelerated onboarding. The difference matters.
Conclusion
Let me be direct: PrestaShop's .ai/ folder looks like what technical documentation for agents should always have been — hierarchical, versionable, tool-agnostic. Does it replace a solid understanding of the codebase? No. Does it make an AI agent significantly more reliable on a project of this complexity? Absolutely.
I'll be adapting this approach on my own commercial modules. If you contribute to the PrestaShop core or build AI tooling on top of the ecosystem, read the CONTEXT.md before letting your agent touch the code.
Nicolas Dabène — PrestaShop & Laravel developer, custom solutions.
SOCIAL SHARE CARD GENERATOR