Grill me visuellement
La première partie est le grill-me original, mot pour mot. Ensuite, comment mener le même interrogatoire visuellement, sur une page artefact.
Grill-me
Interrogez l'utilisateur sans relâche jusqu'à parvenir à une compréhension partagée. Cartographiez-la sous forme d'arbre de décision : chaque décision se ramifie en décisions qui en dépendent.
Parcourez l'arbre par rounds. La frontière est constituée de toutes les décisions dont les prérequis sont déjà réglés : les questions que vous pouvez poser maintenant sans deviner des réponses que vous n'avez pas encore entendues. Posez toute la frontière en un seul round : numérotez chaque question et donnez votre réponse recommandée. Attendez ensuite les réponses de l'utilisateur avant le round suivant.
Formatez un round comme suit :
❓ **Q1** - **<titre de la question>** : <corps de la question, éventuellement plusieurs paragraphes, avec choix multiples>
➡️ <votre réponse recommandée>
---
❓ **Q2** - **<titre de la question>** : <corps de la question, éventuellement plusieurs paragraphes, avec choix multiples>
➡️ <votre réponse recommandée>
Formulez chaque question de sorte que « oui » accepte votre réponse recommandée.
Chaque round, les réponses de l'utilisateur remodèlent l'arbre : les décisions prises repoussent la frontière et débloquent les questions qui en dépendaient. Recalculez la frontière et posez le round suivant. Une question dont la réponse dépend d'une autre question encore ouverte dans ce round appartient à un round ultérieur, pas à celui-ci.
Trouver les faits est votre travail, jamais celui de l'utilisateur. Lorsqu'une question de la frontière nécessite un fait de l'environnement (système de fichiers, outils, etc.), envoyez un sous-agent avec une nouvelle fenêtre de contexte pour le trouver ; ne demandez pas à l'utilisateur quelque chose que vous pouvez chercher vous-même. Ne bloquez pas dessus : une exploration en cours est un prérequis non réglé, donc seules les questions en aval attendent que le sous-agent rende compte ; posez le reste de la frontière maintenant. Les décisions appartiennent à l'utilisateur : soumettez-les-lui et attendez.
La session est terminée lorsque la frontière est vide : chaque branche de l'arbre de décision a été visitée, rien n'a été supposé silencieusement. N'agissez pas tant que l'utilisateur n'a pas confirmé que vous êtes parvenu à une compréhension partagée.
Comment un round devient artefact
Tout ce qui précède reste valable. Seul change l'endroit où vit le round : au lieu du texte dans le chat, les enregistrements sur une page artefact (modèle assets/template.html), et l'utilisateur répond par des boutons et un commentaire.
| Dans grill-me | Sur la page |
|---|---|
❓ Q1 - titre : texte de la question | Bloc question : numéro, titre, ligne de contexte |
➡️ réponse recommandée | Bannière verte « Je recommande : … » |
| « Options dans la question » | Option A et option B, chacune avec son visuel, avantages et inconvénients |
| « oui » accepte la recommandation | Bouton de l'option recommandée ou « OK » |
| Réponse de l'utilisateur par texte | Bouton A / B / Autre ou OK / Non plus commentaire |
| Résolu | Une ligne dans la section « Confirmé » |
Quoi afficher visuellement
Chaque question d'un round correspond exactement à un bloc d'un des quatre types. Prenez le type le plus simple qui convient : une maquette coûte plus cher qu'une ligne de texte, et des images superflues gênent la lecture.
| Type | Quand | Contenu | Boutons |
|---|---|---|---|
ui | Question sur l'apparence ou le parcours d'un écran : disposition, boutons, navigation, ordre des étapes, affichage | Recommandation ; A à gauche, B à droite (si besoin, C, D…) ; maquette pour chacun, avantages et inconvénients en dessous | A · B (· C…) · Autre |
logic | Question sur les règles, pas sur l'écran : qui fait quoi, statuts, délais, prix, données | Recommandation ; tableau : aspect · A · B (· C…) | A · B (· C…) · Autre |
ok | Pas d'options, une seule proposition | Texte de la proposition | OK · Non |
plain | Déjà décidé : dans le chat, un round précédent, les documents du projet | Une ligne dans « Confirmé » | — |
Toutes les questions et toutes les options uniquement dans le questionnaire (règle de l'auteur). Ne créez pas d'artefact séparé pour comparer les options, même si elles sont nombreuses : ajoutez-les dans la même question en tant que C, D, E, F (champs c…f, voir references/items.md). En général, deux suffisent ; la troisième et les suivantes sont pour quand l'utilisateur demande une option supplémentaire ou qu'il y en a vraiment plus de deux.
Règles pour les maquettes ui :
- Dessinez une maquette seulement lorsque la différence entre A et B est visible à l'œil. Si la différence est dans les mots, c'est
logicouok. - Montrez ce qui différencie les options et un minimum d'environnement pour comprendre où cela se trouve sur l'écran. Pas besoin de l'écran entier avec tous les détails.
- Dessinez A et B dans le même cadre, avec les mêmes données et à partir du même état initial : ainsi l'œil ne voit que la différence.
- Utilisez les vraies données du projet : noms, prix, termes de l'utilisateur. Les éléments fictifs (noms, montants) sont signalés par
{{NOTE}}dans l'en-tête. - Pour un scénario à plusieurs étapes, une maquette par option suffit : les étapes se succèdent de haut en bas, l'action de l'utilisateur est indiquée par une annotation grise (« a cliqué sur « Panier » »).
- Avantages et inconvénients : 2 à 3 par option, une ligne chacun.
- Type de maquette : chat Telegram (
tg) pour les bots, téléphone ou navigateur (htmlavec cadre) pour les applications et sites. Champs et classes dansreferences/items.md.
À quoi ressemble l'artefact
La page est compacte et sobre : taille de texte normale (14 px), pas de grands titres, petits interlignes, rien de superflu – ni décoration, ni tableaux inutiles, ni paragraphes d'introduction. Thème clair et sombre. Tout cela est déjà intégré dans le modèle : ne modifiez pas le design, changez uniquement les enregistrements.
De haut en bas :
- En-tête : petite ligne grise – à quoi se rapporte le tableau ; titre « Questionnaire : » ; une ligne « Réponds ici même… » ; mention facultative (
{{NOTE}}). - « Autre » : un champ de texte et un bouton « Enregistrer » – message dans le chat sans quitter le questionnaire : question, remarque ou demande qui ne se rapporte à aucune question ci-dessous. Le champ est à usage unique : après le traitement du round, il est vidé.
- « À confirmer » et le nombre de questions ouvertes. Chaque question est un bloc :
- numéro, titre, si nécessaire mention « D'abord ceci » ;
- ligne de contexte en gris, si nécessaire ;
- bannière verte « Je recommande : … » (pour
uietlogic); - contenu selon le type :
ui– colonnes, A à gauche, B à droite (avec une troisième option, trois colonnes ; avec quatre ou plus, deux par ligne), dans chacune une légende, une maquette, en dessous avantages (+) et inconvénients (−) ; sur téléphone, les colonnes se placent les unes sous les autres.logic– tableau « aspect · A · B (· C…) ».ok– texte de la proposition ; - champ de commentaire ;
- boutons en bas : un bouton par option et « Autre » (pour
ok– OK · Non). « Autre » nécessite un commentaire.
- « Confirmé » et le nombre de décisions : liste numérotée, chaque ligne contient la date et la décision en une phrase ; en dessous de la ligne, en gris, le commentaire de l'utilisateur s'il y en a un ; petit lien « remettre dans les questions ».
Une question répondue passe immédiatement de la première section à la seconde.
Étapes
-
Préparation. Chargez les compétences
artifact-capabilitiesetartifact-design: l'outil Artifact les requiert avant la publication. ChargezArtifactDatavia ToolSearch. -
Page. Le code de la page est déjà prêt –
assets/template.html; n'écrivez pas de nouvelle page, copiez simplement le modèle dans le projet et remplissez-le avec les questions via la base de données. Si le dossier se trouve dans le stockage Obsidian, placez-le dans.code/grill/<sujet>.html, sinon dans le dossier du projet ou scratchpad. Remplacez les trois étiquettes :{{TITLE}}(deux endroits) – nom du sujet, 2 à 4 mots, par exemple « bot Coffee Shop ». Dans le modèle, il est déjà précédé par « Questionnaire : » – ainsi la page est immédiatement reconnaissable parmi les autres artefacts (décision de l'auteur), le nom complet sera « Questionnaire : bot Coffee Shop » ;{{SUBTITLE}}– à quoi se rapporte, par exemple « Client Coffee Shop · Bot Telegram » ;{{NOTE}}– mention telle que « Noms et montants dans les maquettes sont fictifs » ou une chaîne vide.
Ne modifiez rien d'autre dans le fichier. Si un tel tableau existe déjà pour le sujet, travaillez avec : Artifact
readvia son URL, puispublishavecurl. -
Publication. Artifact publish,
icon: "checklist",capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}. La règlewrite: adminsignifie que seuls le propriétaire et les éditeurs peuvent répondre ; celui qui a reçu un lien de visionnage ne fait que regarder.assetsest nécessaire pour les vraies photos dans les maquettes : chargez-les dans l'artefact (asset: true) et placez le lien/_blob/<id>dans les enregistrements. -
Round. Un seul appel ArtifactData
batchdans la collectionitems: un document par question de la frontière plus les lignesplainpour ce qui est déjà décidé. L'ordre est défini par le champorder, la question la plus urgente peut être marquéefirst: true. -
Transmission. Donnez le lien, en quelques lignes nommez les questions du round et demandez d'écrire « répondu » : la page ne vous notifie pas des réponses. Si une réponse est nécessaire immédiatement, posez la question également dans le chat (AskUserQuestion) et enregistrez la réponse vous-même dans la base de données, exactement comme la page l'aurait fait.
-
Lecture des réponses. ArtifactData
listde la collectionitems. Pour chaque enregistrement avecstatus: "done"et champanswer:a,b,ok,no– décision prise, la page a déjà enregistrésummary. Si le commentaire précise la décision, réécrivezsummaryen une ligne de manière à refléter la décision réelle.other– lisez le commentaire. S'il s'agit d'une solution prête, réécrivezsummaryen une ligne. S'il s'agit d'une nouvelle option ou d'une question de retour, remettez l'enregistrement enopenavec de nouvelles options ou créez une nouvelle question.- Transférez les décisions là où le projet les conserve (tableau de bord, cahier des charges, ADR), si un tel endroit existe.
Lisez également « Autre » – ArtifactData
getdu documentotherdans la collectionmeta. Il s'agit d'un message de l'utilisateur dans le chat : traitez-le comme un message dans le chat – répondez dans le chat, exécutez la demande, enregistrez la décision là où le projet stocke les décisions, transformez une nouvelle idée en question dans le round suivant. Ensuite, videz le champ :updateavecif_version,text: "", et supprimezreply,replyAt,at({"__delete__": true}). Ne perdez rien de ce contenu : tout ce qui est nécessaire est déjà enregistré dans le chat, sur le tableau ou dans les questions.Recalculez ensuite la frontière et ajoutez le round suivant avec le même
batch. -
Fin. La frontière est vide – résumez brièvement le résultat et demandez si la compréhension est partagée.
Règles d'enregistrement
- Toute modification d'un document existant doit utiliser
if_versionissu de la dernière lecture : l'utilisateur a pu répondre pendant que vous travailliez. - Le champ
answerest la réponse de l'utilisateur. Ne le modifiez pas, sauf si vous remettez vous-même la question dans les ouvertes. - Écrivez court : titre – jusqu'à 8 mots, recommandation – 1 à 2 phrases, ligne dans « Confirmé » – une phrase.
- La langue de la page est celle de l'utilisateur. Les légendes du modèle sont en français ; pour une autre langue, traduisez-les dans une copie du modèle.
Vérification
Après la première publication, effectuez un ArtifactData list (tous les enregistrements en place) et un coup d'œil sur la page dans le navigateur : les maquettes s'affichent, A et B sont côte à côte. N'appuyez pas sur les boutons à la place de l'utilisateur : ce sont ses réponses.