101 lines
2.5 KiB
Markdown
101 lines
2.5 KiB
Markdown
|
# Playbook d'usage des agents IA (Yavsc)
|
||
|
|
|
||
|
|
Ce playbook normalise l'usage de Copilot, Plan et Explore dans le depot.
|
||
|
|
Il privilegie des sorties verifiables: fichiers, commandes tests, risques.
|
||
|
|
|
||
|
|
## Quand utiliser quel agent
|
||
|
|
|
||
|
|
- Plan: quand la tache est ambigue, transverse ou risquee.
|
||
|
|
- Explore: quand il faut cartographier rapidement des zones du code.
|
||
|
|
- Copilot: quand les specifications sont claires et localisees.
|
||
|
|
|
||
|
|
## Prompt type (base)
|
||
|
|
|
||
|
|
Utiliser ce squelette avant toute tache non triviale:
|
||
|
|
|
||
|
|
```text
|
||
|
|
Contexte: <projet/fichier/fonction>
|
||
|
|
Objectif: <resultat observable>
|
||
|
|
Contraintes: <style, archi, perimetre>
|
||
|
|
Verification: <tests exacts a lancer>
|
||
|
|
Sortie attendue: <fichiers modifies + risques>
|
||
|
|
```
|
||
|
|
|
||
|
|
## 4 scenarios de reference
|
||
|
|
|
||
|
|
## 1) Explorer un bounded context
|
||
|
|
|
||
|
|
Intention:
|
||
|
|
- Comprendre ou implementer un changement dans un BC sans regression laterale.
|
||
|
|
|
||
|
|
Prompt minimal:
|
||
|
|
```text
|
||
|
|
Explore le BC <nom> avec profondeur medium.
|
||
|
|
Retour: composants touches, points d'entree, tests existants et risques.
|
||
|
|
```
|
||
|
|
|
||
|
|
Preuves attendues:
|
||
|
|
- Carte des fichiers a modifier.
|
||
|
|
- Test(s) smoke/mandatory proposes.
|
||
|
|
|
||
|
|
## 2) Ajouter un smoke test
|
||
|
|
|
||
|
|
Intention:
|
||
|
|
- Couvrir rapidement un endpoint ou une route publique.
|
||
|
|
|
||
|
|
Prompt minimal:
|
||
|
|
```text
|
||
|
|
Propose un smoke test pour <route/endpoint> dans le projet de test approprie.
|
||
|
|
Respecte les conventions de doc/testing.md.
|
||
|
|
```
|
||
|
|
|
||
|
|
Preuves attendues:
|
||
|
|
- Fichier test cree/modifie.
|
||
|
|
- Commande precise pour executer le test cible.
|
||
|
|
|
||
|
|
## 3) Corriger une regression backend API
|
||
|
|
|
||
|
|
Intention:
|
||
|
|
- Corriger un bug sans casser un flux voisin.
|
||
|
|
|
||
|
|
Prompt minimal:
|
||
|
|
```text
|
||
|
|
Planifie puis implemente un fix de <symptome> dans <projet>.
|
||
|
|
Ajoute/ajuste un test NonRegression rouge puis vert.
|
||
|
|
```
|
||
|
|
|
||
|
|
Preuves attendues:
|
||
|
|
- Explication cause racine.
|
||
|
|
- Test non-regression associe.
|
||
|
|
- Commande d'execution et resultat attendu.
|
||
|
|
|
||
|
|
## 4) Tracer un flux PostIt/OIDC
|
||
|
|
|
||
|
|
Intention:
|
||
|
|
- Localiser une cassure d'authentification entre client et serveur.
|
||
|
|
|
||
|
|
Prompt minimal:
|
||
|
|
```text
|
||
|
|
Cartographie le flux OIDC PostIt: entrypoints, callback, stockage token,
|
||
|
|
refresh. Donne points de rupture probables et tests/verification proposes.
|
||
|
|
```
|
||
|
|
|
||
|
|
Preuves attendues:
|
||
|
|
- Liste ordonnee des etapes du flux.
|
||
|
|
- Fichiers critiques.
|
||
|
|
- Hypotheses testables.
|
||
|
|
|
||
|
|
## Anti-patterns a eviter
|
||
|
|
|
||
|
|
- Prompt sans objectif verifiable.
|
||
|
|
- Demande trop large sans perimetre de fichiers.
|
||
|
|
- Validation basee uniquement sur "ca semble correct".
|
||
|
|
- Pas de lien entre changement et niveau de test.
|
||
|
|
|
||
|
|
## Gate PR minimale (agent-assiste)
|
||
|
|
|
||
|
|
Avant validation:
|
||
|
|
- Impact architecture explicite.
|
||
|
|
- Rationale de choix agent explicite.
|
||
|
|
- Test(s) executes et justifies.
|
||
|
|
- Risques residuels documentes.
|