MaleusMaleus

Façonner l'idée dans votre premier workshop

Un workshop transforme une idée en deux choses : les documents qui décrivent votre produit, et un pipeline de versions prêtes à construire.

Dans l'appWorkshops
Sur cette page

Créer un projet vous dépose directement dans un Untitled workshop. Ce n'est pas un détour : c'est l'étape deux.

Un workshop est une conversation avec un agent qui transforme une idée en deux choses. Des documents qui décrivent ce que vous construisez, et un pipeline de versions prêtes à construire, dans l'ordre. Vous obtenez les deux en parlant, pas en remplissant un formulaire.

Décrivez votre idée

Une session vide. L'invite est à gauche, et le panneau de droite dit ce avec quoi vous allez repartir : exigences produit, exigences techniques, et versions.

Prenez l'invite au pied de la lettre. Quelques lignes valent mieux qu'un cahier des charges sué tout seul. Parler va plus vite qu'écrire : utilisez la dictée, et joignez les documents que vous avez déjà.

Répondez aux questions

C'est cette partie qui fait le travail. L'agent lit ce que vous avez écrit, vous dit ce qu'il a compris, puis il demande.

Vous envoyez quelques lignes. L'agent répond ce qu'il a compris, puis pose la question 1 sur 3.

Les questions arrivent sous forme de cartes auxquelles vous répondez sur place, pas de prose à laquelle il faut répliquer. Une carte porte sa position dans la série (1 sur 3), et le type de réponse colle à la question : un choix unique quand il faut trancher, des cases à cocher quand plusieurs réponses tiennent ensemble, du texte libre pour le reste. Les flèches déplacent, Entrée valide, et Skip est toujours là quand la question ne s'applique pas.

Passer une question est une vraie réponse : l'agent prend une valeur par défaut raisonnable et le dit, plutôt que de bloquer. Mais chaque question à laquelle vous répondez, c'est une version que vous n'aurez pas à refaire.

À la fin de la série, tout l'échange vous est résumé sous forme de questions-réponses : ce sur quoi l'agent va s'appuyer est visible, pas sous-entendu.

Connectez ce dont il a besoin

Certaines réponses impliquent un service externe. Quand c'est le cas, l'agent ne devine pas en silence : il demande, dans le chat, en nommant les secrets dont il a besoin.

La série résumée, puis une demande : sans ces clés, cette partie du plan reste une supposition.

La carte nomme le service, l'étape qui en a besoin, l'environnement concerné, et les secrets un par un. Elle dit aussi ce que coûte un refus, sans détour : je n'ai pas de secrets Jira sur cet environnement, je ne peux donc que deviner la forme de l'API et l'annexe reste non vérifiée.

Set up Jira ouvre le formulaire des secrets dans la carte elle-même. Vous ne quittez pas le workshop : la conversation reste derrière, à sa place.

Le formulaire s'ouvre dans la carte, dans le fil. Personne ne vous envoie ailleurs remplir un écran de réglages.

Chaque secret est nommé et décrit, et How to obtain pointe la documentation du fournisseur quand elle existe. Save and verify les stocke sur le projet, la carte passe en état connecté, et l'agent repart de lui-même avec ce qui lui manquait. Not now continue sans. Les deux se valent ; ce qui compte, c'est de savoir lequel vous avez choisi. Voir Connecter une intégration tierce.

Corrigez ce qu'il écrit

L'agent rédige au fil de la conversation, et tout ce qu'il produit atterrit dans l'onglet Documents : exigences produit, exigences techniques, epics, sprints, et les décisions techniques prises en chemin.

Ouvrez-en un et lisez-le. Le bouton Comments dans la barre d'outils du document déplie un panneau à droite, et il y a deux façons d'y laisser un commentaire.

Commentez un passage et un marqueur numéroté le relie à cette ligne précise. Commentez tout le document quand ça ne porte pas sur une ligne.

Sélectionnez du texte et Commenter cette sélection épingle un marqueur numéroté sur ce passage. Ajouter un commentaire général rattache une note à tout l'artifact. Les deux atterrissent dans l'onglet Ouverts et ne partent nulle part tant que vous ne les envoyez pas : vous pouvez donc lire trois documents et tout marquer avant de déclencher un tour.

Cochez ensuite ce que vous voulez et envoyez. L'agent les reçoit comme instructions d'affinage et ils passent dans Envoyés. C'est le moment pas cher : une hypothèse fausse coûte un commentaire ici et une version à refaire plus tard.

Faites relire par les bonnes personnes

Un commentaire n'est pas un bloc-notes personnel. Toute personne qui a accès au projet ouvre le même document, commente le même passage et répond dans le même fil. Chaque message porte son auteur, et la discussion se déroule sous la ligne qu'elle concerne.

C'est le moment d'aller chercher ceux qui savent : celui qui tient le processus, celui qui connaît les règles de gestion, celui qui devra vivre avec. Un désaccord qui se règle ici coûte trois réponses dans un fil ; le même désaccord découvert après le build coûte une version.

Quand le fil est tranché, envoyez-le. L'agent reçoit la discussion entière, pas seulement la dernière phrase, donc le raisonnement qui a mené à la décision part avec elle. Sélectionnez plusieurs commentaires pour les envoyer d'un coup, et attendez que l'agent ait fini son tour : l'envoi est bloqué tant qu'il travaille.

Obtenez votre pipeline

Quand les documents tiennent, le workshop découpe le travail en versions et les met en file dans l'onglet Roadmap, chacune chiffrée en production units avant que quoi que ce soit ne tourne.

Cette liste, c'est le plan. Les versions tournent une à la fois, dans l'ordre, et vous pouvez encore modifier le brief de n'importe laquelle avant qu'elle ne démarre.

01En parlerL'agent pose les bonnes questions et façonne l'idée avec vous.
02Obtenir une spécificationRédigée dans l'onglet Documents. Commentez, et l'agent réécrit ce passage.
03Obtenir une roadmapLe plan découpé en versions, chacune avec son estimation.
V1 · Annuaire fournisseursen file
V2 · Circuit de validationen file

Lancez une version, ou armez un batch et laissez l'agent les enchaîner.

Une session, un plan, une file de versions.

Un workshop par sujet. Une session qui couvre l'onboarding fournisseur et le tableau de bord des dépenses produit une roadmap confuse. Deux sessions en produisent deux nettes, et vous pourrez de toute façon enchaîner leurs versions.

Ensuite

Le pipeline est prêt. Il ne reste qu'à le lancer : voir Lancer votre premier batch.

Les workshops ne servent pas qu'au démarrage. Vous en rouvrirez un pour planifier la tranche de travail suivante, pour décomposer une grosse revue, ou pour réfléchir à un changement avant de le construire. Animer un workshop couvre l'espace de travail en détail.