La habilidad /grilling

Fuente: The /grilling Skill — traducción comunitaria no oficial al español.

Qué hace

grilling es el bucle de entrevista que somete a prueba un plan, una decisión o una idea antes de que alguien actúe. Mapea el tema como un árbol de diseño: cada decisión se ramifica en las decisiones que cuelgan de ella, y te entrevista rama por rama hasta que nada queda silenciosamente asumido.

No hace una pregunta a la vez, y no pregunta todo a la vez. Cada ronda pregunta toda la frontera: cada decisión cuyos prerrequisitos ya están acordados, y nada más. Dos preguntas nunca comparten una ronda si una depende de la otra; una pregunta que depende de una respuesta aún abierta pertenece a una ronda posterior. Tus respuestas acuerdan decisiones, la frontera se mueve hacia afuera, y la siguiente ronda pregunta lo que eso desbloqueó. Trece preguntas típicamente caen en unas tres rondas en vez de trece.

Cuándo usarla

Escribe /grilling, o el agente la usará por su cuenta cuando una tarea encaje. Es la única habilidad en la familia de interrogatorio que es invocada por el modelo, por eso rara vez la escribes: normalmente una habilidad que sí escribiste la está ejecutando por ti.

Escribir /grilling directamente te da la entrevista simple y nada más. Donde quieres algo más que eso:

Lo que tienes	Usa
No estás trabajando en un directorio de trabajo	grill-me: la misma sesión, bajo un nombre que el agente nunca disparará por sí mismo
Estás en un directorio de trabajo	grill-with-docs: la misma sesión, y escribe CONTEXT.md y ADRs a medida que avanza
Un esfuerzo demasiado grande para caber en una sesión	wayfinder: traza un mapa y ejecuta interrogatorio dentro de los tickets de decisión
Una pregunta que hablando no se puede resolver: cómo debería verse o sentirse algo	prototype: construye la versión desechable, luego vuelve
Una habilidad propia que necesita una entrevista	Invoca /grilling desde ella, en vez de escribir otra entrevista

La ronda, la frontera, y quién decide

Tres ideas sostienen toda la habilidad.

El árbol de diseño es el modelo del tema: decisiones con decisiones colgando de ellas. La frontera es el conjunto de decisiones cuyos prerrequisitos están todos acordados: las únicas preguntas que honestamente se pueden hacer aún. Una ronda es una frontera, preguntada en pleno y respondida en pleno.

Dentro de una ronda cada pregunta llega en una forma fija: numerada y titulada tras un ❓, luego el cuerpo, luego la respuesta recomendada del agente sola en una línea ➡️. Eso es lo que hace una ronda respondible por número («1 sí, 2 la segunda opción, 3 no, por esto») en vez de citando preguntas de vuelta. El formato tiene una aspereza conocida: la recomendación a veces argumenta contra la pregunta tal como se formuló, así que estar de acuerdo con la recomendación significa responder «no» a la pregunta. Cuando eso pase, responde a la recomendación y dilo.

La otra mitad del diseño es la división entre hechos y decisiones. Los hechos son trabajo propio de la habilidad: cuando una pregunta de frontera necesita algo que el entorno puede resolver, despacha un subagente a averiguarlo en vez de preguntarte a ti. No se bloquea por eso; solo las preguntas aguas abajo de una exploración en curso esperan. Las decisiones son tuyas, y debe esperarlas. Un agente ejecutando grilling que responde sus propias decisiones ha roto la habilidad, no la ha interpretado con libertad. La sesión termina cuando la frontera se vacía, y no actuará sobre lo acordado hasta que confirmes que llegaron a un entendimiento compartido.

El límite honesto: la frontera es el juicio del agente, no un grafo computado. Puede poner dos preguntas en una ronda y solo después descubrir que una respuesta debería haber cambiado la otra. No hay guarda contra eso más que decírselo, lo que reabre la rama afectada en la siguiente ronda.

Qué vive aquí y qué vive en los envoltorios

Esta página cubre el mecanismo. Las cosas que la gente más quiere están documentadas un nivel más arriba.

Pregunta	Dónde se responde
El árbol, la frontera, las rondas, el formato de pregunta, hechos vs decisiones	Aquí
Cuánto debería durar una sesión, qué hacer con una pregunta que no puedes responder hablando, cómo evitar asentir a todo	grill-me
Qué se escribe en CONTEXT.md, qué se vuelve ADR	grill-with-docs

Preguntas frecuentes

¿Puedo volver a una pregunta a la vez? Sí, y una gran parte de la audiencia lo hace. Añade esto a tu CLAUDE.md global:

When grilling, ask one question at a time.

La predeterminada por rondas es genuinamente discutida. Practicantes que leen lento, que trabajan en un segundo idioma, o que usan el formato secuencial como andamio de foco reportan que el ritmo de una a la vez es mejor para ellos, y el opt-out está soportado y no solo tolerado.

