Planifica con IA usando grill-with-docs y wayfinder

Pedirle a una IA que «añada suscripciones» deja bastantes preguntas abiertas: qué incluye cada tarifa, cuándo cambia el acceso o qué ocurre al cancelar. Resolverlas mientras se programa puede obligar a rehacer trabajo. Las skills de planificación de Matt Pocock, disponibles en AI Hero, proponen dedicarles una conversación antes de empezar.

Concreta el plan con grill-with-docs

grill-with-docs convierte esa conversación en una entrevista sobre el proyecto. El agente plantea preguntas por rondas para precisar el plan y acordar qué significan sus términos. Las definiciones se guardan en GLOSSARY.md; las decisiones que cumplen sus criterios se documentan mediante ADR, registros que explican una decisión de arquitectura y sus motivos.

Hay un límite importante: el glosario no contiene toda la planificación. Para generar un ADR, una decisión debe ser difícil de revertir, resultar sorprendente sin contexto e implicar una contrapartida real. Otros acuerdos pueden quedarse en el chat. Por eso, conviene convertir después la conversación en una especificación con /to-spec. Así funciona grill-with-docs.

Organiza las decisiones con wayfinder

wayfinder entra cuando las decisiones ya no caben en una sesión. Organiza el trabajo mediante un mapa que enlaza preguntas pendientes, decisiones resueltas y dependencias. Cada sesión puede recuperar el contexto necesario sin repasar toda la conversación anterior. Guía de wayfinder.

Sus preguntas pueden resolverse mediante una entrevista, una investigación, un prototipo o una tarea previa que desbloquee la decisión. Por defecto, su cometido termina al aclarar el camino; la implementación viene después. También deja sin concretar las preguntas que todavía dependen de respuestas anteriores, en lugar de convertirlas prematuramente en tareas. Definición de la skill.

Imagina una web de cursos. Para definir qué significa «curso completado», una entrevista puede bastar. Si además hay que decidir pagos, permisos de profesores y migración de alumnos, un mapa permite ordenar esas preguntas. Primero habría que acordar, por ejemplo, qué acceso conserva un alumno antiguo; después se podrá definir cómo migrar su cuenta.

Puedes empezar por cualquiera de las dos según el alcance. Si la entrevista inicial crece demasiado, puedes pasar a wayfinder. Si el proyecto ya exige varias sesiones, puedes arrancar directamente con el mapa y resolver sus preguntas mediante entrevistas. Cuándo elegir cada una.

Instala las skills

Para instalarlas, AI Hero ofrece este comando para el conjunto completo de skills:

npx skills@latest add mattpocock/skills

Después se invocan con /grill-with-docs o /wayfinder en el agente compatible. La primera necesita también grilling y domain-modeling; instalarla aislada no basta. wayfinder utiliza el gestor de incidencias configurado y puede recurrir a archivos Markdown locales. Instalación y dependencias, configuración del mapa.

Antes de pasar al código, revisa qué acuerdos quedaron documentados y cuáles siguen únicamente en la conversación.