Grill me visualmente
A primeira parte é o grill-me original, palavra por palavra. Depois, como conduzir a mesma entrevista visualmente, em uma página de artefato.
Grill-me
Entreviste o usuário incansavelmente até alcançar um entendimento compartilhado. Mapeie isso como uma árvore de decisão: cada decisão se ramifica nas decisões que dependem dela.
Trabalhe a árvore em rodadas. A fronteira é toda decisão cujos pré-requisitos já estão resolvidos: as perguntas que você pode fazer agora sem adivinhar respostas que ainda não ouviu. Pergunte toda a fronteira em uma rodada: numere cada pergunta e dê sua resposta recomendada. Então aguarde as respostas do usuário antes da próxima rodada.
Formate uma rodada assim:
❓ **P1** - **<título da pergunta>**: <corpo da pergunta, pode ter vários parágrafos, incluindo múltiplas opções>
➡️ <sua resposta recomendada>
---
❓ **P2** - **<título da pergunta>**: <corpo da pergunta, pode ter vários parágrafos, incluindo múltiplas opções>
➡️ <sua resposta recomendada>
Formule cada pergunta de modo que "sim" aceite sua resposta recomendada.
Cada rodada em que o usuário responde remodela a árvore: decisões resolvidas expandem a fronteira e desbloqueiam perguntas que dependiam delas. Recalcule a fronteira e pergunte a próxima rodada. Uma pergunta cuja resposta depende de outra pergunta ainda aberta nesta rodada pertence a uma rodada posterior, não a esta.
Encontrar fatos é seu trabalho, nunca do usuário. Quando uma pergunta de fronteira precisar de um fato do ambiente (sistema de arquivos, ferramentas etc.), despache um subagente com uma janela de contexto nova para encontrá-lo; não pergunte ao usuário nada que você mesmo possa descobrir. Não bloqueie por causa disso: uma exploração em andamento é um pré-requisito não resolvido, então apenas as perguntas a jusante dela aguardam o relatório do subagente; faça o resto da fronteira agora. As decisões são do usuário: apresente cada uma a ele e aguarde.
A sessão termina quando a fronteira está vazia: todos os ramos da árvore de decisão visitados, nada deixado como suposição silenciosa. Não aja até que o usuário confirme que vocês alcançaram um entendimento compartilhado.
Como uma rodada se torna um artefato
Tudo acima continua valendo. A única mudança é o local onde a rodada vive: em vez de texto no chat, são registros em uma página de artefato (template assets/template.html), e o usuário responde com botões e comentários.
| No grill-me | Na página |
|---|---|
❓ P1 - título: texto da pergunta | Bloco de pergunta: número, título, linha de contexto |
➡️ resposta recomendada | Etiqueta verde "Recomendo: …" |
| "Opções dentro da pergunta" | Opção A e opção B, cada uma com seu visual, prós e contras |
| "sim" aceita a recomendação | Botão da opção recomendada ou "Ok" |
| Resposta do usuário em texto | Botão A / B / Outro ou Ok / Não mais comentário |
| Resolvido | Uma linha na seção "Confirmado" |
O que mostrar visualmente
Cada pergunta da rodada é exatamente um bloco de um dos quatro tipos. Escolha o tipo mais simples que se aplica: um layout custa mais caro que uma linha de texto, e imagens extras atrapalham a leitura.
| Tipo | Quando | O que contém | Botões |
|---|---|---|---|
ui | Pergunta sobre a aparência da tela ou como navegar: layout, botões, navegação, ordem das etapas, o que é mostrado onde | Recomendação; A à esquerda, B à direita (se necessário, também C, D…); layout de cada um, abaixo prós e contras | A · B (· C…) · Outro |
logic | Pergunta sobre regras, não sobre a tela: quem faz o quê, status, prazos, preços, dados | Recomendação; tabela: aspecto · A · B (· C…) | A · B (· C…) · Outro |
ok | Não há opções, há uma única proposta sua | Texto da proposta | Ok · Não |
plain | Já resolvido: no chat, em rodada anterior, em documentos do projeto | Uma linha em "Confirmado" | — |
Todas as perguntas e todas as opções — apenas no questionário (regra do autor). Não crie um artefato separado para comparar opções, mesmo que sejam muitas: adicione-as à mesma pergunta como C, D, E, F (campos c…f, veja references/items.md). Normalmente duas bastam; a terceira e seguintes — quando o usuário pedir mais uma opção ou elas realmente forem mais de duas.
Regras para layouts ui:
- Desenhe um layout apenas quando a diferença entre A e B for visível a olho nu. Se a diferença for de palavras, é
logicouok. - Mostre apenas o que difere entre as opções e o mínimo de contexto para entender onde fica na tela. Não precisa da tela inteira com todos os detalhes.
- Desenhe A e B na mesma moldura, com os mesmos dados e a partir do mesmo estado inicial: assim o olho vê apenas a diferença.
- Use dados reais do projeto: nomes, preços, termos do usuário. Dados fictícios (nomes, valores) marque com
{{NOTE}}no cabeçalho. - Para um cenário de várias etapas, basta um layout por opção: as etapas vão de cima para baixo, a ação do usuário com uma anotação em cinza ("clicou em 'Carrinho'").
- Prós e contras: 2–3 por opção, uma linha cada.
- Tipo de layout: chat Telegram (
tg) para bots, telefone ou navegador (htmlcom moldura) para aplicativos e sites. Campos e classes emreferences/items.md.
Como é o artefato
A página é compacta e sóbria: tamanho de texto normal (14 px), sem títulos grandes, margens pequenas, nada supérfluo — sem decoração, sem tabelas extras, sem parágrafos introdutórios. Tema claro e escuro. Tudo isso já está no template: não mude o design, altere apenas os registros.
De cima para baixo:
- Cabeçalho: linha cinza pequena — a que se refere o quadro; título "Questionário: "; uma linha "Responda aqui…"; observação opcional (
{{NOTE}}). - "Outros": um campo de texto e botão "Salvar" — mensagem para o chat sem sair do questionário: pergunta, observação ou pedido que não se relaciona a nenhuma pergunta abaixo. O campo é descartável: após processar a rodada, é limpo.
- "Precisa confirmar" e número de perguntas abertas. Cada pergunta é um bloco:
- número, título, se necessário marcador "Primeiro isto";
- linha de contexto em cinza, se necessário;
- etiqueta verde "Recomendo: …" (para
uielogic); - conteúdo conforme o tipo:
ui— colunas, A à esquerda, B à direita (com terceira opção, três colunas; com quatro ou mais, duas por linha), cada uma com legenda, layout, abaixo prós (+) e contras (−); no celular, colunas empilham-se verticalmente.logic— tabela "aspecto · A · B (· C…)".ok— texto da proposta; - campo de comentário;
- botões abaixo: um botão por opção e "Outro" (para
ok— Ok · Não). "Outro" exige comentário.
- "Confirmado" e número de decisões: lista numerada, cada linha com data e decisão em uma frase; abaixo, em cinza, o comentário do usuário, se houver; link pequeno "voltar às perguntas".
Uma pergunta respondida move-se imediatamente da primeira seção para a segunda.
Passos
-
Preparação. Carregue as skills
artifact-capabilitieseartifact-design: a ferramenta Artifact as exige antes da publicação. CarregueArtifactDatavia ToolSearch. -
Página. O código da página já está pronto —
assets/template.html; não escreva uma nova página, apenas copie o template para o projeto e preencha com perguntas via banco de dados. Se a pasta estiver no repositório Obsidian, coloque em.code/grill/<tema>.html, caso contrário, na pasta do projeto ou scratchpad. Substitua três marcadores:{{TITLE}}(dois lugares) — nome do tema, 2–4 palavras, por exemplo "bot Coffee Shop". No template, já está precedido por "Questionário: " — assim a página se destaca entre outros artefatos (decisão do autor), o título completo será "Questionário: bot Coffee Shop";{{SUBTITLE}}— a que se refere, por exemplo "Cliente Coffee Shop · Bot Telegram";{{NOTE}}— observação como "Nomes e valores nos layouts são fictícios" ou linha vazia.
Não altere o resto do arquivo. Se já existir um quadro para o tema, trabalhe com ele: Artifact
readpela URL, depois publish comurl. -
Publicação. Artifact publish,
icon: "checklist",capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}. A regrawrite: adminsignifica: apenas o proprietário e editores podem responder; quem receber o link de visualização apenas vê.assetsé necessário para fotos reais nos layouts: carregue-as no artefato (asset: true) e coloque no registro o link/_blob/<id>. -
Rodada. Uma chamada ArtifactData
batchna coleçãoitems: um documento por pergunta da fronteira mais linhasplainpara o que já foi resolvido. A ordem é definida pelo campoorder; a pergunta mais urgente pode ser marcada comfirst: true. -
Entrega. Dê o link, em algumas linhas nomeie as perguntas da rodada e peça para escrever "respondi": a página não te notifica sobre respostas. Se precisar de resposta imediata, faça a pergunta também no chat (AskUserQuestion) e registre a resposta você mesmo no banco — da mesma forma que a página a registraria.
-
Leitura das respostas. ArtifactData
listda coleçãoitems. Para cada registro comstatus: "done"e campoanswer:a,b,ok,no— decisão tomada, a página já registrousummary. Se o comentário esclarecer a decisão, reescrevasummaryem uma linha para refletir o que foi realmente decidido.other— leia o comentário. Se for uma decisão pronta, reescrevasummaryem uma linha. Se for uma nova opção ou contra-pergunta, retorne o registro paraopencom novas opções ou crie uma nova pergunta.- Transfira as decisões para onde o projeto as armazena (quadro do projeto, especificação, ADR), se houver tal lugar.
Leia também "Outros" — ArtifactData
getdo documentootherna coleçãometa. É uma mensagem do usuário para o chat: trate-a como uma mensagem no chat — responda no chat, atenda ao pedido, registre a decisão onde o projeto armazena decisões, transforme uma nova ideia em pergunta na próxima rodada. Depois, limpe o campo:updatecomif_version,text: "", e removareply,replyAt,at({"__delete__": true}). Não perca nada dele: tudo o que for necessário já está registrado no chat, no quadro ou nas perguntas.Em seguida, recalcule a fronteira e adicione a próxima rodada com o mesmo
batch. -
Fim. Fronteira vazia — faça um breve resumo do resultado e pergunte se o entendimento é compartilhado.
Regras de registro
- Qualquer alteração em um documento existente deve usar
if_versionda última leitura: o usuário pode ter respondido enquanto você trabalhava. - O campo
answeré a resposta do usuário. Não o altere, exceto quando você mesmo retornar a pergunta para aberta. - Escreva de forma concisa: título com até 8 palavras, recomendação de 1–2 frases, linha em "Confirmado" com uma frase.
- O idioma da página é o idioma do usuário. Os rótulos do template estão em português; para outro idioma, traduza-os em uma cópia do template.
Verificação
Após a primeira publicação, faça um ArtifactData list (todos os registros no lugar) e uma olhada na página no navegador: layouts são desenhados, A e B estão lado a lado. Não clique nos botões pelo usuário: são respostas dele.