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.

The first time I saw this folder on the PrestaShop develop branch, I assumed it was an experiment. It's far more structured than that.

The .ai/ is a hierarchical context system for AI agents. The full structure:

.ai/