PTENES
Saltar al contenido
MÓDULO 3.5 · MODO ENSEÑANZA

🔬 Grill-me y skills adversariales

Hay una skill de 4-5 frases que Matt Pocock llama "unreasonably effective" — increíblemente eficaz. Convierte la IA en un entrevistador adversarial que te interroga sobre tu plan hasta que ambos llegan a un entendimiento compartido. En este módulo entiendes por qué esto sustituye al «plan mode» y obtienes el texto exacto para copiar.

6
Temas
~40
Minutos
3.1-3.4
Prerreq.
Práctica
Tipo
Progreso: 0% 0 de 6

📖 Glosario vivo (los términos NUEVOS de este módulo)

La Trilha 1 ya estableció modelo, prompt, agente, skill, codebase e harness. Aquí aparecen los términos propios de grill-me. Vuelve siempre que lo necesites:

grill-me — una skill corta que te pide que la IA te "interrogar" (grill = interrogar/presionar): se convierte en entrevistadora y te hace preguntas sobre tu plan, una a la vez, hasta que estén de acuerdo en todo.
adversarial — postura en la que la IA discrepa a propósito: señala lagunas, casos que olvidaste y alternativas, en lugar de limitarse a darte la razón (el famoso «adulador» que dice que sí a todo).
plan mode — modo de muchos agentes (p. ej., Claude Code) en el que la IA primero escribe un plan y solo se ejecuta después de que lo apruebes. La grill-me es una alternativa a eso.
shared understanding — «entendimiento compartido»: el estado en el que tú y la IA ven el problema de la misma manera, sin malentendidos ocultos, antes antes de que se escriba una línea de código.
design tree — «árbol de decisiones de diseño»: el conjunto de elecciones de un proyecto, en el que una decisión depende de otra (ramas). grill-me recorre las ramas una por una.
PRD — Product Requirements Document, documento de requisitos del producto: el texto que describe lo que se va a construir. Suele ser el resultado de una buena sesión de grill-me (lo verás en el 3.6).
1

🔥 Qué hace grill-me

🧠 Imagínalo así: vas a defender una idea ante un comité. En vez de alguien que sonríe y aprueba todo, se sienta frente a ti un entrevistador exigente que pregunta «¿y si el usuario hace X?», «¿por qué no usar Y?», «¿qué pasa cuando esto falla?». Sales de la sala con una idea más sólida, porque los puntos débiles aparecieron antes, no después. grill-me convierte a la IA precisamente en ese entrevistador.

A grill-me es una skill que hace una sola cosa: transforma el modelo en un entrevistador adversarial. En vez de que des una orden y la IA obedezca, la relación se invierte: ella pregunta, tú respondes. Hace preguntas, plantea ideas que no habías considerado, señala dependencias entre las decisiones y sigue así hasta que ambos llegan a un shared understanding sobre lo que se va a hacer.

Pocock describe esta skill como "unreasonably effective" — increíblemente eficaz para algo tan pequeño. El porqué es simple: los modelos modernos tienden a ser demasiado complacientes. Si dices "mi idea es X", la IA tiende a elogiarla y seguir adelante, aunque X tenga un gran problema. La grill-me rompe ese hábito a propósito: le ordena a la IA discrepar, encontrar lo que falta y confrontarte. Error común: creer que esto es solo "la IA haciendo preguntas". La diferencia está en la actitud —adversarial, no aduladora— y en la disciplina de hacer una pregunta a la vez (verás por qué en el tema 3).

FLUJO NORMAL tú IA ordena GRILL-ME (invertido) IA entrevistadora tú interroga preguntas adversariales, una por vez → hasta lograr un entendimiento compartido

El flujo normal: tú indicas y la IA hace. grill-me lo invierte: la IA pregunta y tú aclaras.

Ilustración conceptual: la IA en la silla de una entrevistadora exigente, haciendo preguntas incisivas sobre un plan

⚠️ Error común de principiante

Confundir grill-me con un «modo de lluvia de ideas adorable». Si la IA está de acuerdo con todo lo que dices, la skill no está funcionando. Todo el valor viene de la postura adversarial: tiene que confrontarte, no halagarte.

