C'est la page à laquelle le reste de la documentation renvoie. Elle nomme chaque étape d'exécution afin que les autres articles puissent préciser où se déroule une action.
Le chemin
- 1
SpécificationCe qui sera construit et comment vous saurez que cela fonctionne.
ArchitecteVous pouvez modifier - 2Planification
Étapes ordonnées, révisées avant toute écriture de code.
ArchitecteVous approuvez - 3
ConstructionCode et tests écrits dans un espace de travail isolé.
Développeur - 4
VérificationVotre suite de tests, ainsi que les vérifications et portes de qualité.
Responsable QA - 5
ExamenUne passe de révision automatisée sur le diff.
Réviseur - 6Demande de fusion
Sur une branche de votre dépôt, en attente de votre validation.
Vous fusionnez
Les échecs de vérification et les observations de révision corrigibles reviennent au développeur sous forme de retravail, avant toute ouverture de pull request.
Ces étapes sont identiques dans les deux modes d'exécution d'une tâche. En mode standard, la plateforme déplace la tâche d'une étape à l'autre. En mode Coordinateur, l'agent de planification reste en charge de la tâche en tant que coordinateur, attribue chaque étape à l'agent approprié et décide des actions à entreprendre après chaque résultat, y compris en renvoyant du travail. Dans les deux cas, une étape est clôturée par ses propres vérifications. Consultez Rôles des agents pour découvrir les différences entre ces deux modes.
Spécification
Coroid ne part pas de votre phrase. Il transforme d'abord votre description en spécification: ce qui sera construit, ce qui est explicitement hors périmètre et les critères d'acceptation qui déterminent si le travail est réussi.
Cela est essentiel car les critères d'acceptation servent de référence aux tests de la phase de vérification ultérieure. Une spécification vague produit un résultat difficile à évaluer.
Vous pouvez consulter et modifier la spécification dans l'onglet Spécification avant le début de l'exécution.
Le guide de développement piloté par la spécification explique comment rédiger des critères vérifiables, définir les limites du périmètre et conserver la même définition de succès tout au long de la planification, de l'implémentation et de l'examen.
Planifier
Pour toute modification plus complexe qu'une simple correction, la spécification devient un plan: un ensemble ordonné d'étapes regroupées en phases. Vous approuvez le plan avant que le code ne soit écrit.
Rejeter un plan est peu coûteux et constitue la bonne décision lorsque l'approche choisie est incorrecte. Rejeter après l'écriture du code est coûteux. C'est à ce stade que votre jugement a le plus d'influence.
Construire
Un agent clone le dépôt dans un espace de travail isolé et travaille dedans. Il lit le code, applique la modification et écrit ou met à jour les tests.
L'espace de travail est temporaire et propre à chaque tâche. Aucune action de l'agent n'affecte votre branche par défaut, et deux tâches exécutées simultanément ne peuvent pas accéder au travail en cours l'une de l'autre.
Vérifier
Votre propre suite de tests s'exécute en premier — c'est le signal le plus fiable disponible, car elle reflète ce que votre équipe a déjà jugé important.
En complément, les portes de qualité appliquent les règles configurées par votre organisation : seuils de couverture, lintering, tests navigateur sur une prévisualisation de déploiement et les Sécurité protections. Une porte bloquante arrête la tâche ; une porte consultative enregistre une constatation et permet de continuer.
Révision
Un agent examinateur lit la différence de code comme le ferait un collègue et produit des constatations. Les constatations pouvant être corrigées sont renvoyées pour retravail ; les autres sont attachées à pull request afin que vous puissiez les voir.
C'est pourquoi un Coroid pull request arrive déjà examiné — non pour remplacer votre examen, mais pour que celui-ci ne soit pas le premier.
Demande de fusion
La branche est envoyée et un pull request est ouvert sur votre branche de base, contenant la modification, les tests, les résultats de vérification et les constatations d'examen. Si le code répond déjà aux exigences de la tâche, il n'y a rien à envoyer : la QA vérifie alors le code inchangé et la tâche se termine sans pull request.
L'automatisation des tâches de Coroid s'arrête ici. La fusion relève de votre responsabilité.
Après la fusion
Ouvrez Versions pour préparer exactement la validation que vous souhaitez livrer. Une version peut inclure plusieurs demandes de fusion fusionnées, une validation directe ou du travail fusionné en dehors de Coroid. La porte de version et les approbations concernent cette validation et un environnement spécifique. Votre pipeline la déploie ; Coroid enregistre un succès observé ou une attestation explicite avant de l'afficher comme livrée. Une tâche marquée COMPLETED ou une demande de fusion pull request seule ne prouvent pas le déploiement.
Statuts des tâches
Le statut d'une tâche indique où elle se situe dans le processus décrit ci-dessus :
| État | Signification |
|---|---|
PENDING | Acceptée, en attente d'un créneau d'agent disponible |
IN_PROGRESS | En cours de traitement actif |
PENDING_REVIEW | Le travail est terminé et examiné, en attente d'intégration ou d'approbation |
COMPLETED | Le travail de la tâche est terminé ; le déploiement est suivi séparément |
NEEDS_HUMAN_REVIEW | Coroid ne peut pas avancer seul et vous pose une question |
PAUSED | Arrêté temporairement, reprise possible |
FAILED | L'exécution n'a pas pu s'achever |
CANCELLED | Arrêté par vous |
WONT_FIX | Clôturé volontairement sans effectuer le travail |
Ce qui détermine le débit
Un créneau d'agent Exécute une tâche à la fois. Les slots déterminent le volume de travail traité en parallèle ; ils n'accélèrent pas l'exécution d'une tâche individuelle. La durée d'une tâche dépend de la taille des modifications apportées et du temps nécessaire à l'exécution de votre suite de tests.
Suivant
Rôles des agents — indique quel agent prend en charge chaque étape du processus de travail. Ensuite, consultez Versions pour suivre le parcours post-fusion dans vos environnements.