Spécifications et tableau
Des spécifications écrites par des personnes et des agents, suivies de la relecture à la réalisation
Une personne rédige une spécification dans l’éditeur. Un agent dépose ce qu’il a produit sous forme d’artifact. Quand l’un ou l’autre est prêt, il passe sur le tableau, où la relecture et l’implémentation sont deux questions distinctes.
Deux auteurs
Un seul endroit pour ce qu’écrivent personnes et agents
Les documents synchronisés viennent de votre repository et restent en lecture seule. Ce qui se trouve à côté s’écrit ici, et l’historique dit toujours qui l’a écrit.
Les brouillons, écrits par une personne
Une spécification qu’un membre de l’équipe rédige dans l’éditeur. Tant qu’elle n’est pas exportée, les agents ne la voient pas, ni ses notes : une spécification à moitié écrite qu’un agent peut lire est une spécification qu’il commencera à construire.
Les artifacts, écrits par un agent
Un agent dépose une spécification, un plan de migration ou une relecture avec write_artifact. Chaque écriture est une nouvelle version à côté de votre documentation, avec un lien qu’une personne peut ouvrir. Aucun outil ne supprime un artifact.
Exporter vers le tableau
L’axe d’implémentation arrive avec la promotion
Exporter vers le tableau est la seule porte, et elle va dans un seul sens. L’élément garde son id, ses versions, ses notes et son statut, et reste sur son propre écran, marqué comme présent sur le tableau.
Avant l’export, un brouillon ou un artifact ne porte que la relecture. Personne ne peut marquer une idée comme construite, et un agent ne peut pas revendiquer un travail sur sa propre production.
Après l’export, il reste modifiable. Une nouvelle version marque son statut comme dérivé jusqu’à une nouvelle relecture, et l’éditeur le signale avant l’enregistrement.
docs/runbooks/01-payouts.md
Cycle de vie des versements
En revueEn cours
Validé contre9f1c04e
Contenu actuel9f1c04e
Quelqu'un est en train de le lire. La construction est en cours.
Le tableau
Deux axes, un à la fois
Validé et encore en cours, c’est l’état le plus courant d’une vraie spécification. Le tableau montre un axe en colonnes et l’autre sous forme d’étiquette sur chaque carte.
Relecture
- Non trié
- Brouillon
- En revue
- Validé
- Rejeté
Implémentation
- À faire
- En cours
- Implémenté
- En test
- Terminé
- Annulé
- Non trié signifie que personne n’a encore fixé de statut : la carte ne porte donc aucune étiquette.
- Implémenté signifie qu’un agent dit l’avoir construit et que personne ne l’a confirmé. Une personne répond en sortant la carte de cette colonne.
- Rejeté exige un motif, écrit sous forme de note sur le document dans la même étape.
- La dérive compare le contenu, jamais une date. Une spécification modifiée après sa validation apparaît comme dérivée jusqu’à une nouvelle relecture.
Affichage
Non trié1
Brouillon1
en cours1
En revue1
en cours2
Validé1
terminé · décalé
Rejeté
Quatre documents, un axe. L'autre figure sur la carte.
Les agents revendiquent, les personnes ferment
Un agent peut dire que le travail est fait. Une personne décide.
Ce sont des règles du produit, appliquées sur le serveur, pas une politique écrite dans un document.
- Agent
search_docs« idempotency » dans 6 repositories · 3 résultats
- 01AgentUn agent revendique la réalisationreport_implementation fait passer une spécification à Implémenté, jamais à Terminé, et laisse une note qui attend une personne.
- 02AgentUn agent répond aux retoursIl peut être d’accord, être en désaccord, demander une précision ou dire que la note est traitée. Traitée fait passer la note en attente de confirmation, et pas plus loin.
- 03PersonneUne personne la fermeFermer une note, confirmer une revendication et rejeter une spécification sont des actes humains. La clé d’un agent n’atteint aucun d’eux.
Forfaits
Starter et supérieurs
Le statut de relecture et d’implémentation, le tableau, les notes et l’accès en écriture d’un agent font partie de Starter, Team, Business et Enterprise. La lecture, la recherche et les outils de lecture pour les agents sont inclus dans tous les forfaits, Free compris.
- Statut, dérive et tableau
- Notes et réponses des agents
- Artifacts écrits par des agents
Mettez votre prochaine spécification sur le tableau
Connectez un repository, exportez un brouillon et regardez les deux axes bouger.
Commencer gratuitement