En 1 frase: grill-me = la IA se convierte en entrevistadora adversarial y te interroga sobre el plan hasta que estén de acuerdo en todo.

Profundiza (opcional): ¿por qué «grill»?

En inglés, to grill someone es una expresión coloquial para "interrogar con firmeza", como un detective o un reportero que no suelta a su presa. La palabra viene de "asar a la parrilla": dejar a la persona "sobre el fuego" hasta que aparezca la verdad. El nombre de la skill expresa esa intención a propósito: no es una conversación amena, sino un interrogatorio productivo sobre tu propio plan.

2

🔄 Sustituir el modo plan

🧠 Imagínalo así: dos maneras de planear un viaje. En la primera, la agencia te entrega un itinerario listo y tú solo dices "ok"; pero si entendió mal tu destino, solo te das cuenta en el aeropuerto. En la segunda, la agencia te entrevista antes («¿prefieres playa o montaña? ¿viajas con niños? ¿cuál es el presupuesto?») y el itinerario nace ya alineado. La técnica grill-me es la segunda forma.

Muchos agentes tienen un plan mode: la IA lee tu pedido, escribe un plan y espera a que lo apruebes antes de modificar el codebase. Es útil, pero tiene un fallo: el plan es un monólogo. La IA adivina qué quisiste decir y escupe un documento. Si entendió mal un detalle al principio, todo el plan queda torcido, y solo te das cuenta al releerlo todo.

Pocock usa grill-me en su lugar del plan mode. Su frase lo resume bien: "esta es mi idea, entrevístame, lleguemos a un entendimiento compartido, saquemos a la luz lo extraño antes de implementar" — esta es mi idea, entrevístame; lleguemos a un entendimiento compartido y saquemos a la luz las peculiaridades antes de implementar. La diferencia clave: el plan mode es la IA suponiendo; la grill-me es la IA preguntando. En vez de un plan que puede estar equivocado, construyes el entendimiento en conjunto, mediante el diálogo. El porqué es que los malentendidos cuestan caro: una suposición equivocada se convierte en código equivocado y luego en retrabajo.

PLAN MODE — monólogo pedido plan error solo aquíal final GRILL-ME — diálogo P: ¿y si…? R: entonces… P: ¿por qué…? R: porque… ✓ alineado antes de programar

Recuperación rápida: ¿cuál es la diferencia central entre plan mode y grill-me?

En 1 frase: el plan mode es la IA suponiendo el plan por sí sola; grill-me es ustedes construyendo la comprensión en diálogo, antes de programar.

3

✂️ Breve y poderosa (4-5 frases)

🧠 Imagínalo así: una buena instrucción de un jefe no tiene 10 páginas. Tiene tres líneas precisas: «llama a cada cliente, uno por uno, y antes de cada llamada dime qué recomiendas». La grill-me es así: diminuta, pero cada frase contiene una regla de comportamiento que lo cambia todo.

La grill-me cabe en 4-5 frases. Cada frase es una regla deliberada: no es texto decorativo, sino una instrucción densa. Fíjate en cómo cada parte cumple una función: "entrevístame sin descanso... hasta que lleguemos a un entendimiento compartido" define el objetivo (entrevistar sin parar hasta lograr el alineamiento). "Walk down each branch of the design tree, resolving dependencies between decisions one-by-one" da el método: recorrer la design tree rama por rama. "Para cada pregunta, proporciona tu respuesta recomendada" exige que la IA no solo pregunte, sino que también recomienda su respuesta (para que tengas un punto de partida).

Las dos últimas frases son el truco clave. "Ask the questions one at a time" — una pregunta a la vez. Sin esto, la IA te lanza 12 preguntas de golpe y te pierdes; de una en una, mantienes el enfoque y cada respuesta puede influir en la siguiente pregunta. Y "si una pregunta se puede responder explorando el código base, explora el código base en su lugar" — si la IA puede responder consultando el código, lo consulta en vez de preguntarte. Así evita interrogarte sobre cosas que puede averiguar por sí misma. El error común aquí es «mejorar» la skill inflando el texto: cuanto más agregas, más se diluye el comportamiento. La fuerza está en la concisión. A continuación, el texto exacto para copiar:

grill-me.md — el texto exacto de la skill
Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer. Ask the questions one at a time. If a question can be answered by exploring the codebase, explore the codebase instead.

