La habilidad /to-questionnaire

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

Qué hace

to-questionnaire convierte una decisión que no puedes resolver por tu cuenta en un cuestionario: un documento Markdown que entregas a la persona que tiene lo que te falta, para que lo rellene de forma asíncrona o para que lo trabajen juntos en una reunión.

Te interroga sobre el envío, nunca sobre el tema. Entrevistarte sobre el tema no tiene sentido aquí: no conocer el tema es por lo que escribes a otra persona. Así que pregunta las dos cosas que siempre puedes responder (a quién va dirigido, y qué necesitas que te devuelvan) y apunta cada pregunta del documento a la brecha entre ambas.

Cuándo usarla

La invocas escribiendo /to-questionnaire; el agente no la usará por su cuenta.

Úsala cuando una decisión esté bloqueada por conocimiento que vive en la cabeza de otra persona: un cliente, un experto de dominio, un directivo que posee las reglas de negocio, un colega de un equipo en el que no estás. Qué habilidad quieres depende de dónde estén realmente las respuestas:

Las respuestas están en…	Qué usar
Tu propia cabeza, sin afilar	grill-me
La base de código	grill-with-docs
La cabeza de otra persona	to-questionnaire
La cabeza de nadie aún, la pregunta necesita algo a lo que reaccionar	prototype

El caso común es una sesión de interrogatorio que se atasca: parte de lo que surgió no te toca responderlo a ti. Ejecuta /to-questionnaire en esa misma conversación para llevar esas preguntas fuera de línea, luego trae las respuestas y sigue adelante.

El envío, no el tema

La entrevista son dos intercambios, y luego se detiene.

• ¿A quién va dirigido? Su rol, su experiencia, su relación contigo. Esto fija el tono y cuánto contexto debe llevar el documento: un cliente externo necesita orientación, un compañero de equipo no.
• ¿Qué necesitas que te devuelvan? Las decisiones o hechos concretos que no puedes resolver solo. Esto se convierte en la lista de verificación contra la que se mide el documento terminado: cada elemento que nombraste recibe una pregunta dirigida a él.

Todo lo posterior es redacción. El archivo cae en to-questionnaire-<slug>.md en el directorio actual. No hay configuración, ni espacio de trabajo, ni nada que configurar.

El documento

Está enmarcado como un cuestionario de descubrimiento (te falta el contexto, el destinatario lo tiene), y ese encuadre determina su forma:

• Una línea de propósito que nombra la decisión que depende de él, y una sección breve de contexto para un destinatario que nunca estuvo en tu cabeza.
• Preguntas ordenadas de más importante primero y agrupadas bajo encabezados temáticos, porque asíncrono significa que quizá solo tengas una pasada.
• Una idea por pregunta, nunca compuestas, con un esbozo de respuesta debajo y una línea de por qué importa solo donde una pregunta pueda malinterpretarse.
• Permiso explícito para responder “No lo sé”: una incertidumbre señalada es útil; una suposición confiada que parece un hecho no lo es.
• Un cierre comodín: ¿algo que no preguntamos y deberíamos saber?

Dos cosas que deliberadamente no es. No es ramificado: las preguntas son una lista plana y agrupada, no un árbol que salta la sección D si respondiste A. Y no es multidestinatario: una ejecución produce un documento para una persona.

Preguntas comunes

¿Lee mi sesión de interrogatorio y extrae las preguntas de ella? No como un paso propio. La habilidad no tiene fase de ingesta: pregunta sobre el envío, luego redacta. Lo que la hace funcionar tras una sesión de interrogatorio es que la ejecutes en la misma conversación, así la sesión ya está en contexto y la redacción puede aprovecharla. Si la inicias en una sesión nueva no sabe nada del interrogatorio; tendrás que aportar el tema tú mismo al responder “¿qué necesitas que te devuelvan?”.

