Alignement et propositions
Vérifier une action ou un brouillon contre ce que dit le Brain, faire évoluer le Brain par des propositions que vous validez, et suivre ce que font vos agents.
Le Brain ne sert pas qu’à lire : il permet de vérifier avant d’agir, d’évoluer sans perdre le contrôle, et de suivre ce que font vos agents.
Vérifier l’alignement
Avant une action importante ou la publication d’un brouillon, un assistant ou votre code peut demander à Orbit une vérification d’alignement. Orbit cherche dans les espaces autorisés les contraintes, décisions, faits et contradictions pertinents, puis rend l’une de deux conclusions :
| Conclusion | Ce qu’elle veut dire |
|---|---|
| Aucune preuve trouvée | Orbit n’a rien trouvé de pertinent. Ce n’est pas une garantie que l’action est alignée. |
| Relecture nécessaire | Des éléments pertinents doivent être conciliés avant d’agir ; ils sont listés. |
La réponse contient aussi le Context Pack exact sur lequel la conclusion repose, pour que vous puissiez la vérifier. Orbit ne présente jamais une absence de preuve comme un accord.
Depuis un assistant : l’outil MCP brain_check_alignment, que l’assistant doit appeler explicitement. Depuis votre code : POST /api/v1/alignment. Chaque vérification compte pour une lecture du quota mensuel inclus. Voir MCP et API.
Faire évoluer le Brain par des propositions
Un assistant connecté ou un script peut proposer une modification plutôt que de l’écrire : créer, corriger ou retirer une mémoire, publier ou archiver une Skill (une procédure réutilisable au format SKILL.md). Une proposition reste sans effet tant qu’une personne ne l’a pas approuvée dans Orbit, depuis la vue À valider du Brain (/brain/review).
Un assistant peut refuser une proposition à votre demande, mais seule une personne, dans Orbit, peut approuver. Chaque proposition et chaque décision est inscrite au journal d’audit. Mode d’emploi : Valider une proposition.
Relisez une proposition en entier, surtout si elle vient d’une source externe (une page web, un document, un e-mail) : un texte tiers peut contenir des instructions qui ne viennent pas de vous.
Skills portables
Une Skill est une procédure réutilisable, indépendante du modèle, au format Agent Skills : un fichier SKILL.md (nom, description, procédure). Un assistant ou un script la soumet par l’outil MCP brain_import_skill ou par POST /api/v1/skills/import (scope brain:write). Orbit vérifie le format, refuse tout secret, puis crée une proposition de publication : rien n’est publié avant votre approbation dans À valider.
Une fois approuvée, la Skill est versionnée dans l’espace. Un client la relit (brain_list_skills, brain_get_skill) ou l’exporte (GET /api/v1/skills/{slug}/export), avec le détail des changements depuis une version précédente si besoin. Orbit ne l’installe pas dans vos autres outils et ne pose aucun hook : l’hôte décide de ce qu’il en fait.
Le format prévoit des fichiers texte d’accompagnement (references/, scripts/, assets/) décrits par un manifeste. Les scripts sont stockés comme du texte et jamais exécutés par Orbit. L’import de ces fichiers n’est pas encore ouvert : aujourd’hui, une Skill s’importe avec son seul SKILL.md.
Journal d’activité des agents
Un agent connecté peut consigner ce qu’il a fait (une session, une tâche, une pull request, un déploiement, une note), avec son dépôt, sa branche et des liens. Il utilise l’outil MCP brain_log_activity ou POST /api/v1/activity (scope activity:write, que vous accordez explicitement au consentement). Un autre client relit ce registre, du plus récent au plus ancien, avec brain_list_activity ou GET /api/v1/activity (scope activity:read). Vous le lisez vous-même dans la vue Activité du Brain (/brain/activity).
C’est un registre, pas une mémoire :
- une entrée est ajoutée sans proposition, parce qu’elle ne devient jamais une Memory, un Fact ni un fragment de Context Pack : elle n’alimente pas votre contexte ;
- une entrée ne se modifie pas, et tout secret (clé, jeton, mot de passe) est refusé ;
- elle est rattachée à un espace, ou au compte ; les règles de visibilité des espaces s’appliquent, y compris pour les espaces privés ;
- les entrées sont gardées 180 jours ;
- ni l’écriture ni la lecture du journal ne comptent dans le quota de lectures.