Documentation

Méthodes pour lancer les travaux

Les voies par lesquelles le travail entre dans Coroid, la manière dont les demandes sont qualifiées et les quatre résultats possibles qu'elles produisent.

Le travail arrive sur Coroid depuis les utilisateurs du portail, depuis Slack ou Telegram, depuis vos propres systèmes et assistants, ainsi que depuis l'automatisation de Coroid. La création d'une Tâche via le formulaire Nouveau travail dans le portail constitue l'un de ces chemins. Tous convergent vers le même parcours d'exécution — spécification, Plans, construction, vérification, revue, demande de fusion.

CheminUtiliser lorsque
Nouveau travailQuelqu'un souhaite quelque chose et est prêt à le décrire.
Importer des issuesLa demande existe déjà dans Jira, Linear, Trello ou GitHub Issues.
Interroger CoroidVous préférez la décrire de manière conversationnelle.
Slack ou TelegramQuelqu'un la demande dans un chat.
Intégration du travail APIUn autre système enregistre la demande, comme un formulaire de demande de fonctionnalité dans votre produit.
Automatisations d'événementsQuelque chose dans GitHub, Slack, Telegram ou Jira doit devenir du travail.
Coroid MCPUn assistant ou un agent comme Hermes, Codex ou Claude Code gère le travail.
CalendriersLe déclencheur est le temps.
HooksLe déclencheur est un événement de plateforme.
Rapports et constatationsUn rapport ou un contrôle qualité a identifié un problème à corriger.

Demandes

  • Nouveau travail

    Quelqu'un le décrit

  • Importer les problèmes

    Depuis un outil de suivi

  • Intégration via API

    Votre produit ou un agent

  • Automatisations d'événements

    Un pull request, un commentaire ou un message

Qualification

Le système filtre, dédoublonne et vérifie la demande, puis détermine le parcours à suivre. Rien n'est créé tant que la demande n'est pas validée.

Devenez

  • Tâche
  • Plan
  • Rapport
  • Planning

Choisissez-en un, ou laissez l'option Créer sur Automatique pour que la Qualification décide.

La Qualification n'évalue pas ces éléments. Ils génèrent du travail directement :Interroger Coroid · Lors d'une conversationCalendriers · Le tempsHooks · Un événement de plateformeRapports et résultats d'analyse · Un problème à corrigerCoroid MCP · Un agent externe

Tâches et plans : spécification, plan, construction, vérification, revue, pull request

Les demandes sont évaluées avant toute création, puis deviennent une tâche, un plan, un rapport ou un calendrier. Les tâches et les plans suivent le même chemin vers un pull request.

Vérifié, puis routé.

Une demande provenant de Nouveau travail ou d'une importation n'est pas créée immédiatement à son arrivée. Elle passe d'abord par la phase de qualification. Coroid la analyse pour détecter les valeurs sensibles, la compare à la version actuelle, recherche les doublons, vérifie ce qu'elle peut faire et détermine ce qu'elle doit devenir. Rien n'est créé tant qu'elle ne passe pas cette étape. Voir Décrire ce dont vous avez besoin.

Les demandes issues de l'intégration du travail API passent également par cette étape, tout comme les événements qu'une automatisation d'événements envoie à la qualification.

Ce qu'elle devient correspond à l'un de quatre chemins :

CheminProduit
TâcheUne seule Tâche, aboutissant à une seule pull request
PlansUn plan échelonné que vous approuvez avant la rédaction du code
RapportUn rapport généré
AutomatisationDu travail exécuté selon un calendrier ou en réponse à un événement

Dans le formulaire Nouveau travail, vous pouvez choisir vous-même le parcours ou le laisser sur Automatique et laisser Qualification faire le choix. Lorsque vous en sélectionnez un et que Qualification recommande un autre, vous verrez cette recommandation et prendrez une décision.

Le fonctionnement d'Ask Coroid est différent. En mode Assistant, l'assistant de chat crée directement des tâches et des plans, sans passer par Qualification. Un chat Prepare Work, le workflow SDLC guidé, envoie sa spécification approuvée à Qualification avant le début de la planification. Voir Assistant de chat.

Les autres parcours créent du travail directement, sans passer par Qualification, et leurs paramètres propres déterminent ce qui peut être lancé. Pour le serveur MCP, il s'agit de ses approbations et de ses politiques d'automatisation.

Lorsque le travail commence

Personne n'attend dans le portail une demande provenant de l'outil d'entrée de travail API ou d'une automatisation d'événement. Coroid crée son travail quelques minutes après que Qualification l'ait approuvé. Le fait qu'une tâche soit également lancée automatiquement dépend de la source de la demande :

SourceSe lance automatiquement
Un compte de service configuré pour lancer automatiquement le travail qualifiéOui
Un GitHub pull request ou un ticket dont l'auteur dispose des droits d'écriture sur le dépôtOui
Un commentaire GitHub mentionnant Coroid, valable uniquement pour les auteursOui
Tout autre compte de serviceNon
Slack, Telegram, Jira et toute autre sourceNon

Une tâche qui ne se lance pas automatiquement attend qu'une personne la lance. Qualification affiche la demande comme étant en attente de lancement, avec un lien vers la tâche. Les plans ne se lancent jamais automatiquement : ils attendent l'approbation, comme toujours. Un planning attend en phase de révision que quelqu'un décide de son exécution.

