📖 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:
🔥 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).
El flujo normal: tú indicas y la IA hace. grill-me lo invierte: la IA pregunta y tú aclaras.
⚠️ 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.
🔄 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.
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.
✂️ 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:
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."
Cinco frases, cinco reglas. Morado = las que más cambian el comportamiento.
En 1 frase: son 4-5 frases, cada una una regla — no infles el texto, la fuerza está en la concisión.
🎯 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):
- 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."
- 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."
- IA: "Vi en el codebase que ya usan la lib"
pdfkiten/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, 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.
En 1 frase: unos minutos de entrevista al principio ahorran horas de código equivocado después.
🤝 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.
En 1 frase: el criterio para detenerse no es el número de preguntas: es que ambos vean lo mismo.
🛠️ 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
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.