Constitution
Les principes que toute spec et tout agent doivent suivre.
- Seuls les propriétaires du projet peuvent l’écrire. Chaque écriture crée une nouvelle révision avec une nouvelle version, et les anciennes sont conservées.
- Les agents la lisent avec
get_constitutionavant d’écrire des specs et des plans. - Sur les offres avec héritage de constitution, un projet hérite de la constitution de son organisation. Les principes hérités sont en lecture seule dans le projet : un projet peut ajouter des principes, jamais affaiblir ceux hérités.
- Pour commencer,
get_templaterenvoie le modèle global, et la galerie de Modèles propose 60 constitutions pour des langages, frameworks et moteurs et 45 specs pour les problèmes que toute équipe résout, à chercher par type, langage et domaine.
L’écrire
put_constitution prend le corps markdown complet, une nouvelle version différente de l’actuelle, un message, et expected_revision quand une constitution existe déjà. Une écriture qui modifie un principe hérité est refusée avec inherited_principle.
Quand un agent essaie de la modifier
L’agent d’un éditeur ne peut pas modifier la constitution, même par accident. Le serveur refuse l’écriture avec forbidden, l’agent le signale, et la tentative est consignée comme refusée dans le journal d’audit.