Traducción libre: "Entrevístame sin descanso sobre cada aspecto de este plan hasta que lleguemos a un entendimiento compartido. Recorre cada rama del árbol de decisiones y resuelve las dependencias entre decisiones una por una. Para cada pregunta, dame tu respuesta recomendada. Haz las preguntas de una en una. Si una pregunta se puede responder explorando el codebase, explóralo en lugar de preguntar."

frase 1objetivo:hasta que se alineen frase 2método: ramapor rama frase 3ella recomiendala respuesta frase 4una preguntapor vez frase 5¿se puede ver en el código?explora, no preguntes

Cinco frases, cinco reglas. Morado = las que más cambian el comportamiento.

Ilustración: una instrucción breve y densa que irradia poder, cada frase como un filamento luminoso

En 1 frase: son 4-5 frases, cada una una regla — no infles el texto, la fuerza está en la concisión.

4

🎯 Alinear antes de programar

🧠 Imagínalo así: un carpintero experimentado mide dos veces y corta una. Medir cuesta minutos; cortar mal cuesta una tabla perdida y horas de retrabajo. grill-me es tu cinta métrica antes del corte: dedicas unos minutos a responder preguntas para no desperdiciar una hora escribiendo código equivocado.

La principal ventaja de grill-me es trasladar la alineación a antes de la implementación. La frase de Pocock — "sacar a la luz lo extraño antes de implementar" — es literalmente eso: exprimir las rarezas antes de implementar. Toda decisión mal entendida que se convierte en código sale cara: la IA escribe, tú revisas, te das cuenta de que no era exactamente eso, le pides que lo rehaga y lo rehace. Cada ciclo de estos consume tiempo y tokens. grill-me corta estos loops de raíz, porque la comprensión ya está cerrada cuando empieza el código.

También hay un efecto secundario valioso: al responder las preguntas, tú también descubre agujeros en tu propio razonamiento. Muchas veces creemos tener una idea clara, pero solo queda clara cuando alguien pregunta «¿y en este caso?». La grill-me te obliga a pensar en los detalles que pasaste por alto. Por eso es buena incluso cuando la IA no vas a escribir el código al final; solo con pasar por la entrevista, tu plan mejora.

🔬 Ejemplo resuelto: grill-me en una feature de "exportar informe"

Le dices a la IA: "quiero agregar un botón para exportar el informe en PDF" y activa grill-me. Mira la entrevista (una pregunta por vez, con recomendación):

  1. IA: "¿El PDF se debe generar en el servidor o en el navegador?" Recomiendo en el servidor, para controlar la fuente y no depender del navegador del usuario». — Tú: "servidor."
  2. IA: "¿Y cuando el informe esté vacío — botón deshabilitado o PDF con un aviso?" Recomiendo deshabilitar, es más claro». — Tú: "PDF con aviso, el cliente quiere un registro."
  3. IA: "Vi en el codebase que ya usan la lib" pdfkit en /reports. ¿La reutilizo? Recomiendo reutilizar." — Tú: "sí." (exploró el código en vez de preguntar desde cero)

Resultado: en 3 preguntas definiste la generación en el servidor, el comportamiento del estado vacío y la reutilización de la lib — tres decisiones que, descubiertas en medio del código, costarían rehacer trabajo.

SIN grill-me — ciclos costosos programar revisar rehacer hace perder tiempo y tokens, una y otra vez CON grill-me — alinear antes entrevista programar rarezas comprimidas antes ✓ sin ciclo de retrabajo

Sin grill-me, el error solo aparece al final y se convierte en un ciclo de retrabajo; con ella, la alineación llega antes que el código.

Ilustración: medir dos veces y cortar una — alineación luminosa antes de ejecutar el código

En 1 frase: unos minutos de entrevista al principio ahorran horas de código equivocado después.

5

🤝 Entendimiento compartido

🧠 Imagínalo así: dos músicos afinando antes del concierto. El concierto aún no empieza: es el momento en que ambos tocan la misma nota hasta sonar en armonía. Solo después de afinar, tocan. "Shared understanding" es esa afinación entre tú y la IA.

