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.
| Chemin | Utiliser lorsque |
|---|---|
| Nouveau travail | Quelqu'un souhaite quelque chose et est prêt à le décrire. |
| Importer des issues | La demande existe déjà dans Jira, Linear, Trello ou GitHub Issues. |
| Interroger Coroid | Vous préférez la décrire de manière conversationnelle. |
| Slack ou Telegram | Quelqu'un la demande dans un chat. |
| Intégration du travail API | Un autre système enregistre la demande, comme un formulaire de demande de fonctionnalité dans votre produit. |
| Automatisations d'événements | Quelque chose dans GitHub, Slack, Telegram ou Jira doit devenir du travail. |
| Coroid MCP | Un assistant ou un agent comme Hermes, Codex ou Claude Code gère le travail. |
| Calendriers | Le déclencheur est le temps. |
| Hooks | Le déclencheur est un événement de plateforme. |
| Rapports et constatations | Un 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.
Tâches et plans : spécification, plan, construction, vérification, revue, 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 :
| Chemin | Produit |
|---|---|
| Tâche | Une seule Tâche, aboutissant à une seule pull request |
| Plans | Un plan échelonné que vous approuvez avant la rédaction du code |
| Rapport | Un rapport généré |
| Automatisation | Du 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 :
| Source | Se 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ôt | Oui |
| Un commentaire GitHub mentionnant Coroid, valable uniquement pour les auteurs | Oui |
| Tout autre compte de service | Non |
| Slack, Telegram, Jira et toute autre source | Non |
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."}'| Champ | Obligatoire | Description |
|---|---|---|
title | Oui | Un nom court, jusqu'à 500 caractères |
content | Oui | Le contenu de la demande, jusqu'à 20 000 caractères |
projectId | Non | Le projet auquel le travail appartient |
workType | Non | task, plan, report ou schedule |
signal | Non | L'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 champ | Obligatoire | Description |
|---|---|---|
fingerprint | Oui | Une identité stable pour l'incident, comme l'identifiant du problème dans votre outil de suivi d'erreurs |
source | Non | La source du signal, par exemple glitchtip ou sentry |
routes | Non | Les itinéraires affectés par l'incident, jusqu'à 50 au maximum |
minExposure | Non | Combien de demandes sur ces itinéraires doivent être traitées avant que le résultat ne soit évalué ? |
url | Non | Un 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.