================================================================================
BROUILLON ARTICLE BLOG — WordPress (HTML + méta) — RELANCE CTR
Sujet : développement assisté par IA sur PrestaShop 9 (contexte .ai/, CONTEXT.md)
Source technique : https://devdocs.prestashop-project.org/9/development/ai-assisted-development/
(Licence doc : CC BY-SA 4.0 — rédaction originale en français.)
================================================================================

--- YAML — jeu principal (publication recommandée) --------------------------------

titre_h1_blog: "PrestaShop 9.2 t’envoie un copilote dans le repo : voici ce que Cursor lit avant toi"
titre_seo: "PrestaShop 9.2 + IA : le fichier que Cursor lit avant toi (anti-legacy)"
slug: prestashop-9-ia-contexte-repo-cursor
meta_description: "Ton IA refait du ObjectModel alors que le cœur veut du CQRS ? PrestaShop embarque du contexte dans le dépôt — découvre lequel, pour quel outil, et à partir de quelle version. Le 3e piège te coûte le plus cher."
focus_keyword: "PrestaShop développement IA"
focus_keyword_alt: "contexte IA PrestaShop Cursor"
categorie_wp: PrestaShop
tags: prestashop, prestashop 9, intelligence artificielle, Cursor, GitHub Copilot, développement, CQRS

--- Variantes titre_seo + meta (A/B manuel ou choix éditorial) -------------------

# Variante A — « peur » douce + promesse (safe)
titre_seo_A: "PrestaShop 9 : ton IA te sabote le code sans ce contexte intégré"
meta_description_A: "ObjectModel au lieu de CQRS, multishop oublié… Si ça te parle, PrestaShop a une réponse officielle. Découvre les fichiers versionnés que Cursor et Copilot doivent lire — et depuis quelle version."

# Variante B — curiosité / chiffre implicite (9.2)
titre_seo_B: "PrestaShop 9.2 : pourquoi ton repo embarque enfin un cerveau pour l’IA"
meta_description_B: "Un seul CONTEXT.md, six outils (Cursor, Copilot, Claude…). On t’explique le tableau des dépôts, le dossier .ai/, et ce que tu changes lundi dans ton équipe."

# Variante C — opposition (pro / flamby)
titre_seo_C: "IA sur PrestaShop : prompt géant VS fichiers dans le Git — lequel gagne ?"
meta_description_C: "Spoiler : le prompt se perd, le Git reste. Compare les deux approches, vois les pointeurs officiels, et pars avec une checklist avant ta prochaine PR."

--- HTML (corps à coller dans l’éditeur) ----------------------------------------

<p><strong>Ton IA ne « connaît » pas PrestaShop.</strong> Elle devine. Et sur un cœur aussi chargé, deviner, c’est te recoller du legacy en boîte.</p>

<p>Tu codes déjà avec Cursor, Copilot ou Claude ? Parfait — jusqu’au jour où une PR te remet du <strong>ObjectModel</strong> là où l’archi veut du <strong>CQRS</strong>, où le <strong>multishop</strong> saute, où une couche appelle la base depuis un endroit interdit. Là, tu comprends : sans carte, l’IA est un GPS dans un champ de mines.</p>

<p>La doc officielle PrestaShop appelle ça l’<a href="https://devdocs.prestashop-project.org/9/development/ai-assisted-development/" rel="noopener noreferrer">AI-Assisted Development</a> : des <strong>fichiers de contexte versionnés</strong> dans le dépôt, lus par les outils. Pas une option BO. Pas une « recette LinkedIn ».</p>

<p>Tu veux savoir :</p>
<ul>
  <li>pourquoi le projet pousse ça <em>maintenant</em> ;</li>
  <li>où vit le contexte (<code>CONTEXT.md</code>, <code>.ai/</code>, pointeurs) ;</li>
  <li>quel dépôt a quoi <strong>aujourd’hui</strong> vs à partir de <strong>9.2</strong> ;</li>
  <li>ce que tu changes <strong>demain matin</strong> dans ton équipe.</li>
</ul>

<p>Je te file le plan — et les liens pour creuser sans bullshit.</p>

<!--more-->