¿A dónde fue /batch-grill-me? A esta habilidad. El preguntar por rondas se publicó brevemente como una habilidad separada, luego se mudó al propio grilling, así todo lo construido sobre el primitivo (grill-me, grill-with-docs, triage, wayfinder) lo recibió a la vez. No hay batch-grill-me que instalar, ni habilidad secuencial separada tampoco; la línea de CLAUDE.md de arriba es el camino de vuelta a una a la vez.

Preguntar una ronda entera a la vez debe perder las preguntas que mis respuestas anteriores habrían planteado. ¿No? Esta es la objeción más común al diseño por rondas, y la frontera es la respuesta: una ronda solo contiene preguntas que no dependen entre sí, así que ninguna respuesta en una ronda puede invalidar otra pregunta de esa ronda. Las respuestas igual remodelan todo aguas abajo: la siguiente ronda se recomputa, no viene preescrita. Lo que pierdes es menor de lo que «todo a la vez» implica, y mayor que nada: ver el límite de la frontera más arriba.

Se quedó sin preguntas y empezó a construir. Una compuerta de confirmación existe precisamente para esto: la habilidad no termina cuando la frontera se vacía, termina cuando dices que el entendimiento es compartido. Los modelos más débiles y rápidos igual la rompen; esto se reporta más en modelos de menor esfuerzo o no frontera, que colapsan «entrevista hasta entendimiento compartido» en un par de preguntas y un esquema. Si el tuyo lo hace, la corrección confiable es una línea en tu propio AGENTS.md o CLAUDE.md que diga al agente que no implemente sin permiso.

Respondió sus propias preguntas en vez de preguntarme. Eso es un error en la ejecución, no el comportamiento previsto, y fue la razón por la que hechos y decisiones se separaron en el texto de la habilidad. Aparece más cuando otra habilidad ejecuta grilling dentro de un marco de resuelve-este-ticket, donde la tarea circundante se lee como licencia para seguir avanzando. La misma restricción es por qué no hay modo async: la gente ha pedido una variante que lea un issue de GitHub y publique un memo consolidado de decisiones, y eso es una habilidad distinta, porque una sesión de interrogatorio que nadie responde ha producido la opinión del agente y no la tuya.

¿Puedo topar el número de preguntas? No, y un tope está deliberadamente fuera de alcance. Algunos planes necesitan tres preguntas y otros cincuenta; un techo fijo o trunca el caso difícil o se siente arbitrario en el fácil. Dirigir en lenguaje simple es el control previsto: dile que cierre, o detente y acepta el plan donde está. Si una sesión se alarga mucho, la causa suele ser que el alcance era demasiado grande; divide el trabajo e interroga las piezas.

Instalé grill-me sola y no pasa nada. grill-me es una habilidad de una línea cuyo cuerpo entero es «ejecuta una sesión /grilling», así que necesita esta habilidad instalada también. Lo mismo vale para grill-with-docs, que además necesita domain-modeling. Instalar el conjunto completo evita el problema; instalar selectivamente significa instalar también los primitivos.

grill-with-docs corrió, pero nunca cargó grilling. Una aspereza real y sin corregir, reportada en varios harnesses y modelos: una habilidad que nombra a otra habilidad no causa de forma confiable que esa habilidad cargue, y grill-with-docs nombra dos. La señal es una sesión que pregunta todo a la vez sin recomendaciones adjuntas: eso es el modelo improvisando una entrevista en vez de ejecutar esta. Preguntar al agente directamente si cargó grilling y domain-modeling suele recuperarla.

Funciona si

• Una ronda llega como lista numerada, cada pregunta con su recomendación en una línea ➡️ separada, y puedes responder toda la ronda por número.
• Nada en una ronda necesita que otra pregunta de la misma ronda se responda primero.
• Las rondas posteriores preguntan cosas que la primera ronda no podría haber preguntado.
• Va y busca los hechos (leyendo archivos, despachando un subagente) en vez de preguntarte algo que podría haber averiguado.
• La investigación corriendo en fondo no detiene la ronda; solo las preguntas que dependen de ella esperan.
• Se detiene al final y te pide confirmar que el entendimiento es compartido, en vez de empezar el trabajo.
• El conteo de preguntas se mantiene alto mientras el conteo de rondas se mantiene bajo.

Dónde encaja

grilling es un primitivo, no un paso que agendas: la única fuente de verdad para la técnica de entrevista, guardada en un lugar para que cada habilidad que necesita una entrevista la use en vez de inventar una. grill-me y grill-with-docs son sus dos puertas de entrada invocadas por el usuario, y grill-with-docs es donde empieza la cadena principal de construcción, antes de to-spec. wayfinder la ejecuta para resolver tickets de decisión, triage para interrogar un informe vago hasta volverlo trabajable, e improve-codebase-architecture para recorrer el árbol una vez que elegiste un candidato a profundizar. Cuando no sabes qué punto de entrada encaja, ask-matt te enruta.