Documentation

Configurer

Transformez chaque règle du document de découverte en paramètres, par zone, et consultez la liste complète des éléments que le client peut modifier sans écrire de code.

Cette étape transforme les règles du document de découverte en paramètres. Travaillez sur les zones ci-dessous dans l'ordre indiqué. Pour chaque zone, définissez les paramètres avec le client.

Notez chaque décision et sa raison au fur et à mesure. Note de transmission est construit à partir de ces notes.

Projets

Définissez-le avec le client :

  • Quels dépôts deviennent des projets ? Utilisez un projet par dépôt.
  • La branche contre laquelle CoRoid ouvre ses demandes de fusion.
  • Est-ce que CoRoid peut pousser vers le dépôt (Synchronisé) ou n'y lit-il que des données (Local uniquement).
  • Les commandes d'installation, de compilation et de test du code, ainsi que les services nécessaires aux tests.
  • Ce que les agents doivent savoir sans que cela ne soit visible dans le code.

Créez chaque projet à partir de Projets. Ouvrez ensuite les paramètres du projet : Dépôt pour les branches et le mode, Variables d'environnement, et Connaissances → Contexte pour ce que les agents lisent. Vérifiez les commandes de compilation et de test détectées par CoRoid. Rédigez ce que les agents doivent savoir dans AGENTS.md, dans le dépôt.

Consultez Créer votre premier projet, Paramètres du dépôt et de la branche, Configuration de la compilation et des tests et Rédigez un AGENTS.md.

Contrôle qualité

Définissez-le avec le client :

  • Quelles conditions doit remplir chaque modification, et quels échecs bloquent ou simplement alertent.
  • Quel niveau de rigueur pour le Contrôle qualité et où s'exécutent les vérifications.
  • Que se passe-t-il avec les demandes de fusion ouvertes par les utilisateurs : Contrôle qualité CoRoid, et Révision CoRoid en tant que conseil ou blocage.
  • Quelles sources peuvent soumettre des demandes, comme Slack, Telegram ou Jira.
  • Que se passe-t-il en cas de dysfonctionnement, comme une tâche ou une déploiement échoués.

Configurez-le dans Contrôle qualité. Définissez le Par défaut de l'organisation avec les vérifications nécessaires pour la plupart des projets. N'attribuez une configuration propre à un projet que si elle diffère. Consultez Politiques et portes de qualité et Vérifications anti-slop.

Une fusion pull request par CoRoid n'a lieu qu'après validation humaine. Pour le code nécessitant un validateur désigné, comme le code de paiement, utilisez la protection de branche sur l'hébergeur Git.

Mandats

Un mandat permet à CoRoid de commencer un travail sans intervention humaine, par exemple à partir d'un outil de suivi d'erreurs. Il n'autorise jamais CoRoid à fusionner ou déployer.

Définissez-le avec le client :

  • Sur quels projets CoRoid peut-il agir de manière autonome.
  • Quel montant peut-il dépenser par semaine ou par mois.
  • Quand le client révisera à nouveau le mandat.

Configurez les mandats dans Contrôle qualité: sélectionnez Par défaut de l'organisation, puis Mandats dans le Livraison groupe. Si le client ne souhaite aucun travail sans intervention humaine, ne définissez aucun mandat. Consultez Mandats.

Profils AI

Définissez-le avec le client :

  • Quel profil l'organisation utilise par défaut.
  • Les appels aux modèles doivent-ils rester dans l'UE ? Utilisez alors UE uniquement.
  • Faut-il payer les modèles avec les crédits de modèle de CoRoid ou avec les clés du fournisseur du client ?
  • Quels fournisseurs et modèles les agents ne doivent jamais utiliser.

Configurez les profils dans Paramètres → AI profile, et les clés dans Paramètres → Clés de fournisseur. Limitez les fournisseurs et modèles dans Paramètres → Identité et accès → Politique d'organisation. Consultez Profils AI, Clés de fournisseur et Crédits de modèle.

Automatisations

Définissez-le avec le client :

  • Quel travail démarre selon un planning et quel travail démarre lorsqu'un événement se produit.
  • Ce que fait chaque automatisation et dans quels projets elle s'applique.
  • Une automatisation lit-elle et rapporte-t-elle uniquement, ou ouvre-t-elle également des tâches ?

Créez des automatisations dans Nouveau travail, et retrouvez-les toutes dans Usine → Automatisations. Les commutateurs sous En cas de dysfonctionnement dans le Contrôle qualité déclenchent une automatisation à chaque exécution. Consultez Automatisations, Calendriers et Hooks.

Workflows

Un workflow couvre un processus métier, comme une boîte de réception de support. Les agents exécutent ses étapes et les personnes prennent les décisions là où le workflow l'exige. Les workflows ne sont pas encore activés pour toutes les organisations. Demandez à CoRoid de l'activer.

Décidez avec le client :

  • Quel processus couvrir en premier ? Choisissez-en un avec de nombreux cas similaires et des règles claires.
  • Comment commence un cas : un e-mail, un formulaire sur le site web du client, une personne ou un autre workflow.
  • Les étapes et ce que chaque étape attend : rien, uniquement l'argent, ou tout changement et message.
  • Les chemins pour chaque étape : interroger le client, passer à une autre étape, suivre un tableau de règles, confier le cas à une personne ou le clore.
  • Les tableaux de règles, sous forme de lignes « quand ceci, alors cela ».
  • L'adresse d'où proviennent les réponses, la signature et la ligne de divulgation AI.

