Workflow de prototypage IA fr FR

Résumé : Ce guide décrit une "boucle en 4 étapes" pour le prototypage rapide dans StartER en utilisant des agents IA comme Cursor, Windsurf ou GitHub Copilot.

La boucle de co-création IA

Pour passer d'une idée à une fonctionnalité opérationnelle en quelques minutes, suivez cette boucle structurée. Elle fournit à l'IA les contraintes dont elle a besoin pour réussir.

Étape 1 : définir le contrat

Avant d'écrire toute logique, définissez le comportement de l'API dans le dossier tests/contracts/.

Pourquoi ? Cela fournit une source de vérité déclarative que l'IA peut analyser.
Action : ajoutez votre nouvelle ressource et ses scénarios (success, bad_request, etc.) à l'objet contracts.

Étape 2 : cloner le modèle

Utilisez la CLI pour créer la structure du module.

Pourquoi ? make:clone fournit à l'IA un modèle maître fonctionnel de votre style architectural spécifique.

Action :

npm run make:clone -- src/express/modules/item src/express/modules/task item task

Étape 3 : prompter l'agent

Guidez votre agent IA en utilisant le contexte du contrat et des fichiers clonés.

Pourquoi ? L'IA fonctionne mieux lorsqu'on lui donne un objectif clair et un exemple pertinent.
Exemple de prompt :

"J'ai ajouté un module task. En te basant sur les définitions de task dans le dossier tests/contracts/ et sur la logique de src/express/modules/item, implémente le taskRepository et les taskActions."

Étape 4 : vérifier et corriger

Lancez les tests automatisés pour détecter les hallucinations de l'IA.

Pourquoi ? L'IA manque souvent des cas limites (comme les 404 ou les erreurs de validation) définis dans votre contrat.
Action :
```
npm run test
```
Si ça échoue : redonnez l'erreur à l'IA : "Le test read a échoué avec une 404. Corrige la méthode find dans taskRepository."

Bonnes pratiques pour le prompting IA

Référencez les contrats : dites toujours à l'IA : "Respecte la structure définie dans les contrats."
Copiez le schéma : si vous modifiez la base de données, partagez src/database/schema.sql avec l'IA.
Un module à la fois : concentrez l'IA sur une seule ressource (module Express ou composant React) pour garder la fenêtre de contexte propre.