Session de QA
Lancez une session de QA interactive. L'utilisateur décrit les problèmes qu'il rencontre. Vous clarifiez, explorez la base de code pour le contexte, et créez des tickets GitHub durables, centrés sur l'utilisateur, et utilisant le langage du domaine du projet.
Pour chaque problème soulevé par l'utilisateur
1. Écouter et clarifier légèrement
Laissez l'utilisateur décrire le problème avec ses propres mots. Posez au maximum 2-3 questions de clarification courtes axées sur :
- Ce qu'il attendait vs ce qui s'est réellement passé
- Les étapes de reproduction (si ce n'est pas évident)
- Si le problème est constant ou intermittent
Ne faites PAS de sur-interview. Si la description est assez claire pour créer un ticket, passez à la suite.
2. Explorer la base de code en arrière-plan
Pendant que vous discutez avec l'utilisateur, lancez un Agent (subagent_type=Explore) en arrière-plan pour comprendre la zone concernée. Le but n'est PAS de trouver une correction — c'est de :
- Apprendre le langage du domaine utilisé dans cette zone (vérifiez UBIQUITOUS_LANGUAGE.md)
- Comprendre ce que la fonctionnalité est censée faire
- Identifier la frontière de comportement visible par l'utilisateur
Ce contexte vous aide à rédiger un meilleur ticket — mais le ticket lui-même ne doit PAS référencer des fichiers, des numéros de ligne ou des détails d'implémentation internes.
3. Évaluer la portée : ticket unique ou découpage ?
Avant de créer le ticket, décidez s'il s'agit d'un ticket unique ou s'il doit être découpé en plusieurs tickets.
Découpez quand :
- La correction couvre plusieurs zones indépendantes (ex. « la validation du formulaire est erronée ET le message de succès est absent ET la redirection est cassée »)
- Il y a clairement des préoccupations séparables que différentes personnes pourraient traiter en parallèle
- L'utilisateur décrit quelque chose qui présente plusieurs modes de défaillance ou symptômes distincts
Gardez comme un seul ticket quand :
- C'est un comportement qui est erroné à un seul endroit
- Les symptômes sont tous causés par le même comportement racine
4. Créer le(s) ticket(s) GitHub
Créez les tickets avec gh issue create. Ne demandez PAS à l'utilisateur de relire d'abord — créez juste et partagez les URLs.
Les tickets doivent être durables — ils doivent encore avoir du sens après des refontes majeures. Rédigez du point de vue de l'utilisateur.
Pour un ticket unique
Utilisez ce modèle :
## Ce qui s'est passé
[Décrivez le comportement réel que l'utilisateur a rencontré, en langage simple]
## Ce que j'attendais
[Décrivez le comportement attendu]
## Étapes de reproduction
1. [Étapes concrètes et numérotées qu'un développeur peut suivre]
2. [Utilisez les termes du domaine de la base de code, pas les noms de modules internes]
3. [Incluez les entrées, indicateurs ou configurations pertinents]
## Contexte supplémentaire
[Toute observation supplémentaire de l'utilisateur ou de l'exploration de la base de code qui aide à cadrer le problème — ex. « cela ne se produit qu'avec la couche Docker, pas avec la couche système de fichiers » — utilisez le langage du domaine mais ne citez pas de fichiers]
Pour un découpage (plusieurs tickets)
Créez les tickets dans l'ordre des dépendances (les bloqueurs d'abord) afin de pouvoir référencer les vrais numéros de tickets.
Utilisez ce modèle pour chaque sous-ticket :
## Ticket parent
#<numéro-du-ticket-parent> (si vous avez créé un ticket de suivi) ou « Signalé lors d'une session de QA »
## Ce qui ne va pas
[Décrivez ce problème de comportement spécifique — juste cette partie, pas le rapport complet]
## Ce que j'attendais
[Comportement attendu pour cette partie spécifique]
## Étapes de reproduction
1. [Étapes spécifiques à CE ticket]
## Bloqué par
- #<numéro-de-ticket> (si ce ticket ne peut pas être corrigé tant qu'un autre n'est pas résolu)
Ou « Aucun — peut commencer immédiatement » s'il n'y a pas de bloqueurs.
## Contexte supplémentaire
[Toute observation supplémentaire pertinente pour cette partie]
Lors de la création d'un découpage :
- Préférez de nombreux tickets fins plutôt que quelques tickets épais — chacun doit pouvoir être corrigé et vérifié indépendamment
- Indiquez honnêtement les relations de blocage — si le ticket B ne peut vraiment pas être testé tant que le ticket A n'est pas corrigé, dites-le. S'ils sont indépendants, marquez les deux comme « Aucun — peut commencer immédiatement »
- Créez les tickets dans l'ordre des dépendances afin de pouvoir référencer les vrais numéros de tickets dans « Bloqué par »
- Maximisez le parallélisme — le but est que plusieurs personnes (ou agents) puissent prendre différents tickets simultanément
Règles pour tous les corps de ticket
- Pas de chemins de fichiers ni de numéros de ligne — ceux-ci deviennent obsolètes
- Utilisez le langage du domaine du projet (vérifiez UBIQUITOUS_LANGUAGE.md s'il existe)
- Décrivez les comportements, pas le code — « le service de synchronisation échoue à appliquer le correctif » pas « applyPatch() lève une exception à la ligne 42 »
- Les étapes de reproduction sont obligatoires — si vous ne pouvez pas les déterminer, demandez à l'utilisateur
- Soyez concis — un développeur doit pouvoir lire le ticket en 30 secondes
Après avoir créé le(s) ticket(s), affichez toutes les URLs des tickets (avec un résumé des relations de blocage) et demandez : « Prochain problème, ou avons-nous terminé ? »
5. Continuer la session
Continuez jusqu'à ce que l'utilisateur dise qu'il a terminé. Chaque problème est indépendant — ne les regroupez pas.