Planning with Files: un plan que no muere con la ventana de contexto
Cuando la ventana de contexto se reinicia, el agente olvida en qué paso estaba. planning-with-files guarda el estado del trabajo en tres archivos del proyecto: task_plan.md, findings.md y progress.md. Unos hooks devuelven partes del plan en cada turno, así que tras /clear, un fallo o una compactación el agente sigue desde la fase actual.
Tres archivos: task_plan.md con fases y casillas, findings.md con notas de investigación y progress.md con el registro de sesión y tests.
Hooks al enviar un mensaje, al usar herramientas, al parar y antes de compactar reinyectan el plan y piden actualizar el progreso.
Las tareas en paralelo tienen carpetas .planning/ con fecha y nombre, y .active_plan indica cuál usa cada agente.
Regla de las dos acciones: tras cada dos lecturas, búsquedas o pasos en el navegador, el agente anota lo aprendido.
En las pruebas del propio proyecto, el plan en disco bajó la reorientación de 13,3 a 5 turnos y ganó 3 de 3 comparaciones A/B a ciegas.
Cuándo usarla
Una tarea llega a decenas de llamadas a herramientas y choca una y otra vez con /clear o la compactación.
Retomas el trabajo al día siguiente y quieres ver de un vistazo qué fase está terminada.
Varios agentes o ramas trabajan en paralelo y cada tarea necesita su propio plan.
Pídale al agente
Empieza la migración a la API v2 escribiendo un plan por fases en task_plan.md
Lee task_plan.md y progress.md y continúa desde la fase actual
Apunta en findings.md lo que descubrimos sobre el error de inicio de sesión
Preguntas
¿Cómo se instala planning-with-files?
Con npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g se instala de forma global. En Claude Code también existe como plugin con hooks.
¿Hay versión en español de planning-with-files?
Sí. La variante planning-with-files-es traduce el SKILL.md, las plantillas y los mensajes de los scripts; se instala con --skill planning-with-files-es.
¿En qué se diferencia de una herramienta de memoria para agentes?
La memoria recupera datos de sesiones pasadas; esta skill gestiona la tarea en curso: fases, estado, dependencias y la comprobación de que está terminada.