El destino de grill-me tiene nombre: shared understanding. Es el estado en el que tú y la IA ven el problema de la misma manera, sin suposiciones ocultas a punto de estallar. La entrevista no termina cuando la IA se cansa; termina cuando el entendimiento converge. Por eso la skill dice "until we reach a shared understanding": el criterio para detenerse es la alineación, no una cantidad fija de preguntas.

David (el colega de Pocock en la transcripción) tiene una variación muy usada del mismo principio: "describe my vision, list out the 10 most consequential decisions (software design / architectural / product) that will shape this project, and interview me until you understand 98%." — describe mi visión, enumera las 10 decisiones más importantes que darán forma al proyecto y entrevístame hasta entender el 98 %. Fíjate en la ingeniería: obligar a la IA a listar las 10 decisiones más importantes garantiza que la entrevista se enfoque en lo que importa, no en detalles triviales; y el "98%" da una meta concreta de convergencia. Es de la misma familia que grill-me: adversarial, en diálogo, hasta lograr la alineación. Verás este prompt completo, listo para copiar, en el módulo 5.2 de la ruta de Soluciones.

tu visión visión de la IA rondas de preguntas → 98%?98%? SHARED UNDERSTANDING una sola visión: ahora ya puedes programar

En 1 frase: el criterio para detenerse no es el número de preguntas: es que ambos vean lo mismo.

6

🛠️ Adaptar para ti

🧠 Imagínalo así: una receta básica de pan. Funciona para todos, pero cada panadero ajusta la sal, la hidratación y el tiempo de horno según su horno. La grill-me es la receta básica: cópiala, úsala durante una semana y recién entonces dale tu toque.

La grill-me es un punto de partida, no un dogma. Como ella es solo una skill de texto, puedes guardarla en tu proyecto y adaptarla. Recuerda la regla de oro del tema 3: ajusta con moderación, porque inflarla diluye. Algunos ajustes que puedes hacer sin arruinar el efecto: pedir un resumen de lo entendido al final («cuando terminemos, escribe un párrafo sobre lo que acordamos»); limitar el alcance («enfócate solo en las decisiones de arquitectura»); o definir un tope («máximo 8 preguntas»). Pero empieza copiando el texto exacto — desarrolla la intuición antes de cambiarlo.

Vale la pena recordar la filosofía de Pocock que atraviesa toda la ruta: él prefiere procedures y quieres estar al volante — "I know my skills, I don't want to delegate my thinking" (conozco mis skills, no quiero delegar mi pensamiento). grill-me encaja perfectamente con eso: no te quita el control, te afila tu comando. Y es el primer eslabón de una cadena que vas a construir en el próximo módulo: grill-me → PRD → issues. En vez de volcar todo de una vez, usas la grill-me para alinearte, conviertes esa alineación en un PRD, y el PRD en tareas, siempre contigo al volante.

Para profundizar (opcional): grill-me vs. «superpowers» (el modelo al mando)

En la transcripción, Pocock contrasta su estilo con el del proyecto «superpowers» (Obra), que prefiere lo opuesto: el modelo al mando, con la IA decidiendo el camino. Pocock está en el extremo de humano al mando: oculta la mayoría de las descripciones de la IA y mantiene el conocimiento en manos de la persona. Grill-me expresa esa elección: la IA pregunta, pero quien decide eres tú. No existe una opción universalmente «correcta»; depende de quién quieres que lleve el volante. Como principiante, empezar con el control humano suele enseñar más.

Recuperación rápida: ¿qué ajuste en la grill-me es arriesgado, según el módulo?

En 1 frase: copia primero el texto exacto, adquiere la intuición y solo entonces dale tu toque con moderación.

🧾 Resumen del módulo

✓
grill-me = entrevistador adversarial — la IA pregunta, señala fallas y te confronta, en vez de halagarte.
✓
Reemplaza el plan mode — diálogo (preguntas) en lugar de monólogo (plan supuesto).
✓
4-5 frases, cada una una regla — de una en una; recomienda la respuesta; explora el código cuando puede.
✓
Para en shared understanding — alinearse antes de programar ahorra horas de retrabajo.

Próximo módulo:

3.6 — Encadenar skills + DRY humano: cómo conectar grill-me → PRD → issues en un pipeline de pensamiento, contigo al volante.