Grill me visually
Первая часть — оригинальный grill-me, слово в слово. Дальше — как тот же допрос вести визуально, на странице-артефакте.
Grill-me
Interview the user relentlessly until you reach a shared understanding. Map this as a design tree: every decision branches into the decisions that hang off it.
Work the tree in rounds. The frontier is every decision whose prerequisites are already settled: the questions you can ask now without guessing at answers you haven't heard yet. Ask the whole frontier in one round: number each question and give your recommended answer. Then wait for the user's answers before the next round.
Format a round like so:
❓ **Q1** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
➡️ <your recommended answer>
---
❓ **Q2** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
➡️ <your recommended answer>
Word each question so "yes" accepts your recommended answer.
Each round the user answers reshapes the tree: settled decisions push the frontier outward and unblock questions that depended on them. Recompute the frontier and ask the next round. A question whose answer depends on another question still open in this round belongs to a later round, not this one.
Finding facts is your job, never the user's. When a frontier question needs a fact from the environment (filesystem, tools, etc.), dispatch a sub-agent with a fresh context window to find it; don't ask the user for anything you could look up yourself. Don't block on it: a running exploration is an unsettled prerequisite, so only the questions downstream of it wait for the sub-agent to report; ask the rest of the frontier now. The decisions are the user's: put each to them and wait.
The session is done when the frontier is empty: every branch of the design tree visited, nothing left silently assumed. Do not act on it until the user confirms you have reached a shared understanding.
Как раунд становится артефактом
Всё выше остаётся в силе. Меняется только место, где живёт раунд: вместо текста в чате — записи на странице-артефакте (шаблон assets/template.html), и пользователь отвечает кнопками и комментарием.
| В grill-me | На странице |
|---|---|
❓ Q1 - заголовок: текст вопроса | Блок вопроса: номер, заголовок, строка контекста |
➡️ рекомендованный ответ | Зелёная плашка «Рекомендую: …» |
| «Варианты внутри вопроса» | Вариант А и вариант Б, у каждого свой вид, плюсы и минусы |
| «yes» принимает рекомендацию | Кнопка рекомендованного варианта или «Ок» |
| Ответ пользователя текстом | Кнопка А / Б / Другое или Ок / Нет плюс комментарий |
| Решённое | Одна строка в разделе «Подтверждено» |
Что показывать визуально
Каждый вопрос раунда — ровно один блок одного из четырёх видов. Бери самый лёгкий вид, который подходит: макет стоит дороже строки текста, а лишние картинки мешают читать.
| Вид | Когда | Что внутри | Кнопки |
|---|---|---|---|
ui | Вопрос про то, как экран выглядит или как по нему идут: расположение, кнопки, навигация, порядок шагов, что где показано | Рекомендация; слева А, справа Б (если нужно — ещё В, Г…); у каждого макет, под ним плюсы и минусы | А · Б (· В…) · Другое |
logic | Вопрос про правила, а не про экран: кто что делает, статусы, сроки, цены, данные | Рекомендация; таблица: аспект · А · Б (· В…) | А · Б (· В…) · Другое |
ok | Вариантов нет, есть одно твоё предложение | Текст предложения | Ок · Нет |
plain | Уже решено: в чате, в прошлом раунде, в документах проекта | Одна строка в «Подтверждено» | — |
Все вопросы и все варианты — только в опроснике (правило автора). Не делай отдельный артефакт, чтобы сравнить варианты, даже если их много: добавь их в тот же вопрос как В, Г, Д, Е (поля c…f, см. references/items.md). Обычно хватает двух; третий и дальше — когда пользователь просит ещё вариант или их правда больше двух.
Правила для макетов ui:
- Рисуй макет, только когда разница между А и Б видна глазом. Если разница в словах — это
logicилиok. - Покажи то, чем варианты отличаются, и минимум окружения, чтобы было понятно, где это на экране. Целый экран со всеми мелочами не нужен.
- А и Б рисуй в одинаковой рамке, с одинаковыми данными и из одного исходного состояния: тогда глаз видит только разницу.
- Бери настоящие данные проекта: названия, цены, термины пользователя. Выдуманное (имена, суммы) помечай в
{{NOTE}}шапки. - Для сценария из нескольких шагов достаточно одного макета на вариант: шаги идут сверху вниз, действие пользователя — серой пометкой («нажал «Корзина»»).
- Плюсов и минусов — по 2–3 на вариант, по одной строке.
- Вид макета: чат Telegram (
tg) для ботов, телефон или браузер (htmlс рамкой) для приложений и сайтов. Поля и классы — вreferences/items.md.
Как выглядит артефакт
Страница компактная и спокойная: обычный размер текста (14 px), никаких крупных заголовков, маленькие отступы, ничего лишнего — ни декора, ни лишних таблиц, ни вводных абзацев. Светлая и тёмная тема. Всё это уже заложено в шаблоне: дизайн не переделывай, меняй только записи.
Сверху вниз:
- Шапка: мелкая серая строка — к чему относится доска; название «Опросник: <тема>»; одна строка «Отвечай прямо здесь…»; необязательная оговорка (
{{NOTE}}). - «Прочее»: одно текстовое поле и кнопка «Сохранить» — сообщение в чат, не выходя из опросника: вопрос, замечание или просьба, которые не относятся ни к одному вопросу ниже. Поле одноразовое: после разбора раунда очищается.
- «Нужно подтвердить» и число открытых вопросов. Каждый вопрос — один блок:
- номер, заголовок, при необходимости пометка «Сначала это»;
- строка контекста серым, если нужна;
- зелёная плашка «Рекомендую: …» (у
uiиlogic); - содержимое по виду:
ui— колонки, слева А, справа Б (с третьим вариантом — три колонки, с четырьмя и больше — по две в ряд), в каждой подпись, макет, под ним плюсы (+) и минусы (−); на телефоне колонки встают друг под другом.logic— таблица «аспект · А · Б (· В…)».ok— текст предложения; - поле комментария;
- кнопки внизу: по кнопке на вариант и «Другое» (у
ok— Ок · Нет). «Другое» требует комментарий.
- «Подтверждено» и число решений: нумерованный список, в каждой строке дата и решение одним предложением; под строкой серым — комментарий пользователя, если был; мелкая ссылка «вернуть в вопросы».
Отвеченный вопрос сразу переезжает из первого раздела во второй.
Шаги
-
Подготовка. Загрузи скиллы
artifact-capabilitiesиartifact-design: Artifact tool требует их перед публикацией. ЗагрузиArtifactDataчерез ToolSearch. -
Страница. Код страницы уже готов —
assets/template.html; новую страницу не пиши, только скопируй шаблон в проект и наполняй вопросами через базу. Если папка лежит в хранилище Obsidian, клади в.code/grill/<тема>.html, иначе — в папку проекта или scratchpad. Замени три метки:{{TITLE}}(два места) — имя темы, 2–4 слова, например «бот Coffee Shop». В шаблоне перед ним уже стоит «Опросник: » — так страница сразу узнаётся среди других артефактов (решение автора), полное название выйдет «Опросник: бот Coffee Shop»;{{SUBTITLE}}— к чему относится, например «Клиент Coffee Shop · Telegram-бот»;{{NOTE}}— оговорка вроде «Имена и суммы в макетах выдуманы» или пустая строка.
Остальное в файле не меняй. Если по теме уже есть такая доска — работай с ней: Artifact
readпо её URL, потом publish сurl. -
Публикация. Artifact publish,
icon: "checklist",capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}. Правилоwrite: adminзначит: отвечать могут владелец и редакторы, а тот, кому дали ссылку на просмотр, только смотрит.assetsнужен для настоящих фото в макетах: загружай их в артефакт (asset: true) и ставь в записи ссылку/_blob/<id>. -
Раунд. Один вызов ArtifactData
batchв коллекциюitems: по документу на вопрос фронтира плюсplain-строки для уже решённого. Порядок задаёт полеorder, самый срочный вопрос можно пометитьfirst: true. -
Передача. Дай ссылку, в паре строк назови вопросы раунда и попроси написать «ответил»: страница не сообщает тебе об ответах. Если ответ нужен сразу, задай вопрос ещё и в чате (AskUserQuestion), а ответ запиши в базу сам — так же, как его записала бы страница.
-
Чтение ответов. ArtifactData
listколлекцииitems. Для каждой записи соstatus: "done"и полемanswer:a,b,ok,no— решение принято, страница уже записалаsummary. Если комментарий уточняет решение, перепишиsummaryодной строкой так, чтобы в ней было то, что решено на самом деле.other— прочитай комментарий. Если это готовое решение — перепишиsummaryодной строкой. Если это новый вариант или встречный вопрос — верни запись вopenс новыми вариантами или создай новый вопрос.- Перенеси решения туда, где проект их хранит (доска проекта, ТЗ, ADR), если такое место есть.
Ещё прочитай «Прочее» — ArtifactData
getдокументаotherв коллекцииmeta. Это сообщение пользователя в чат: отнесись к нему как к сообщению в чате — ответь в чате, просьбу выполни, решение запиши туда, где проект хранит решения, новую идею заведи вопросом в следующем раунде. После этого очисти поле:updateсif_version,text: "", аreply,replyAt,atудали ({"__delete__": true}). Ничего из него не теряй: всё нужное уже записано в чате, на доске или в вопросах.Потом пересчитай фронтир и добавь следующий раунд тем же
batch. -
Конец. Фронтир пуст — коротко перескажи итог и спроси, общее ли понимание.
Правила записи
- Любую запись в существующий документ пинь
if_versionиз последнего чтения: пользователь мог ответить, пока ты работал. - Поле
answer— ответ пользователя. Не меняй его, кроме случая, когда сам возвращаешь вопрос в открытые. - Пиши коротко: заголовок — до 8 слов, рекомендация — 1–2 предложения, строка в «Подтверждено» — одно предложение.
- Язык страницы — язык пользователя. Подписи шаблона на русском; для другого языка переведи их в копии шаблона.
Проверка
После первой публикации — один ArtifactData list (все записи на месте) и один взгляд на страницу в браузере: макеты рисуются, А и Б стоят рядом. Кнопки за пользователя не нажимай: это его ответы.