Was macht Grill me visually?
Der erste Teil ist der originale Grill-me, wortwörtlich. Danach wird gezeigt, wie dieselbe Befragung visuell auf einer Artefaktseite geführt wird.
Grill-me
Befrage den Nutzer unermüdlich, bis ein gemeinsames Verständnis erreicht ist. Bilde dies als Entwurfsbaum ab: Jede Entscheidung verzweigt sich in die davon abhängigen Entscheidungen.
Arbeite den Baum in Runden ab. Der Frontier sind alle Entscheidungen, deren Voraussetzungen bereits geklärt sind: die Fragen, die du jetzt stellen kannst, ohne über noch nicht gehörte Antworten zu raten. Stelle den gesamten Frontier in einer Runde: Nummeriere jede Frage und gib deine empfohlene Antwort. Warte dann auf die Antworten des Nutzers, bevor du die nächste Runde stellst.
Formatiere eine Runde wie folgt:
❓ **F1** - **<Fragentitel>**: <Fragetext, eventuell mehrere Absätze, einschließlich mehrerer Optionen>
➡️ <deine empfohlene Antwort>
---
❓ **F2** - **<Fragentitel>**: <Fragetext, eventuell mehrere Absätze, einschließlich mehrerer Optionen>
➡️ <deine empfohlene Antwort>
Formuliere jede Frage so, dass „Ja“ deine empfohlene Antwort akzeptiert.
Jede Runde verändert die Antworten des Nutzers den Baum: Geklärte Entscheidungen verschieben den Frontier nach außen und geben Fragen frei, die von ihnen abhingen. Berechne den Frontier neu und stelle die nächste Runde. Eine Frage, deren Antwort von einer anderen noch in dieser Runde offenen Frage abhängt, gehört zu einer späteren Runde, nicht zu dieser.
Fakten zu ermitteln ist deine Aufgabe, niemals die des Nutzers. Wenn eine Frontier-Frage eine Tatsache aus der Umgebung benötigt (Dateisystem, Tools usw.), starte einen Sub-Agenten mit einem neuen Kontextfenster, um sie zu finden; frage den Nutzer nicht nach etwas, das du selbst nachschlagen kannst. Blockiere nicht darauf: Eine laufende Erkundung ist eine ungeklärte Voraussetzung, also warten nur die nachgelagerten Fragen auf den Bericht des Sub-Agenten; stelle den Rest des Frontiers jetzt. Die Entscheidungen liegen beim Nutzer: Lege sie ihm vor und warte.
Die Sitzung ist beendet, wenn der Frontier leer ist: Jeder Zweig des Entwurfsbaums besucht, nichts bleibt stillschweigend angenommen. Handle erst, wenn der Nutzer bestätigt, dass ein gemeinsames Verständnis erreicht ist.
Wie eine Runde zum Artefakt wird
Alles oben Genannte bleibt gültig. Es ändert sich nur der Ort, an dem die Runde lebt: Statt Text im Chat – Einträge auf einer Artefaktseite (Vorlage assets/template.html), und der Nutzer antwortet mit Schaltflächen und Kommentar.
| In Grill-me | Auf der Seite |
|---|---|
❓ F1 - Titel: Fragetext | Frageblock: Nummer, Titel, Kontextzeile |
➡️ empfohlene Antwort | Grünes Label „Ich empfehle: …“ |
| „Optionen in der Frage“ | Option A und Option B, jede mit eigenem Aussehen, Vor- und Nachteilen |
| „yes“ akzeptiert die Empfehlung | Schaltfläche der empfohlenen Option oder „Ok“ |
| Antwort des Nutzers als Text | Schaltfläche A / B / Sonstiges oder Ok / Nein plus Kommentar |
| Erledigt | Eine Zeile im Bereich „Bestätigt“ |
Was visuell gezeigt wird
Jede Frage einer Runde ist genau ein Block eines der vier Typen. Nimm den einfachsten Typ, der passt: Ein Mockup kostet mehr als eine Textzeile, und überflüssige Bilder stören beim Lesen.
| Typ | Wann | Was drin | Schaltflächen |
|---|---|---|---|
ui | Frage danach, wie ein Bildschirm aussieht oder wie man darauf navigiert: Layout, Schaltflächen, Navigation, Schrittfolge, was wo gezeigt wird | Empfehlung; links A, rechts B (ggf. auch C, D…); bei jedem Mockup, darunter Vor- und Nachteile | A · B (· C…) · Sonstiges |
logic | Frage nach Regeln, nicht nach dem Bildschirm: Wer macht was, Status, Fristen, Preise, Daten | Empfehlung; Tabelle: Aspekt · A · B (· C…) | A · B (· C…) · Sonstiges |
ok | Es gibt keine Optionen, nur einen Vorschlag von dir | Text des Vorschlags | Ok · Nein |
plain | Bereits entschieden: im Chat, in einer früheren Runde, in Projektdokumenten | Eine Zeile in „Bestätigt“ | — |
Alle Fragen und alle Optionen nur im Fragebogen (Autorenregel). Erstelle kein separates Artefakt, um Optionen zu vergleichen, selbst wenn es viele sind: Füge sie derselben Frage als C, D, E, F hinzu (Felder c…f, siehe references/items.md). Normalerweise reichen zwei; ein dritter und weitere nur, wenn der Nutzer eine weitere Option wünscht oder es tatsächlich mehr als zwei gibt.
Regeln für UI-Mockups:
- Zeichne ein Mockup nur, wenn der Unterschied zwischen A und B sichtbar ist. Wenn der Unterschied in Worten liegt, handelt es sich um
logicoderok. - Zeige, worin sich die Optionen unterscheiden, und so wenig Umgebung wie nötig, um zu verstehen, wo dies auf dem Bildschirm ist. Ein ganzer Bildschirm mit allen Details ist nicht nötig.
- Zeichne A und B im gleichen Rahmen, mit denselben Daten und aus demselben Ausgangszustand: Dann sieht das Auge nur den Unterschied.
- Verwende echte Projektdaten: Namen, Preise, Begriffe des Nutzers. Erfundenes (Namen, Beträge) kennzeichne in
{{NOTE}}der Kopfzeile. - Für ein Szenario mit mehreren Schritten reicht ein Mockup pro Option: Die Schritte gehen von oben nach unten, die Aktion des Nutzers als grauer Hinweis („hat ‚Warenkorb‘ gedrückt“).
- Vor- und Nachteile: jeweils 2–3 pro Option, einzeilig.
- Mockup-Typ: Telegram-Chat (
tg) für Bots, Telefon oder Browser (htmlmit Rahmen) für Apps und Websites. Felder und Klassen siehereferences/items.md.
Wie das Artefakt aussieht
Die Seite ist kompakt und ruhig: normale Textgröße (14 px), keine großen Überschriften, kleine Abstände, nichts Überflüssiges – keine Dekoration, keine überflüssigen Tabellen, keine einleitenden Absätze. Helles und dunkles Design. All dies ist bereits in der Vorlage hinterlegt: Ändere das Design nicht, sondern ersetze nur die Einträge.
Von oben nach unten:
- Kopfzeile: Kleine graue Zeile – worauf sich die Tafel bezieht; Titel „Fragebogen: “; eine Zeile „Antworte direkt hier…“; optionaler Hinweis (
{{NOTE}}). - „Sonstiges“: Ein Textfeld und eine Schaltfläche „Speichern“ – Nachricht an den Chat, ohne den Fragebogen zu verlassen: Frage, Anmerkung oder Bitte, die sich auf keine der folgenden Fragen bezieht. Das Feld ist einmalig: Nach der Bearbeitung der Runde wird es geleert.
- „Noch zu bestätigen“ und die Anzahl offener Fragen. Jede Frage ist ein Block:
- Nummer, Titel, ggf. Markierung „Zuerst dies“;
- Kontextzeile in Grau, falls nötig;
- Grünes Label „Ich empfehle: …“ (bei
uiundlogic); - Inhalt je nach Typ:
ui– Spalten, links A, rechts B (bei einer dritten Option drei Spalten, bei vier oder mehr zwei pro Reihe), in jeder Spalte Beschriftung, Mockup, darunter Vorteile (+) und Nachteile (−); auf dem Handy werden die Spalten untereinander angeordnet.logic– Tabelle „Aspekt · A · B (· C…)“.ok– Text des Vorschlags; - Kommentarfeld;
- Schaltflächen unten: eine Schaltfläche pro Option und „Sonstiges“ (bei
ok– Ok · Nein). „Sonstiges“ erfordert einen Kommentar.
- „Bestätigt“ und Anzahl der Entscheidungen: nummerierte Liste, in jeder Zeile Datum und Entscheidung in einem Satz; unter der Zeile in Grau der Kommentar des Nutzers, falls vorhanden; kleiner Link „zurück zu den Fragen“.
Eine beantwortete Frage wandert sofort aus dem ersten in den zweiten Bereich.
Schritte
-
Vorbereitung. Lade die Skills
artifact-capabilitiesundartifact-design: Das Artifact-Tool benötigt sie vor der Veröffentlichung. LadeArtifactDataüber ToolSearch. -
Seite. Der Seiten-Code ist bereits fertig –
assets/template.html; erstelle keine neue Seite, kopiere nur die Vorlage in das Projekt und befüll sie über die Datenbank. Wenn der Ordner im Obsidian-Speicher liegt, lege sie in.code/grill/<thema>.htmlab, andernfalls im Projektordner oder Scratchpad. Ersetze drei Markierungen:{{TITLE}}(an zwei Stellen) – Name des Themas, 2–4 Wörter, z. B. „Bot Coffee Shop“. In der Vorlage steht bereits „Fragebogen: “ davor – so ist die Seite sofort unter anderen Artefakten erkennbar (Autorenregel), vollständiger Titel „Fragebogen: Bot Coffee Shop“;{{SUBTITLE}}– worauf es sich bezieht, z. B. „Kunde Coffee Shop · Telegram-Bot“;{{NOTE}}– Hinweis wie „Namen und Beträge in Mockups sind erfunden“ oder eine leere Zeile.
Ändere nichts anderes in der Datei. Wenn es zu diesem Thema bereits eine solche Tafel gibt, arbeite damit: Artifact
readüber die URL, dann publish miturl. -
Veröffentlichung. Artifact publish,
icon: „checklist“,capabilities: {“db“:{“rules“:[{“path“:“„,“read“:“view“,“write“:“admin“}]},“user“:{},“assets“:{}}. Die Regelwrite: adminbedeutet: Antworten können der Eigentümer und Redakteure, während jemand, der nur einen Lese-Link hat, nur zuschaut.assetswird für echte Fotos in Mockups benötigt: Lade sie in das Artefakt hoch (asset: true) und setze in den Einträgen den Link/_blob/<id>. -
Runde. Ein Aufruf von ArtifactData
batchin die Sammlungitems: ein Dokument pro Frage des Frontiers plusplain-Zeilen für bereits entschiedene. Die Reihenfolge bestimmt das Feldorder, die dringendste Frage kann mitfirst: truemarkiert werden. -
Übergabe. Gib den Link, nenne in ein paar Zeilen die Fragen der Runde und bitte, „geantwortet“ zu schreiben: Die Seite meldet dir die Antworten nicht. Wenn eine Antwort sofort benötigt wird, stelle die Frage zusätzlich im Chat (AskUserQuestion) und trage die Antwort selbst in die Datenbank ein – genauso, wie die Seite sie eingetragen hätte.
-
Antworten lesen. ArtifactData
listder Sammlungitems. Für jeden Eintrag mitstatus: „done“und Feldanswer:a,b,ok,no– Entscheidung getroffen, die Seite hat bereitssummarygeschrieben. Wenn der Kommentar die Entscheidung präzisiert, überschreibesummaryin einem Satz, sodass darin das tatsächlich Entscheidene steht.other– lies den Kommentar. Handelt es sich um eine fertige Entscheidung, überschreibesummaryin einem Satz. Ist es eine neue Option oder eine Gegenfrage, setze den Eintrag aufopenzurück mit neuen Optionen oder erstelle eine neue Frage.- Übertrage die Entscheidungen an den Ort, an dem das Projekt sie speichert (Projektboard, Lastenheft, ADR), falls ein solcher Ort existiert.
Lies außerdem „Sonstiges“ – ArtifactData
getdes Dokumentsotherin der Sammlungmeta. Dies ist eine Nachricht des Nutzers an den Chat: Behandle sie wie eine Chat-Nachricht – antworte im Chat, erfülle die Bitte, schreibe die Entscheidung an den Ort, an dem das Projekt Entscheidungen speichert, erstelle aus der neuen Idee eine Frage in der nächsten Runde. Leere danach das Feld:updatemitif_version,text: „„, und entfernereply,replyAt,at({“__delete__“: true}). Verliere nichts daraus: Alles Notwendige ist bereits im Chat, auf der Tafel oder in den Fragen gespeichert.Berechne dann den Frontier neu und füge die nächste Runde mit demselben
batchhinzu. -
Ende. Der Frontier ist leer – fasse das Ergebnis kurz zusammen und frage, ob das Verständnis gemeinsam ist.
Regeln zum Schreiben
- Jeden Eintrag in ein vorhandenes Dokument schreibst du mit
if_versionaus dem letzten Lesevorgang: Der Nutzer könnte geantwortet haben, während du gearbeitet hast. - Das Feld
answerist die Antwort des Nutzers. Ändere es nicht, außer wenn du die Frage selbst wieder in die offenen zurückstellst. - Schreibe kurz: Titel bis zu 8 Wörter, Empfehlung 1–2 Sätze, Zeile in „Bestätigt“ ein Satz.
- Sprache der Seite ist die Sprache des Nutzers. Die Beschriftungen der Vorlage sind auf Deutsch; für eine andere Sprache übersetze sie in einer Kopie der Vorlage.
Überprüfung
Nach der ersten Veröffentlichung – ein ArtifactData list (alle Einträge vorhanden) und ein Blick auf die Seite im Browser: Mockups werden gezeichnet, A und B stehen nebeneinander. Drücke keine Schaltflächen für den Nutzer: Das sind seine Antworten.