ChatGPT – Prompt Engineering

Un bon prompt est spécifique, testable et court. Il supprime les zones grises et impose un format de sortie exploitable par le dev (ou par un script).

🎯 Objectifs de clarté

• Dire ce qu’on veut (résultat observable) et ce qu’on ne veut pas (périmètre exclu).
• Fixer un format de sortie (ex. “bloc par fichier”, “diff unifié”, “JSON”).
• Fournir bornes : taille max, étapes, questions si dépassement.

✅ Check-list express (avant d’envoyer)

• Résultat attendu = 1 phrase mesurable.
• Contexte minimal (stack, versions, conventions) présent.
• Format de sortie imposé.
• Bornes (lignes, stop, validation) posées.
• Exemples si nécessaire (few-shot) → “imite ce style”.

🧱 Patron concis (copier/coller)

OBJECTIF : <livrable concret> (observable en 1 test / capture d’écran)
FORMAT : <bloc par fichier | diff | JSON>
CONTRAINTES : <versions, libs, style (PEP8), fichiers autorisés>
BORNES : si > 120 lignes cumulées ➜ STOP & pose une question

🧨 Mots ambigus à bannir (et alternatives)

“améliorer”, “optimiser”, “rendre joli” → préciser métrique / règle (ex. LCP < 2.5 s)
“fais tout”, “décide” → plan 3-5 étapes + valider étape 1
“génère un exemple” → format JSON valide + schéma

🧪 Auto-contrôle demandé au modèle

"Avant le code, rappelle en 3 puces (1) contraintes, (2) risques/alternatives,
(3) contrôles/tests pour vérifier la solution."

📌 Exemple clarifié

OBJECTIF : Créer un formulaire Contact Django (nom, email, message) avec honeypot + rate-limit IP.
FORMAT : bloc par fichier (chemin exact) + 3 tests pytest (ok / honeypot / throttle).
CONTRAINTES : Django 4.2, Bootstrap 5, PEP8, fichiers autorisés uniquement.
BORNES : <= 120 lignes cumulées, sinon STOP & question.

Le contexte alimente la fenêtre d’attention du modèle. Plus il est structuré et pertinent, plus la réponse est fiable (moins d’hallucinations).

📦 Context Pack — gabarit

PROJET : <nom> — <but produit>
STACK : Python 3.11, Django 4.2, MariaDB, Bootstrap 5
ARCHI : templates Django, static/js pour scripts, admin custom
CONVENTIONS : PEP8, CBV si pertinent, “bloc par fichier” pour les réponses
FICHIERS AUTORISÉS : models.py, admin.py, views.py, urls.py, templates/<app>/*.html, static/js/*.js
RÉFÉRENCES : <chemins ou modules utiles>

🧭 Contexte utile (et inutile)

• Utile : versions exactes, fichiers autorisés, organisation des dossiers, schémas de données, endpoints, contraintes légales/sécu.
• Inutile : longs historiques hors sujet, captures verbeuses, “bla-bla” marketing.

🧱 Repo snapshot (exemple raccourci)

accounts/
  models.py, admin.py, views.py, urls.py
ia/
  views.py, templates/ia/chatgpt_*.html
common/
  templates/common/base_dashboard_2025.html
static/js/landing_page.js

⚙️ Paramètres d’inférence recommandés (code)

• Température 0–0.3 (moins de variabilité).
• Sortie JSON quand c’est parsé côté back.
• Demande de preuves (grep, chemins, commandes) pour réduire l’invention.

🧩 Exemple complet

PROJET : Ideo-Lab
OBJECTIF : Ajout d’un modèle “Article” + admin + ListView + URL + template.
STACK/CONVENTIONS : Django 4.2, Bootstrap 5, PEP8, bloc par fichier.
FICHIERS AUTORISÉS : blog/models.py, blog/admin.py, blog/views.py, blog/urls.py, templates/blog/article_list.html
BORNES : <= 120 lignes ; sinon STOP & question.
SORTIE : blocs par fichier + commandes manage.py + 1 test pytest (liste non vide).

Découper le travail en étapes courtes et validables évite la dérive et facilite la relecture. On crée un rythme : plan ➜ étape N ➜ validation ➜ étape N+1.

🗺️ Protocole d’itération

1) Demander un plan 3–5 étapes.
2) Dire “OK étape 1” : livrer uniquement l’étape 1 (stop après).
3) Exécuter les contrôles/tests proposés.
4) Valider / demander une retouche.
5) Passer à l’étape suivante.

✂️ Gabarit “Étape N”

"Ok étape N. Donne uniquement <élément> (max 60 lignes).
Format bloc par fichier. Si dépassement ➜ STOP et propose un split logique."

🧪 Gate review (avant d’avancer)

• Build passe / migrations appliquées / tests OK ?
• Noms/chemins conformes, pas d’effets de bord ?
• Diff minimal (si modif) + doc courte / commentaires de tête ?

📌 Exemple “CRUD en 3 tranches”

Étape 1 : Modèle + admin + migration (+ test modèle simple)
Étape 2 : Vue ListView + URL + template minimal (+ test liste)
Étape 3 : Form (Create) + tests (OK/erreur/permission)

🛑 Stop conditions (le modèle doit s’arrêter)

• > 120 lignes cumulées
• Changement de périmètre imprévu
• Dépendance manquante détectée

“Bon vs mauvais” permet de voir immédiatement ce qu’on change pour rendre un prompt exploitable par un dev.

A) Scaffold Django (CRUD + admin)

Mauvais :
"Fais un blog Django."

Bon :
RÔLE : Architecte Django senior
OBJECTIF : Modèle Article(title, slug unique, body, published_at, is_published) + admin + ListView paginée + URL + template Bootstrap 5.
FICHIERS AUTORISÉS : blog/models.py, blog/admin.py, blog/views.py, blog/urls.py, templates/blog/article_list.html
CONTRAINTES : PEP8, chemins exacts, si >120 lignes ➜ STOP & question
SORTIE : blocs par fichier + commandes manage.py + 1 test pytest (liste non vide)

B) Bug avec stack trace

Mauvais :
"Ça plante, aide-moi."

Bon :
"Voici la stack trace (20 lignes) et views.py (l.10–60).
Explique la cause probable en 3 points, propose 1 patch minimal (diff unifié)
et 1 test pytest qui échoue avant / passe après. Bloc par fichier."

C) SQL → ORM + index

Mauvais :
"Convertis cette requête."

Bon :
"Convertis cette requête SQL en QuerySet Django. Donne l’index à ajouter
(champ + ordre) pour optimiser le WHERE et l’EXPLAIN attendu. Bloc par fichier."

D) Composant React (Next.js 14 + Tailwind)

Mauvais :
"Fais un formulaire React."

Bon :
"Crée un composant 'ContactForm' contrôlé (nom, email, message),
validation (email/longueur), props typées, Tailwind uniquement, exemple d’usage.
Fournis le code complet + snippet d’intégration. <= 120 lignes, sinon STOP."

E) Générer des tests à partir d’une spec

Mauvais :
"Fais des tests."

Bon :
"À partir de ce schéma OpenAPI (extrait), écris 3 tests pytest (succès/erreur/permission),
avec fixtures. Indique les commandes pour les exécuter. Bloc par fichier."

🧯 Anti-patterns courants ➜ corrections

“Fais tout” → Plan 3–5 étapes + OK étape 1 seulement
“Optimise” → Donne métrique/objectif et méthode de mesure
“Écris du code” → Format bloc par fichier + bornes + tests