<h2>Sommaire</h2>
<ol>
  <li><a href="#pourquoi-contexte">Pourquoi ton IA « invente » du legacy (et le remède officiel)</a></li>
  <li><a href="#design-agnostique">Un seul cerveau pour six outils : le pari qui t’évite la config enfer</a></li>
  <li><a href="#fichiers-racine">Les noms de fichiers que Cursor et Copilot vont chercher à la racine</a></li>
  <li><a href="#depots">Qui a déjà le .ai/ complet — et qui se contente d’un CONTEXT.md ?</a></li>
  <li><a href="#pratique">Lundi matin : Git, prompts, CI — ce que j’applique en vrai</a></li>
  <li><a href="#pieges">4 erreurs si tu laisses l’IA en roue libre (la 4e te coûte cher)</a></li>
  <li><a href="#contexte-vs-prompt">Gros prompt dans le chat VS fichiers Git : qui gagne ?</a></li>
  <li><a href="#agences">Framing client : ce que tu peux promettre sans te planter</a></li>
  <li><a href="#aller-plus-loin">Les 3 pages devdocs à lire dans l’ordre</a></li>
  <li><a href="#faq">Questions / Réponses (dont quelques « Vrai ou faux »)</a></li>
  <li><a href="#conclusion">Conclusion — ce que j’en fais</a></li>
</ol>

<h2 id="pourquoi-contexte">Pourquoi ton IA « invente » du legacy (et le remède officiel)</h2>

<p>PrestaShop, c’est une base <strong>mature</strong> : règles d’archi, frontières legacy / moderne, patterns métier (panier, règles panier, catalogue…). Aucun modèle généraliste ne devine ça à ta place. Sans consigne explicite, l’assistant tend à :</p>
<ul>
  <li>réécrire du code <strong>déprécié</strong> autour d’<code>ObjectModel</code> au lieu des commandes / queries attendues ;</li>
  <li>oublier le <strong>multistore</strong> ;</li>
  <li><strong>mélanger les couches</strong> (ex. accès base depuis un endroit où le domaine dit non) ;</li>
  <li>rater les <strong>conventions de nommage</strong> du projet.</li>
</ul>

<p>Les fichiers de contexte = une <strong>source de vérité unique</strong> que les outils consomment avant de te proposer un patch. C’est posé noir sur blanc sur la page <a href="https://devdocs.prestashop-project.org/9/development/ai-assisted-development/" rel="noopener noreferrer">AI-Assisted Development</a>.</p>

<h3>Ce que ce n’est pas</h3>
<p>Pas un plugin magique en back-office. Pas une config à refaire sur chaque laptop : c’est dans <strong>Git</strong>, donc toute l’équipe tire la même ligne.</p>

<h2 id="design-agnostique">Un seul cerveau pour six outils : le pari qui t’évite la config enfer</h2>

<p>L’idée : ne pas multiplier les fichiers divergents (un pour Cursor, un pour Copilot…). Le socle vit dans des <strong><code>CONTEXT.md</code></strong> — Markdown lisible humain + machine (règles, standards, do / don’t, domaine).</p>

<p>Des <strong>pointeurs</strong> à la racine redirigent chaque outil vers ce socle. Tu maintiens <strong>un endroit</strong>, tout le monde reste aligné.</p>

<h2 id="fichiers-racine">Les noms de fichiers que Cursor et Copilot vont chercher à la racine</h2>

<p>Tableau officiel — les noms comptent, sinon l’outil ne suit pas :</p>

<table border="1" cellpadding="8" cellspacing="0">
  <thead>
    <tr>
      <th>Fichier</th>
      <th>Outil</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>CLAUDE.md</code></td><td>Claude Code</td></tr>
    <tr><td><code>AGENTS.md</code></td><td>Agents IA génériques</td></tr>
    <tr><td><code>.cursor/rules/prestashop-context.mdc</code></td><td>Cursor</td></tr>
    <tr><td><code>.github/copilot-instructions.md</code></td><td>GitHub Copilot</td></tr>
    <tr><td><code>.windsurfrules</code></td><td>Windsurf</td></tr>
    <tr><td><code>GEMINI.md</code></td><td>Gemini CLI</td></tr>
  </tbody>
</table>

<p>Même dépôt, plusieurs IDE : tout le monde lit la même « carte » — si les pointeurs sont bien sur <strong>ta branche</strong>.</p>

<figure class="wp-block-image">
  <img src="PLACEHOLDER-schema-contexte-ia-prestashop.png" alt="Schéma : CONTEXT.md PrestaShop relié aux pointeurs Cursor, Copilot, Claude" width="1200" height="675" loading="lazy" />
  <figcaption>Visuel à produire : une source de vérité, plusieurs outils — bon pour le partage et la rétention.</figcaption>
</figure>

<h2 id="depots">Qui a déjà le .ai/ complet — et qui se contente d’un CONTEXT.md ?</h2>

<p>La doc est claire sur <strong>quel dépôt</strong> embarque <strong>quel niveau</strong> de contexte :</p>

