aitormf/agent-skills

Divide un plan técnico aprobado en tareas pequeñas, ordenadas por dependencias, con archivos afectados, verificación por tarea y grupos paralelos. Úsalo cuando haya un plan y alguien pida desglosarlo en tareas o prepararlo para la implementación.

¿Qué es agent-skills?

Esta habilidad está diseñada para agentes de IA (como Claude Code, Cursor, Codex) que necesitan desglosar un plan técnico aprobado en una lista de tareas ejecutables. Su propósito principal es tomar un archivo `plan.md` con estado `approved` y generar un `tasks.md` estructurado, donde cada tarea sea un cambio pequeño y verificable que mantenga el proyecto en estado funcional. La habilidad soporta la identificación de dependencias, marcando tareas paralelas con `[P]`, y exige que cada tarea especifique los archivos que modifica, el comando de verificación (pruebas unitarias, de integración, etc.) y que se alinee con los criterios de aceptación de la especificación. Si el proyecto usa TDD, las pruebas deben preceder al código o estar en la misma tarea. La salida es un borrador de `tasks.md` que se escribe solo tras la aprobación del usuario, y se sugiere como siguiente paso la implementación con un agente `implement`. Es útil para desarrolladores y equipos que trabajan con agentes de IA en flujos estructurados de planificación y ejecución de tareas.

Compatible con~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/aitormf/agent-skills/tree/HEAD/skills/plan-to-tasks

Documentación

Del plan a las tareas

Convierte un plan en una lista de tareas ejecutables que el agente implement pueda seguir y marcar como completadas.

Cada elemento de trabajo reside en docs/specs/<YYYYMMDD>-<tipo>-<nombre>/.
tasks.md no tiene estado: su progreso se refleja en las casillas [x].

Antes de empezar

Identifica el elemento de trabajo y lee plan.md y spec.md.
Compuerta: si el plan no tiene status: approved, detente y pregunta:

El plan está <estado>. ¿Debo continuar de todas formas, revisarlo primero con review-spec, o lo apruebas ahora?

Continúa solo con una respuesta explícita. Para un cambio pequeño sin plan, la compuerta aplica a la especificación.
Lee el comando de verificación en la sección Comandos de AGENTS.md. Si no hay ninguno, pregunta cuál es o deja la tarea de cierre con una advertencia.

Cómo dividir

Tareas pequeñas: cada una es un cambio revisable que deja el proyecto en verde.
Ordenadas por dependencias. Marca con [P] aquellas que se puedan hacer en paralelo con la anterior.
Cada tarea lista los archivos que toca, si se conocen, y cómo se verifica: qué prueba o qué comando.
Si el proyecto trabaja con TDD (CONTRIBUTING.md o AGENTS.md lo dirán), la prueba va antes que el código o en la misma tarea, nunca al final.
Cada criterio de aceptación de la especificación y cada prueba negativa de Seguridad debe estar cubierto por al menos una tarea. Si alguno no lo está, indícalo.
La fase de Cierre es obligatoria: criterios de aceptación con pruebas y el comando de verificación en verde.
No agregues trabajo que no esté en el plan. Si falta algo en el plan, plantéalo como pregunta.

Resultado

Redacta tasks.md a partir de assets/tasks-template.md.
Muestra el borrador con:
- las tareas;
- los grupos paralelos;
- los puntos de verificación;
- cualquier pregunta pendiente.
Escríbelo solo una vez que la persona lo apruebe.
Siguiente paso sugerido: implementarlo con el agente implement.