The AI context files are committed directly in the repositories. No manual setup or configuration is needed – just open the project in your preferred tool and start working.
Claude Code automatically reads CLAUDE.md at the repository root, which points to .ai/CONTEXT.md. The full context hierarchy is available without any action from the developer.
Cursor reads the .cursor/rules/prestashop-context.mdc file, which references the .ai/ context. Rules are loaded automatically when the project is opened.
GitHub Copilot reads .github/copilot-instructions.md, which directs it to the .ai/ context. This works in both VS Code and JetBrains IDEs with the Copilot extension.
Windsurf reads .windsurfrules at the repository root, which points to the centralized context.
Gemini CLI reads GEMINI.md at the repository root.
For web-based AI assistants that don’t read repository files directly, you can copy the content of .ai/CONTEXT.md (and any relevant domain or component context) into the conversation as a system prompt or context message.
Most tools load the context files automatically. If your tool supports it, avoid overriding or skipping the project context. The guidance it contains reflects decisions validated by the project maintainers.
When working on a specific area, reference the relevant domain or component context. For example, if you’re working on cart-related code, mention that the AI should consult .ai/Domain/Cart/CONTEXT.md. Most tools handle this automatically based on the files you have open, but an explicit reference helps when the scope is ambiguous.
The context files significantly improve AI output quality, but they don’t eliminate the need for review. Always verify that generated code:
The .ai/skills/ folder in the core repository contains reusable task templates for common operations. These help AI assistants produce consistent output for tasks like adding a new CQRS command, creating a Grid definition, or scaffolding a new domain. Check the available skills before asking the AI to perform a task from scratch.
If you are an AI coding assistant working on PrestaShop code:
CONTEXT.md file at the root of the .ai/ folder (or at the repository root for smaller repos like ps_apiresources and hummingbird)..ai/Domain/{DomainName}/CONTEXT.md..ai/Component/{ComponentName}/CONTEXT.md..ai/GOTCHAS.md and .ai/MULTISTORE.md for cross-cutting concerns..ai/generated/ to discover existing CQRS commands, routes, entities, and hooks..ai/skills/ for task templates relevant to your current operation.