<table border="1" cellpadding="8" cellspacing="0">
  <thead>
    <tr>
      <th>Dépôt</th>
      <th>Ce que tu récupères</th>
      <th>Depuis</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><a href="https://github.com/PrestaShop/PrestaShop" rel="noopener noreferrer">PrestaShop/PrestaShop</a></td>
      <td>Hiérarchie complète <code>.ai/</code> (domaines, composants…)</td>
      <td><strong>PrestaShop 9.2</strong></td>
    </tr>
    <tr>
      <td><a href="https://github.com/PrestaShop/ps_apiresources" rel="noopener noreferrer">ps_apiresources</a></td>
      <td><code>CONTEXT.md</code> + pointeurs</td>
      <td>Déjà là</td>
    </tr>
    <tr>
      <td><a href="https://github.com/PrestaShop/hummingbird" rel="noopener noreferrer">hummingbird</a></td>
      <td><code>CONTEXT.md</code> + pointeurs</td>
      <td>Déjà là</td>
    </tr>
  </tbody>
</table>

<p>Traduction : tu peux <strong>t’entraîner</strong> sur Hummingbird / ps_apiresources avant que le cœur 9.2 ne t’apporte le gros pack <code>.ai/</code>. Pour le « pourquoi 9 » côté produit, garde sous la main mon guide <a href="https://www.arnaud-merigeau.fr/prestashop-9/">PrestaShop 9 : nouveautés et conseils</a> — et pour les nouveautés 9.1, <a href="https://www.arnaud-merigeau.fr/prestashop-9-1-nouvelles-fonctionnalites/">PrestaShop 9.1</a> si tu enchaînes les versions.</p>

<h2 id="pratique">Lundi matin : Git, prompts, CI — ce que j’applique en vrai</h2>

<h3>1. Branche à jour, sinon tu codes avec une carte périmée</h3>
<p>Sans les fichiers sur la branche, l’IA ne les voit pas. Sur un fork client : <strong>rebase / merge upstream</strong> pour hériter des mises à jour de contexte.</p>

<h3>2. Ouvre l’IDE à la racine du repo</h3>
<p>Cursor lit <code>.cursor/rules/prestashop-context.mdc</code>. Un <code>.cursorrules</code> perso qui contredit le CONTEXT du projet = deux pilotes pour une voiture.</p>

<h3>3. Prompts qui citent le dépôt</h3>
<p>« En respectant CONTEXT.md, propose… » bat « fais-moi un module PrestaShop » à plate couture.</p>

<h3>4. CI inchangée — le contexte ne remplace pas les tests</h3>
<p>Tu peux demander une <strong>pré-review</strong> (« écarts probables vs CONTEXT ») avant push ; la merge, c’est toujours humain + CI sur le sensible.</p>

<h3>5. Revue humaine sur le dur</h3>
<p>Paiement, droits BO, cœur catalogue : l’IA accélère, elle ne signe pas à ta place.</p>

<h2 id="pieges">4 erreurs si tu laisses l’IA en roue libre (la 4e te coûte cher)</h2>
<ul>
  <li><strong>Legacy qui revient</strong> — tu recules sur la dette que le projet veut payer.</li>
  <li><strong>Multistore cassé</strong> — bugs intermittents, recette longue.</li>
  <li><strong>Couches mélangées</strong> — dette d’upgrade + sécurité.</li>
  <li><strong>CONTEXT jamais mis à jour</strong> — l’IA <em>fossilise</em> de mauvaises règles ; coût : tout le monde « sait » faux. Lire <a href="https://devdocs.prestashop-project.org/9/development/ai-assisted-development/maintaining-context/" rel="noopener noreferrer">Maintaining Context Files</a>.</li>
</ul>

<h2 id="contexte-vs-prompt">Gros prompt dans le chat VS fichiers Git : qui gagne ?</h2>

<p>Le prompt géant dans le chat : ça marche cinq minutes, puis tu copies une <strong>vieille version</strong>, tu perds le fil entre deux clients. Le modèle PrestaShop — Markdown <strong>versionné</strong> + pointeurs — donne traçabilité (<code>git blame</code>), onboarding rapide, et le même socle pour Copilot et Cursor.</p>

<p>Ton prompt perso peut compléter ; il ne doit pas <strong>contredire</strong> le CONTEXT du repo.</p>

<h2 id="agences">Framing client : ce que tu peux promettre (sans te planter)</h2>

<p><strong>Oui</strong> : méthode plus fluide, moins de patches hors-charte, équipe qui monte en compétence sur les patterns modernes.</p>

