Grill me visualmente
La primera parte es el grill-me original, palabra por palabra. Luego, cómo llevar el mismo interrogatorio de forma visual, en una página-artefacto.
Grill-me
Entrevista al usuario sin descanso hasta alcanzar un entendimiento compartido. Mapea esto como un árbol de diseño: cada decisión se ramifica en las decisiones que dependen de ella.
Trabaja el árbol en rondas. El frente son todas las decisiones cuyos prerrequisitos ya están resueltos: las preguntas que puedes hacer ahora sin adivinar respuestas que aún no has escuchado. Pregunta todo el frente en una ronda: numera cada pregunta y da tu respuesta recomendada. Luego espera las respuestas del usuario antes de la siguiente ronda.
Formatea una ronda así:
❓ **P1** - **<título de la pregunta>**: <cuerpo de la pregunta, puede tener varios párrafos, incluyendo opciones múltiples>
➡️ <tu respuesta recomendada>
---
❓ **P2** - **<título de la pregunta>**: <cuerpo de la pregunta, puede tener varios párrafos, incluyendo opciones múltiples>
➡️ <tu respuesta recomendada>
Redacta cada pregunta de modo que "sí" acepte tu respuesta recomendada.
Cada ronda, las respuestas del usuario reconfiguran el árbol: las decisiones resueltas empujan el frente hacia afuera y desbloquean preguntas que dependían de ellas. Recalcula el frente y pregunta la siguiente ronda. Una pregunta cuya respuesta depende de otra pregunta aún abierta en esta ronda pertenece a una ronda posterior, no a esta.
Encontrar hechos es tu trabajo, nunca del usuario. Cuando una pregunta del frente necesite un hecho del entorno (sistema de archivos, herramientas, etc.), envía un sub-agente con una ventana de contexto nueva para encontrarlo; no le pidas al usuario nada que puedas buscar tú mismo. No te detengas por eso: una exploración en curso es un prerrequisito no resuelto, así que solo las preguntas que dependen de ella esperan el informe del sub-agente; pregunta el resto del frente ahora. Las decisiones son del usuario: preséntaselas y espera.
La sesión termina cuando el frente está vacío: cada rama del árbol de diseño visitada, sin nada asumido en silencio. No actúes hasta que el usuario confirme que se ha alcanzado un entendimiento compartido.
Cómo una ronda se convierte en artefacto
Todo lo anterior sigue vigente. Solo cambia el lugar donde vive la ronda: en lugar de texto en el chat, registros en una página-artefacto (plantilla assets/template.html), y el usuario responde con botones y comentarios.
| En grill-me | En la página |
|---|---|
❓ P1 - título: texto de la pregunta | Bloque de pregunta: número, título, línea de contexto |
➡️ respuesta recomendada | Placa verde «Recomiendo: …» |
| «Opciones dentro de la pregunta» | Opción A y Opción B, cada una con su propia vista, pros y contras |
| «sí» acepta la recomendación | Botón de la opción recomendada o «Ok» |
| Respuesta del usuario en texto | Botón A / B / Otro o Ok / No más comentario |
| Resuelto | Una línea en la sección «Confirmado» |
Qué mostrar visualmente
Cada pregunta de la ronda es exactamente un bloque de uno de los cuatro tipos. Elige el tipo más simple que corresponda: un maqueta cuesta más que una línea de texto, y las imágenes adicionales estorban la lectura.
| Tipo | Cuándo | Qué contiene | Botones |
|---|---|---|---|
ui | Pregunta sobre cómo se ve una pantalla o cómo se navega en ella: disposición, botones, navegación, orden de pasos, qué se muestra dónde | Recomendación; a la izquierda A, a la derecha B (si es necesario, también C, D…); cada uno con maqueta, debajo pros y contras | A · B (· C…) · Otro |
logic | Pregunta sobre reglas, no sobre pantallas: quién hace qué, estados, plazos, precios, datos | Recomendación; tabla: aspecto · A · B (· C…) | A · B (· C…) · Otro |
ok | No hay opciones, hay una sola propuesta tuya | Texto de la propuesta | Ok · No |
plain | Ya resuelto: en el chat, en una ronda anterior, en documentos del proyecto | Una línea en «Confirmado» | — |
Todas las preguntas y todas las opciones solo en el cuestionario (regla del autor). No hagas un artefacto aparte para comparar opciones, incluso si son muchas: agrégalas a la misma pregunta como C, D, E, F (campos c…f, ver references/items.md). Normalmente bastan dos; la tercera y siguientes solo cuando el usuario pida otra opción o realmente haya más de dos.
Reglas para maquetas ui:
- Dibuja una maqueta solo cuando la diferencia entre A y B sea visible a simple vista. Si la diferencia es en palabras, es
logicook. - Muestra solo en qué se diferencian las opciones y el mínimo contexto necesario para entender dónde está eso en la pantalla. No se necesita una pantalla completa con todos los detalles.
- Dibuja A y B en el mismo marco, con los mismos datos y desde el mismo estado inicial: así el ojo solo ve la diferencia.
- Usa datos reales del proyecto: nombres, precios, términos del usuario. Lo inventado (nombres, cantidades) márcalo con
{{NOTE}}en el encabezado. - Para un escenario de varios pasos, basta una maqueta por opción: los pasos van de arriba abajo, la acción del usuario con una nota gris («hizo clic en «Carrito»»).
- Pros y contras: de 2 a 3 por opción, una línea cada uno.
- Tipo de maqueta: chat de Telegram (
tg) para bots, teléfono o navegador (htmlcon marco) para aplicaciones y sitios web. Campos y clases enreferences/items.md.
Cómo se ve el artefacto
La página es compacta y sobria: tamaño de texto normal (14 px), sin títulos grandes, márgenes pequeños, nada superfluo — sin decoración, sin tablas innecesarias, sin párrafos introductorios. Tema claro y oscuro. Todo esto ya está en la plantilla: no rediseñes, solo cambia los registros.
De arriba abajo:
- Encabezado: línea gris pequeña — a qué pertenece el panel; título «Cuestionario: »; una línea «Responde aquí directamente…»; nota opcional (
{{NOTE}}). - «Otros»: un campo de texto y un botón «Guardar» — mensaje al chat sin salir del cuestionario: pregunta, observación o solicitud que no pertenece a ninguna pregunta de abajo. El campo es de un solo uso: después de procesar la ronda, se limpia.
- «Necesita confirmación» y número de preguntas abiertas. Cada pregunta es un bloque:
- número, título, si es necesario la marca «Primero esto»;
- línea de contexto en gris, si es necesaria;
- placa verde «Recomiendo: …» (para
uiylogic); - contenido según el tipo:
ui— columnas, izquierda A, derecha B (con tercera opción, tres columnas; con cuatro o más, dos por fila), cada una con etiqueta, maqueta, debajo pros (+) y contras (−); en teléfono las columnas se apilan.logic— tabla «aspecto · A · B (· C…)».ok— texto de la propuesta; - campo de comentario;
- botones abajo: un botón por opción y «Otro» (para
ok— Ok · No). «Otro» requiere comentario.
- «Confirmado» y número de decisiones: lista numerada, cada línea con fecha y decisión en una oración; debajo de la línea en gris, el comentario del usuario si lo hubo; pequeño enlace «volver a preguntas».
Una pregunta respondida se mueve inmediatamente de la primera sección a la segunda.
Pasos
-
Preparación. Carga los skills
artifact-capabilitiesyartifact-design: la herramienta Artifact los necesita antes de publicar. CargaArtifactDatamediante ToolSearch. -
Página. El código de la página ya está listo —
assets/template.html; no escribas una página nueva, solo copia la plantilla al proyecto y llénala con preguntas a través de la base de datos. Si la carpeta está en el almacenamiento Obsidian, ponla en.code/grill/<tema>.html, de lo contrario en la carpeta del proyecto o scratchpad. Reemplaza tres marcadores:{{TITLE}}(dos lugares) — nombre del tema, 2–4 palabras, ej. «bot Coffee Shop». En la plantilla ya está precedido por «Cuestionario: » — así la página se reconoce entre otros artefactos (decisión del autor), el nombre completo será «Cuestionario: bot Coffee Shop»;{{SUBTITLE}}— a qué pertenece, ej. «Cliente Coffee Shop · Bot de Telegram»;{{NOTE}}— nota como «Nombres y cantidades en las maquetas son inventados» o una línea vacía.
No cambies nada más en el archivo. Si ya existe un panel para ese tema, trabaja con él: Artifact
readpor su URL, luegopublishconurl. -
Publicación. Artifact publish,
icon: "checklist",capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}. La reglawrite: adminsignifica que solo el propietario y los editores pueden responder; quien tenga el enlace de solo vista solo puede mirar.assetses necesario para fotos reales en las maquetas: súbelas al artefacto (asset: true) y pon la referencia/_blob/<id>en los registros. -
Ronda. Una llamada a ArtifactData
batchen la colecciónitems: un documento por cada pregunta del frente más las líneasplainpara lo ya resuelto. El orden lo define el campoorder, la pregunta más urgente se puede marcar confirst: true. -
Transferencia. Da el enlace, en un par de líneas nombra las preguntas de la ronda y pide que escriba «respondí»: la página no te notifica las respuestas. Si necesitas la respuesta de inmediato, haz la pregunta también en el chat (AskUserQuestion) y escribe la respuesta tú mismo en la base de datos — igual que lo habría hecho la página.
-
Lectura de respuestas. ArtifactData
listde la colecciónitems. Para cada registro constatus: "done"y campoanswer:a,b,ok,no— decisión tomada, la página ya escribiósummary. Si el comentario aclara la decisión, reescribesummaryen una línea de modo que contenga lo que realmente se decidió.other— lee el comentario. Si es una solución ya lista, reescribesummaryen una línea. Si es una nueva opción o una pregunta de vuelta, devuelve el registro aopencon nuevas opciones o crea una nueva pregunta.- Traslada las decisiones a donde el proyecto las guarde (tablero del proyecto, especificaciones, ADR), si existe ese lugar.
También lee «Otros» — ArtifactData
getdel documentootheren la colecciónmeta. Es el mensaje del usuario al chat: trátalo como un mensaje en el chat — responde en el chat, cumple la solicitud, escribe la decisión donde el proyecto guarda las decisiones, convierte la nueva idea en una pregunta en la siguiente ronda. Después, limpia el campo:updateconif_version,text: "", y eliminareply,replyAt,at({"__delete__": true}). No pierdas nada de eso: todo lo necesario ya está registrado en el chat, en el tablero o en las preguntas.Luego recalcula el frente y añade la siguiente ronda con el mismo
batch. -
Fin. El frente está vacío — resume brevemente el resultado y pregunta si hay entendimiento compartido.
Reglas de escritura
- Cualquier escritura en un documento existente debe usar
if_versionde la última lectura: el usuario podría haber respondido mientras trabajabas. - El campo
answeres la respuesta del usuario. No lo cambies, excepto cuando tú mismo devuelvas la pregunta a las abiertas. - Escribe corto: título hasta 8 palabras, recomendación 1–2 oraciones, línea en «Confirmado» una oración.
- El idioma de la página es el idioma del usuario. Las etiquetas de la plantilla están en ruso; para otro idioma, tradúcelas en una copia de la plantilla.
Verificación
Después de la primera publicación — una llamada a ArtifactData list (todos los registros en su lugar) y un vistazo a la página en el navegador: las maquetas se dibujan, A y B están una al lado de la otra. No presiones los botones por el usuario: esas son sus respuestas.