Exécuter votre première tâche

Une tâche constitue une unité de travail qui aboutit à un seul pull request. Démarrez-en une depuis Nouveau travail, et sélectionnez Tâche sous Créer en tant que. Laisser cette option sur Automatique permet à Coroid de choisir entre une tâche et un plan.

Sélectionnez une bonne première tâche#

La meilleure première tâche est petite, concrète et proche des tests existants. Quelque chose comme « ajouter un --json En ajoutant l'option « flag » à la commande d'exportation, en respectant la structure de sortie déjà prise en charge par la commande d'importation, vous fournissez à Coroid une cible claire et obtenez ainsi une lecture précise du résultat.

À éviter lors d'une première exécution :

• Tout ce qui concerne l'authentification, les paiements ou la migration de données.
• Les tâches nécessitant une décision de conception que vous n'avez pas encore prise.
• Les nettoyages vagues : « améliorer la gestion des erreurs » n'a pas de fin définie.

Décrivez ce que vous souhaitez.#

Rédigez le résultat attendu, pas l'implémentation. Indiquez ce qui doit être vrai une fois le travail terminé, et mentionnez tout élément non évident : les fichiers importants, les conventions à suivre, les éléments à ne pas modifier.

Vous n'avez pas besoin de rédiger le plan. C'est la première chose que produit Coroid, et vous pouvez l'approuver.

Si certains éléments ne sont pas présents dans le code — un ADR, un guide de style, un ticket — joignez-les. Consultez Contexte du projet pour découvrir ce que Coroid connaît déjà sans qu'on le lui indique.

Continuer vers la phase de qualification#

Choisir Continuer. Rien n’a encore été créé : Coroid analyse la demande, la compare à la version en cours, recherche les doublons et confirme le parcours à suivre. Si tout est conforme, la tâche est créée et rejoint la file d'attente. Si la phase de qualification l'arrête, les résultats indiquent la raison ; vous pouvez alors modifier la demande et réessayer. Voir Décrire vos besoins.

Consulter les spécifications#

Coroid transforme votre description en spécification: ce qui sera développé, ce qui est hors périmètre et les critères d'acceptation déterminant la réussite. Ces éléments apparaissent dans l'onglet Spécifications de la tâche.

Lisez-les avant toute construction. Si les critères d'acceptation ne correspondent pas à vos attentes, corrigez-les dès maintenant — ils serviront de base aux tests lors de la phase de vérification. Voir Spécifications.

Approuver le plan#

Pour toute modification non triviale, la spécification devient un plan: un ensemble ordonné d'étapes. Vous l'approuvez avant la rédaction du code.

C'est le moment le plus économique pour intervenir. Rejeter un plan ne vous coûte qu'une minute. Rejeter un pull request déjà terminé entraîne l'échec de toute l'exécution.

Suivre son exécution#

Une fois créée, la tâche entre dans PENDING jusqu'à ce qu'une place d'agent se libère, puis IN_PROGRESS. Vous pouvez suivre l'exécution en temps réel : les étapes effectuées, les outils utilisés, les fichiers modifiés et les résultats des tests au fur et à mesure de leur accumulation.

Vous n'êtes pas obligé de surveiller. Les Notifications vous informeront quand votre intervention sera nécessaire ou quand l'exécution sera terminée.

Ce à quoi vous pouvez vous attendre#

• Durée dépend de la taille de la modification et du temps nécessaire à votre suite de tests, et non du nombre de places d'agent dont vous disposez. Les places d'agent déterminent le nombre de tâches exécutées simultanément.
• NEEDS_HUMAN_REVIEW n'est pas une erreur. Cela signifie que Coroid a atteint une étape nécessitant une décision de votre part. Répondez-y et la tâche poursuivra son exécution.
• Le retravail est normal. Si le réviseur trouve un problème, la tâche retourne au développeur avant même que vous ne la voyiez.

Suivant#

Réviser et fusionner le résultat — ce qui arrive et ce à quoi il faut prêter attention.