Construisez-le dans Workflows. Chaque workflow contient Des cas, Des étapes et Paramètres, et les tableaux de règles sont partagés sous Tableaux de règles. Exécutez Essayer sur les étapes avant la publication : Essayer envoie des données sans rien modifier. Ensuite Publier et Activer. Consultez Workflows via MCP.

Règles de révision

Décidez avec le client de ce que le réviseur CoRoid doit rechercher dans le code de ce client, au-delà des propres règles de CoRoid.

Écrivez les règles dans chaque dépôt : un fichier REVIEW.md à la racine, et des fichiers de règles dans un dossier review-rules CoRoid les lit depuis la branche de base, afin qu'un pull request ne puisse pas modifier les règles qu'il est chargé de réviser. Définissez ce que la révision CoRoid publie dans Contrôle qualité, sous Des demandes de tirage. Consultez Des demandes de tirage.

Compétences

Une compétence est une procédure que les agents chargent uniquement lorsque le travail l'exige, comme « comment rédiger une migration de base de données ». Décidez avec le client des procédures propres à son organisation que les agents doivent suivre.

Écrivez chaque compétence dans le dépôt, sous forme de skills/<name>/SKILL.md. Le fichier commence par des métadonnées qui contiennent un name et un description. Les agents lisent les compétences uniquement depuis le dépôt fusionné. Consultez Compétences progressives et Rédiger un AGENTS.md.

Ce que vous pouvez modifier sans code

Les clients et les implémenteurs n'ont pas accès au code source de CoRoid. Tout ce que le client peut modifier figure dans ce tableau : un paramètre dans le portail ou un fichier dans son propre dépôt. Certaines pages n'apparaissent que si la fonctionnalité a été activée dans CoRoid, comme les Workflows.

QuoiOù
Nom de l'organisationParamètres → Général
Membres et leurs rôlesParamètres → Membres
Profils AIParamètres → AI profile
Clés de fournisseurParamètres → Clés de fournisseur
Comptes de service pour la réception des travaux de APIParamètres → Comptes de service
La connexion à l'hébergeur GitParamètres → Connexions → Contrôle de source
Bots Slack et TelegramParamètres → Connexions → Canaux
Serveurs MCP externes et outils que les agents peuvent appelerParamètres → Connexions → MCP externe
Jeton d'accès, approbations et politiques d'automatisation du serveur MCP de CoRoidParamètres → Connexions → Serveur MCP CoRoid
SSO, domaines vérifiés et synchronisation d'annuaireParamètres → Identité et accès → Identité d'entreprise
Modèles, fournisseurs, commandes et outils autorisésParamètres → Identité et accès → Politique d'organisation
Sessions connectéesParamètres → Identité et accès → Sessions actives
Le journal d'audit et son exportParamètres → Identité et accès → Journal d'audit
Plan, emplacements d'agents et crédits de modèleParamètres → Facturation et utilisation
Stockage, conservation des données et export des paramètresParamètres → Données et juridique
Nom, dépôt, branches et mode d'un projetLe projet Paramètres → Général et Dépôt
Variables d'environnement d'un projetLe projet Paramètres → Variables d'environnement
Ce que les agents lisent sur un projetLe projet Paramètres → Connaissances → Contexte
Preuves de révision issues des outils du clientLe projet Paramètres → Intégrations
Vérifications, Contrôle qualité, sources de demandes, demandes de tirage et « Lorsqu'un problème survient »Contrôle qualité
Règles anti-slop et nettoyage hebdomadaire de la dette techniqueContrôle qualité
MandatsContrôle qualité → Par défaut organisationnel → Livraison
Protections de sécurité, modèles de menaces et surface d'attaqueSécurité → Projets
Langues, vérifications de traduction et contributeursGlobalisation
Environnements de version, règles d'approbation, pipeline de déploiement et gestion des versionsVersions → Paramètres de version
Automatisations d'événements et planningsUsine → Automatisations, créé dans Nouveau travail
Rapports planifiésUsine → Rapports
Workflows et tableaux de règlesWorkflows
Instructions pour les agentsAGENTS.md et les autres fichiers de mémoire dans le dépôt
Règles de révisionREVIEW.md et le review-rules dossier dans le dépôt
Compétencesskills/<name>/SKILL.md dans le dépôt

Le Serveur MCP CoRoid modifie plusieurs de ces paramètres depuis un assistant, au sein des outils activés.

Un besoin que rien ne couvre.

Lorsqu'aucune ligne du tableau ne correspond à une règle, ne vous basez pas sur le produit. Envoyez ce besoin à CoRoid sous forme de demande via le page de contact. Rédigez :

  • La situation du client, sans données clients.
  • Ce que vous avez essayé avec les paramètres ci-dessus.
  • Ce dont le client a besoin et pourquoi.

Une modification apportée par CoRoid est déployée auprès de chaque client lors d'une version.

Terminé quand

  • Chaque règle dans le document de découverte comporte un paramètre ou une demande à l'attention de CoRoid.
  • Chaque décision a une justification dans vos notes.
  • Une tâche dans chaque projet parvient à pull request après les vérifications.