Documentation

Hooks

Des Automatisations au niveau de l'organisation qui réagissent aux événements de la plateforme avec des instructions que vous rédigez.

Une automatisation réagit à un événement survenant dans Coroid. Vous choisissez un événement, rédigez des instructions en langage courant, et l'automatisation s'exécute dès que l'événement se produit.

Vous les trouverez sous Paramètres → Automatisation → Automatisations.

Événements auxquels vous pouvez réagir

CatégorieExemples
TâcheCréée, statut modifié, phase changée, terminée, échouée
AgentDémarrage, itération, appel d'outil, achèvement, erreur
DépôtValidation de commit, création de branche, pull request ouverte, pull request fusionnée
AnalyseDépendance détectée, problème de sécurité, analyse terminée
SynchronisationMise à jour de la source externe
DéploiementDémarrage, achèvement, échec

En lecture seule par défaut

Les automatisations analysent et génèrent des rapports. Elles peuvent créer des tâches de suivi ; elles ne modifient pas directement votre code.

Cette configuration par défaut garantit leur adoption sans risque. Une automatisation qui modifie le code en réponse à un événement agit au moment où la supervision est le moins probable. Une automatisation qui ouvre une tâche produit le même résultat par la voie normale — spécification, planification, vérification, revue, pull request.

Rédiger de bonnes instructions

Les instructions d'automatisation sont traitées par un modèle ; elles ressemblent donc à des directives adressées à un collègue plutôt qu'à du code. Le niveau d'exigence est identique à celui d'une spécification: indiquez ce à quoi prêter attention, ce qui importe, et ce à faire.

Soyez précis concernant le cas « ne rien faire ». Sans cela, une automatisation trouvera toujours quelque chose à dire à chaque exécution, et les automatisations qui se déclenchent constamment cessent d'être lues.

Limites de sécurité

Trois protections existent car l'automatisation pilotée par événements échoue de manière prévisible :

Limites de fréquence. Par minute, par heure et par jour, configurables pour chaque automatisation. Une automatisation liée à un événement à haute fréquence pourrait autrement se déclencher des centaines de fois lors d'une fusion chargée.

Profondeur de chaîne. Les automatisations peuvent déclencher des événements qui déclenchent d'autres automatisations. Une profondeur maximale de chaîne empêche la formation de boucles.

Permissions des outils. Ce qu'une automatisation peut accéder est contrôlé : l'accès en lecture seule, les appels MCP et la création de tâches sont régis séparément.

Permissions

La gestion des automatisations est réservée aux administrateurs ; tous les membres peuvent consulter les automatisations et leur historique d'exécution. Étant donné que les automatisations ont une portée au niveau de l'organisation, cette asymétrie est volontaire.

Les surveiller

Chaque automatisation conserve un journal d'acheminement et des analyses. Consultez le journal après avoir activé une nouvelle automatisation : le mode de défaillance n'est pas une erreur, mais un déclenchement constant sans action concrète.

Automatisations, plannings et Sentinel

MécanismeDéclenché par
AutomatisationUn événement de la plateforme
PlanningHeure
SentinelUne condition observée