¿Qué hace m_plan — Solicitud a documento de planificación?
No implementa. El objetivo es crear un plan tan concreto que otro agente pueda seguirlo al pie de la letra para implementar.
Entrada
- Si el argumento pasado junto con el skill es una ruta de archivo existente, el contenido de ese archivo es la solicitud. De lo contrario, todo el argumento (incluyendo múltiples líneas) es la solicitud.
- Si no hay argumento, pregunta qué se quiere desarrollar.
Procedimiento
- Comprender: Lee la solicitud y revisa el código y documentos existentes relevantes (
AGENTS.md,plan/README.md, código reutilizable). - Asignar ID: Elige una abreviatura de 3 letras mayúsculas en inglés que represente mejor el contenido del plan (ej.
FKS= Foreign film Korean Subtitle). Verifica duplicados enplan/README.md. - Validar supuestos: Confirma con experimentos cortos cualquier premisa técnica incierta de la que dependa el plan (existencia de opciones CLI, accesibilidad a sitios/API externos, tiempos de respuesta, etc.). Anota los resultados y la fecha en el plan. No planificar basándose en suposiciones.
- Redactar: Crea
plan/<ID>_plan_<agente>-<modelo>.mdcon la plantilla siguiente (la autoría se toma deAGENTS.md), y añade una fila| <ID> | <nombre del plan> | Planificando |a la tabla de índice enplan/README.md. - Confirmar decisiones: Escribe los puntos que requieren decisión como
<ID>-Q1,<ID>-Q2… y pregunta al usuario uno a la vez.- Para cada pregunta, ofrece 2-3 opciones, con
(recomendado)y el motivo para la recomendada. - Si el usuario da una respuesta que no está entre las opciones, verifica mediante un experimento si es factible, informa el resultado y lo incorpora.
- Al recibir respuesta, márcala con
✅y actualiza el texto correspondiente del plan según esa decisión.
- Para cada pregunta, ofrece 2-3 opciones, con
- Finalizar: Cuando todas las decisiones estén confirmadas, cambia el estado del índice a
Plan confirmado (antes de implementar)y pregunta si se desea hacer commit. Indica que el siguiente paso es/m_impl <ID>.
Plantilla (plan/<ID>_plan_<agente>-<modelo>.md)
# [<ID>] <Nombre del plan>
## 1. Objetivo
<Qué y por qué. Indicar también lo que está fuera del alcance>
## 2. Flujo general
<Orden de procesamiento/prioridades. Diagrama si es necesario>
## 3. Detalle por pasos
### 1) <Paso>
- <Método concreto, comandos/API/formato a usar, comportamiento en caso de fallo>
## 4. Módulos comunes
<Partes compartidas por varios pasos: formatos de entrada/salida, llamadas a herramientas externas, caché, manejo de errores>
## 5. Estructura de implementación
- Archivos, código existente a reutilizar, principios de dependencias, método de configuración
- Borrador de CLI/uso
## 6. Decisiones
- **<ID>-Q1** <Pregunta> — Opciones … (si está confirmado: `✅ <decisión>`)
## 7. Hitos
| # | Contenido | Criterio de finalización |
| :--- | :--- | :--- |
| <ID>-M1 | … | <Criterio verificable> |