Spécifications
L'onglet Spécifications contient les spécifications de développement — descriptions normalisées et versionnées d'un développement à partir desquelles travaillent à la fois l'agent et les humains de l'équipe. Une spécification est la source de vérité partagée pour un travail donné : ce qui est construit, pourquoi et selon quelles règles. Les spécifications sont produites par le rôle Spécification dans Chat — voir Rôles de développement.
À quoi sert une spécification#
Une spécification transforme une exigence floue en une description normalisée et versionnée que l'agent peut implémenter et qu'un humain peut réviser. Chaque spécification est une famille avec un spec_id stable qui reste le même à travers toutes les versions — de sorte qu'à mesure que la spécification évolue, son historique forme un fil continu, et les liens qui y renvoient ne se rompent jamais. Lorsque vous confiez une spécification à implémenter à l'agent (y compris en mode autonome), il travaille à partir de cette définition stable et versionnée plutôt que d'un message de chat ponctuel.
La liste des spécifications#
Le côté gauche liste vos familles de spécifications. Chaque entrée affiche :
- Le titre de la spécification.
- Un badge de statut.
- v{version} — la version actuelle.
- {n} versions — le nombre de versions existantes.
Lorsqu'un projet n'a encore aucune spécification, la liste affiche :
Aucune spécification pour l'instant — utilisez le rôle Spécification dans Chat pour en créer une.
Choisissez une famille à gauche pour l'ouvrir.
La vue famille#
Ouvrir une famille affiche trois sous-onglets :
| Sous-onglet | Ce qu'il affiche | Quand il est disponible |
|---|---|---|
| Actuelle | La version actuelle, rendue depuis le Markdown | Toujours |
| Versions (N) | Toutes les versions, avec des résumés de changements par version | Toujours |
| Comparer | Une comparaison côte à côte entre deux versions | Uniquement avec 2 versions ou plus (désactivé sinon) |
Actuelle#
Le sous-onglet Actuelle rend la dernière version de la spécification en Markdown formaté. Les administrateurs disposent de contrôles pour gérer la spécification :
| Contrôle | Ce qu'il fait |
|---|---|
| Modifier | Ouvrir la version actuelle pour l'éditer. |
| Enregistrer | Enregistrer vos modifications. |
| Annuler | Abandonner vos modifications et quitter le mode édition. |
| Renommer la famille | Changer le titre de la spécification. Le spec_id reste le même. |
| Supprimer | Supprimer la famille entière et toutes ses versions. |
Supprimer retire toute la famille de spécifications — chaque version, pas seulement l'actuelle. Il n'y a pas de suppression par version ; c'est tout ou rien.
Versions (N)#
Le sous-onglet Versions affiche l'historique complet :
- Un rail de versions listant chaque version par tag. Une version qui a un résumé de changement est marquée d'un point.
- Un encadré « Changements dans v{v} » décrivant ce qui a changé dans la version sélectionnée.
- Le contenu de la version sélectionnée.
Utilisez-le pour lire n'importe quelle version passée exactement telle qu'elle était, et pour voir le récit de l'évolution de la spécification.
Comparer#
Le sous-onglet Comparer affiche une comparaison entre deux versions quelconques. Il nécessite au moins deux versions pour être disponible.
| Contrôle | Ce qu'il fait |
|---|---|
| De | Sélectionner la version de base depuis laquelle comparer. |
| À | Sélectionner la version vers laquelle comparer. |
| Vue des différences | Affiche les ajouts et suppressions avec une gouttière + / −. |
| Encadré « Ce qui a changé » | Un résumé des différences entre les deux versions sélectionnées. |
Comment les spécifications sont créées#
Vous ne rédigez pas les spécifications à la main de zéro ici — vous les générez avec le rôle Spécification dans Chat. Décrivez l'exigence à l'agent dans ce rôle et il produit une spécification normalisée, qui apparaît ensuite comme une famille sur cet onglet. Les administrateurs peuvent l'affiner par la suite avec Modifier / Enregistrer, et chaque changement significatif devient une nouvelle version avec son propre résumé de changement.
Où aller ensuite#
- Rôles de développement — y compris le rôle Spécification qui produit les spécifications.
- Chat — où vous choisissez un rôle et créez une spécification.
- Mode autonome — confiez une spécification à l'agent et laissez-le travailler sans surveillance.
- Méthodologie — les règles et la connaissance que l'agent applique pendant l'implémentation d'une spécification.