<p><strong>Non</strong> : « zéro bug », « l’IA remplace l’expert ». Vends des <strong>indicateurs</strong> : PR plus courtes, moins de retours « hors archi » en recette.</p>

<figure class="wp-block-image">
  <img src="PLACEHOLDER-capture-devdocs-ai-assisted.png" alt="Capture page documentation PrestaShop AI-Assisted Development" width="1400" height="900" loading="lazy" />
  <figcaption>Capture devdocs = preuve + confiance (à ajouter).</figcaption>
</figure>

<h2 id="aller-plus-loin">Les 3 pages devdocs à lire dans l’ordre</h2>
<ul>
  <li><a href="https://devdocs.prestashop-project.org/9/development/ai-assisted-development/context-structure/" rel="noopener noreferrer">Context Structure</a></li>
  <li><a href="https://devdocs.prestashop-project.org/9/development/ai-assisted-development/using-ai-tools/" rel="noopener noreferrer">Using AI Tools with PrestaShop</a></li>
  <li><a href="https://devdocs.prestashop-project.org/9/development/ai-assisted-development/maintaining-context/" rel="noopener noreferrer">Maintaining Context Files</a></li>
</ul>
<p>Index : <a href="https://devdocs.prestashop-project.org/9/development/ai-assisted-development/" rel="noopener noreferrer">AI-Assisted Development</a>.</p>

<h2 id="faq">Questions / Réponses (dont quelques « Vrai ou faux »)</h2>

<p><strong>Vrai ou faux : « Sans CONTEXT, mon IA est nulle sur PrestaShop » ?</strong><br />
Faux — elle peut produire du code qui <em>compile</em>. Le risque, c’est l’alignement archi / multistore. Le CONTEXT réduit l’écart, il ne remplace pas le jugement.</p>

<p><strong>Est-ce que ça remplace la revue de code ?</strong><br />
Non. Jamais sur le cœur et les flux sensibles.</p>

<p><strong>Je suis en PrestaShop 8 : j’ai le même pack ?</strong><br />
La doc 9 décrit le pack officiel ; le <code>.ai/</code> complet cœur = <strong>9.2</strong>. En 8, tu peux t’inspirer en créant tes propres CONTEXT — ce n’est pas le même livrable amont.</p>

<p><strong>Je dois committer CLAUDE.md si personne n’utilise Claude ?</strong><br />
Si le dépôt amont le fournit, garde-le : les forks restent homogènes.</p>

<p><strong>Où corriger une erreur dans la doc ?</strong><br />
« Improve this page » sur devdocs → PR GitHub.</p>

<p><strong>Thème enfant / module maison : même principe ?</strong><br />
Oui : un <code>CONTEXT.md</code> interne + pointeurs = même discipline d’équipe.</p>

<h2 id="conclusion">Conclusion — ce que j’en fais</h2>

<p>Le « contexte dans le Git », ce n’est pas la hype IA : c’est une réponse <strong>propre</strong> à la taille du codebase. Ton gain : moins de friction entre proposition machine et ce que le projet accepte — si tu <strong>maintiens</strong> les CONTEXT comme du code.</p>

<table border="1" cellpadding="8" cellspacing="0">
  <thead>
    <tr>
      <th>Tu es…</th>
      <th>Mon move</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Cœur <strong>9.2+</strong></td>
      <td>J’active la hiérarchie <code>.ai/</code>, je forme l’équipe aux pointeurs, je lis les 3 pages devdocs.</td>
    </tr>
    <tr>
      <td><strong>Hummingbird / ps_apiresources</strong></td>
      <td>J’aligne mes prompts sur le <code>CONTEXT.md</code> déjà présent.</td>
    </tr>
    <tr>
      <td><strong>8.x ou 9.0 / 9.1</strong></td>
      <td>J’anticipe 9.2 ; j’écris déjà du CONTEXT module/thème maison.</td>
    </tr>
  </tbody>
</table>

<p><strong>CTA :</strong> migration, module critique, ou stratégie IA + revue à cadrer ? <a href="https://www.arnaud-merigeau.fr/contact/">Demande un devis</a>.</p>

<p><em>Sources : <a href="https://devdocs.prestashop-project.org/9/development/ai-assisted-development/">PrestaShop Developer Documentation — AI-Assisted Development</a> (CC BY-SA 4.0). Dernière mise à jour indiquée sur la page d’index au 16 avril 2026.</em></p>

================================================================================
FIN DU BROUILLON — relance CTR (variantes A/B/C + H2 + meta + intro scroll-stop)
================================================================================