De l'issue à la PR brouillon
Sur le dépôt atelier-exemple/site-vitrine, l'image Docker ne démarre plus. Une issue est ouverte. Ce scénario suit son traitement jusqu'à la PR brouillon relue par l'équipe du dépôt.
Objectif#
Obtenir une PR brouillon qui propose un correctif, relue par un humain, et connaître ce qu'elle a coûté.
Rôles nécessaires#
| Personne | Rôle | Intervient pour |
|---|---|---|
| Morgan | Responsable du projet | Politique du dépôt |
| Camille | Administrateur | Notification avant publication |
| Dominique | Opérateur | Suivi, réponse aux questions |
responsable-demo | responsable GitHub du dépôt | Notification, revue de la PR |
Prérequis#
- L'équipe est en place : voir Embarquer une équipe sur un projet.
- L'exploitant a activé les exécutions, les notifications et la publication :
MVP_AGENT_MODE=live,MVP_PUBLICATION_NOTICES_ENABLED=true,MVP_GITHUB_PUBLICATION_ENABLED=true, avec les permissions GitHub correspondantes. Voir GitHub App et interrupteurs. - Dans Paramètres de maintenance, Morgan a coché Surveiller les nouvelles issues et Autoriser la proposition de correctifs.
- Le canal de Notification avant publication est enregistré par Camille.
Étapes#
L'issue s'ouvre. Sur GitHub, une personne ouvre l'issue n° 42 « L'image ne démarre pas », en précisant que le conteneur s'arrête dès son lancement.
L'exécution démarre. Le dépôt étant surveillé, une exécution est mise en file. Dominique ouvre Issues et exécutions dans la barre Espace projet : l'issue n° 42 apparaît, son exécution passe de En file à En cours. La File de travail la montre aussi.
Les agents travaillent. Dans l'onglet Agents et besoin, Dominique suit les étapes : Exploration, Analyse, Conception, Développement, Revue. L'Exploration donne la priorité au
Dockerfileet aux fichiers Compose, puisque l'issue les évoque. Voir Les cinq agents.Une question est posée. L'agent Analyse hésite sur le port attendu. L'exécution passe à Précisions requises, et la carte Questions du rôle Analyse affiche la question.
Dominique répond. Dans Actions sur l'exécution, il saisit dans Votre réponse : « Le conteneur doit écouter sur le port 8080. » Il clique sur Envoyer la précision. Une tentative Précision démarre et réutilise les étapes déjà validées.
Variante : si une PR brouillon d'analyse existe déjà (brouillon précoce autorisé), la question peut être publiée en commentaire sur la PR. Le responsable GitHub répond alors sur GitHub :
/answer Le conteneur doit écouter sur le port 8080.Voir Répondre aux questions.
Le correctif est prêt. La tentative se termine Correctif prêt. La carte Proposition rappelle Tests du dépôt non exécutés. Dominique relit les changements dans l'onglet Diff. Voir Lire le diff.
La notification part. Avant toute écriture sur GitHub, la notification Proposition est envoyée au destinataire configuré. Dans l'onglet Suivi, carte Notifications, elle passe à Acceptée. Personne n'a à cliquer pour approuver. Voir Notification avant publication (effet).
La PR brouillon s'ouvre. La plateforme crée la branche
agents/mvp-<identifiant de l'exécution>, y pousse le correctif, ouvre la PR brouillon et demande la revue àresponsable-demo. La carte Pull request affiche Publié.La revue humaine.
responsable-demorelit la PR sur GitHub. La CI du dépôt s'exécute sur GitHub et son résultat apparaît dans Suivi, ligne CI GitHub. La décision de fusionner appartient à l'équipe du dépôt : 101Maintain ne fusionne jamais. Voir PR brouillon et suivi.Le coût. Morgan ouvre Consommation dans la barre Espace projet. Il retrouve les jetons et le coût de l'exécution et de sa tentative Précision. Les étapes réutilisées n'ont rien coûté. Voir Page Consommation et export CSV.
Le rapport (facultatif). Pour le client, Dominique génère le rapport d'incident depuis la carte Rapport PDF client de l'exécution, avec Générer une édition PDF, puis Télécharger. Voir Rapports PDF.
Résultat attendu#
- Une PR brouillon ouverte sur
atelier-exemple/site-vitrine, avec le correctif et une demande de revue àresponsable-demo. - Dans l'onglet Suivi : notification Acceptée, PR Publié, état de la branche et de la CI.
- Dans Consommation : le coût connu de l'exécution, ou un usage inconnu signalé comme tel, jamais converti en zéro.
- Dans le journal des actions, filtré sur Pull request n° avec le projet : toute la chaîne de l'exécution et de sa reprise.
Si ça bloque#
| Symptôme | Voir |
|---|---|
| L'issue n'apparaît pas | Réception des issues GitHub |
| Exécution En file qui ne démarre pas | Interrupteur MVP_AGENT_MODE, arrêt global, page Exploitation |
| Pas de PR malgré Correctif prêt | Notification non acceptée ou interrupteur de publication : Notification avant publication (effet) |
| PR Bloqué ou Indéterminé | États et erreurs |
| Budget atteint | Budgets et plafonds |
Pour continuer#
Contrôlez la qualité d'un dépôt avant une livraison : Audit avant livraison client.