Coroid attribue le travail au premier membre actif de cette liste : la personne qui a soumis la demande ou configuré l'automatisation, le créateur du compte de service, le créateur du projet et un propriétaire de l'organisation.

Une demande ne mentionnant aucun projet est dirigée vers le seul projet de l'organisation. S'il y en a plusieurs, la demande attend l'examen dans Qualification, et le réviseur choisit le projet lors de son acceptation.

Tâche ou plan ?

Le critère utile est la possibilité de révision. Si le travail terminé correspond à un pull request qu'un collègue peut lire en une séance, c'est une tâche. S'il nécessite plusieurs modifications dans un ordre défini, ou si vous souhaitez approuver l'approche avant toute construction, c'est un plan.

En cas de doute, privilégiez un plan pour tout élément substantiel. Un plan vous offre un point de contrôle d'approbation avant même l'existence du code, ce qui constitue le moment le moins coûteux pour changer d'avis. Une tâche qui s'avère trop volumineuse risque simplement de dépasser les limites prévues.

Travail importé

Les problèmes importés depuis un outil de suivi passent par le même processus de qualification. Les doublons, les problèmes déjà résolus et les demandes non vérifiables sont écartés à ce stade, tandis que les autres deviennent des tâches ou des plans. Un carnet de projets n'est qu'une liste de souhaits ; ce filtre est donc encore plus important pour les imports que partout ailleurs. Voir Importer du travail.

Depuis vos propres systèmes

Un autre système peut déposer des demandes via l'interface d'entrée de travail API : un formulaire de demande de fonctionnalité intégré à votre produit, par exemple, ou un outil de support qui transmet les requêtes des clients.

L'interface d'entrée de travail API nécessite un compte de service, inclus dans les offres Professionnel et Entreprise. Créez-en un sous Paramètres → Comptes de service. La clé API doit avoir ce périmètre d'accès : intake:write. La clé n'est affichée qu'une seule fois lors de sa création ; désactiver le compte de service invalide toutes ses clés.

Envoyez chaque demande au portail API, en utilisant la clé comme jeton porteur :

curl -X POST https://api.coroid.ai/api/v1/organizations/work/intake \
  -H "Authorization: Bearer ak_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Export invoices as CSV", "content": "Customers want to download their invoices as CSV from the billing page."}'
ChampObligatoireDescription
titleOuiUn nom court, jusqu'à 500 caractères
contentOuiLe contenu de la demande, jusqu'à 20 000 caractères
projectIdNonLe projet auquel le travail appartient
workTypeNontask, plan, report ou schedule
signalNonL'erreur, l'alerte ou le problème à l'origine de la demande, décrit ci-dessous

En l'absence de type de travail, la qualification détermine le parcours à suivre. La qualification s'applique à chaque demande API et ne peut être ignorée.

Si la demande provient de la surveillance ou d'une autre source automatisée, décrivez son signal. Coroid l'utilise pour détecter les doublons d'incidents dans tout projet et pour rédiger le contrat de résultat.

signal champObligatoireDescription
fingerprintOuiUne identité stable pour l'incident, comme l'identifiant du problème dans votre outil de suivi d'erreurs
sourceNonLa source du signal, par exemple glitchtip ou sentry
routesNonLes itinéraires affectés par l'incident, jusqu'à 50 au maximum
minExposureNonCombien de demandes sur ces itinéraires doivent être traitées avant que le résultat ne soit évalué ?
urlNonUn lien vers l'incident

Avec routes et minExposure, le contrat est mesurable : l'incident doit rester silencieux. Sans eux, le contrat indique qu'il ne peut pas être mesuré. A mandat peut refuser de démarrer un travail non mesurable.

Une tâche qualifiée provenant d'un compte de service attend qu'une personne la lance. Un propriétaire ou un administrateur peut modifier cette configuration pour le compte dans la section Comptes de service : Démarrer automatiquement le travail qualifié. N'activez-le que lorsque tout ce que le compte soumet provient de personnes de confiance. Voir Quand le travail commence.

Les événements dans GitHub, Slack, Telegram et Jira peuvent également générer des demandes, sans qu'il soit nécessaire de les saisir à nouveau. Une automatisation d'événements les envoie à la phase de qualification. Voir Déclencheurs et destinations.

Depuis vos assistants

Un assistant ou un agent que vous utilisez, comme Hermes, Codex ou Claude Code, peut collaborer avec Coroid via son serveur MCP. Il peut consulter vos projets et vos travaux, puis créer, exécuter et livrer des tâches dans les limites que vous lui accordez. Les tâches qu'il crée ne passent pas par la phase de qualification. Voir Coroid en tant que serveur MCP.

Saisie automatisée

Les calendriers et les déclencheurs ouvrent des travaux sans intervention humaine, la différence résidant uniquement dans le déclencheur : le temps ou un événement spécifique. Tous deux sont des automatisations, répertoriées dans l'usine logicielle et créées dans Nouveau travail.

Les contrôles de qualité entraînent également des tâches de correction. Lorsqu'une politique de qualité analyse un rapport et détecte des problèmes dans le produit, Coroid ouvre une tâche de remédiation pour les résoudre. Usine → Révision liste les échecs de test qui ne sont rattachés à aucune tâche. Corriger transforme l'un d'eux en tâche de correction.

Toutes ces opérations consomment des emplacements d'agents et des ressources de modélisation réelles. Accordez aux travaux automatisés une priorité inférieure à celle des travaux en attente de traitement – voir Capacité et emplacements d'agents.

Dans cette section