Las respuestas que faltan no están todas en la misma persona. ¿Puede dividirlas por destinatario? No. El paso uno pide el destinatario, en singular, y el tono y el contexto de todo el documento se calibran para esa persona. Si tres personas tienen tres partes de la respuesta, ejecútala tres veces, una por persona. Dirigir preguntas por disciplina o rol dentro de un solo documento es algo que la gente ha pedido; no es lo que se publicó.

¿Las preguntas son dependientes: salta secciones según respuestas anteriores? No. El diseño de preguntas dependientes se exploró y no se publicó. El resultado es un documento estático: grupos temáticos, lo más importante primero, cada pregunta activa. La objeción en contra es justa: un modelo que planifica más de dos o tres preguntas por delante de una respuesta real planifica mal, y un documento ramificado tiene que planificarlas todas por delante de cada respuesta.

¿Y si el destinatario tampoco lo sabe? El documento le dice que lo diga. “No lo sé” y las respuestas parciales se piden explícitamente, y una incertidumbre señalada vale más que una suposición, porque una respuesta vaga y una confiada pero errónea se ven idénticas una vez de vuelta en tu contexto.

¿Lo envía a algún sitio (Slack, un gestor de pendientes, correo)? No. Escribe un archivo Markdown en el directorio actual y te dice la ruta. La entrega es tuya: pégalo en un ticket, suéltalo en un hilo de Slack, adjúntalo a un correo, o ábrelo en una pantalla compartida y trabajen sobre él en vivo. La gente ha conectado las cuatro a mano.

¿No es esto solo /grill-me en modo lote? No, y vale la pena sostener la distinción. grill-me ya pregunta en rondas: toda la frontera a la vez, luego recalculada desde tus respuestas, así que la necesidad de “dame todas las preguntas a la vez” ya está cubierta allí. to-questionnaire trata de otro eje: no cómo se entregan las preguntas, sino en qué cabeza están las respuestas. Responderlas tú mismo más rápido es grill-me; sacarlas de otra persona es esto.

¿No podría pedirle esto al agente sin una habilidad? Sí, y mucha gente lo hizo antes de que existiera: archivos OPEN_QUESTIONS.md, hojas de cálculo enviadas a clientes, un ticket de “falta más información” por pregunta sin responder. La habilidad te compra dos cosas: la entrevista nunca deriva al tema, y el documento sale en una forma que un destinatario no técnico puede rellenar de verdad. Si ya tienes un formato propio que funciona, la respuesta honesta es que no necesitas esto.

Funciona si

• Pregunta sobre el destinatario y sobre lo que necesitas que te devuelvan, y luego deja de preguntar. Una pregunta sobre el tema en sí es la habilidad fuera de control.
• Cada elemento que nombraste como “lo que necesito que me devuelvan” se puede rastrear hasta una pregunta en el archivo.
• Las preguntas se leen como dirigidas a lo que el destinatario sabe, no como tus propias preguntas abiertas copiadas tal cual.
• Podrías entregar el archivo a alguien que no estuvo en la conversación y sabría por qué lo recibió y para cuándo responder.
• Las respuestas que vuelven son entrada utilizable para una nueva ronda de interrogatorio, en lugar de un nuevo conjunto de preguntas.

Dónde encaja

to-questionnaire es una habilidad independiente para usar cuando quieras. Está en el límite de tu propio conocimiento, donde el siguiente movimiento es otra persona en lugar de otra habilidad, casi siempre a mitad de flujo, cuando la planificación se ha atascado en algo que no te toca decidir a ti.

Su vecina es grill-me, y ambas se reparten según dónde vivan las respuestas: el interrogatorio te extrae a ti, un cuestionario extrae a otra persona. Lo que vuelve es materia prima: aliméntala a otra ronda de interrogatorio, o a grill-with-docs o to-spec si el trabajo va hacia una construcción. Cuando no sepas qué habilidad encaja en el momento, ask-matt te dirige.