Repolode
Enviar
OthmanAdi

OthmanAdi/planning-with-files

Una skill de planificación basada en archivos para agentes de programación con IA, que guarda los planes en disco para que sobrevivan a los reinicios del contexto, /clear y los fallos.

Ver en GitHubSitio web
Estrellas
27,923
Forks
2,313
Issues abiertos
11
Último commit
hace 3 días

¿Qué es?

Planning with Files es una skill para agentes de programación con IA que guarda el plan de una tarea, las notas de investigación y el progreso en tres archivos Markdown dentro del proyecto: task_plan.md, findings.md y progress.md. Como el estado se guarda en disco en lugar de en la ventana de contexto, un agente puede retomar la tarea en la fase actual después de /clear, de la compactación del contexto o de un fallo.

Los hooks del ciclo de vida vuelven a inyectar el contexto del plan activo al inicio de cada turno, y una comprobación de finalización indica si se han completado todas las fases del plan. Las tareas paralelas pueden usar directorios separados dentro de .planning/, seleccionados mediante un puntero al plan activo. La recuperación automática solo lee archivos del proyecto; para leer los registros locales de sesiones del agente se requiere activar explícitamente el modo catchup.

La skill se instala mediante npx skills, el marketplace de plugins de Claude Code o npm, y cuenta con integraciones nativas de plugins para Claude Code, Codex CLI, Cursor, OpenCode, Hermes Agent y otros, además de variantes traducidas a varios idiomas.

Funciones clave

  • 01Guarda el plan, los hallazgos y el progreso como archivos Markdown en el proyecto
  • 02Vuelve a inyectar el plan activo en cada turno mediante hooks del ciclo de vida
  • 03Recupera el plan después de /clear, la compactación del contexto o fallos de sesión
  • 04Una comprobación de finalización indica si se han completado todas las fases del plan
  • 05Directorios de planes aislados para tareas paralelas
  • 06Se instala en muchos agentes de programación mediante el estándar Agent Skills

Casos de uso

  • Refactorizaciones o migraciones de larga duración que abarcan varias sesiones
  • Tareas de programación de varios pasos en las que el agente no debe perder el hilo después de /clear
  • Mantener un registro auditable de las decisiones y los resultados de las pruebas durante el trabajo del agente

En colecciones

Herramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open sourceAsistentes y agentes de programación con IABibliotecas de skills para agentes de IA

Temas

#agent-skills#ai-agents#claude-code#context-engineering#planning#llm-agents#coding-agent#autonomous-agents#claude#claude-code-skills

Preguntas frecuentes

¿Qué es planning-with-files?
Una skill de planificación basada en archivos para agentes de programación con IA, que guarda los planes en disco para que sobrevivan a los reinicios del contexto, /clear y los fallos. Planning with Files es una skill para agentes de programación con IA que guarda el plan de una tarea, las notas de investigación y el progreso en tres archivos Markdown dentro del proyecto: task_plan.md, findings.md y progress.md. Como el estado se guarda en disco en lugar de en la ventana de contexto, un agente puede retomar la tarea en la fase actual después de /clear, de la compactación del contexto o de un fallo.
¿planning-with-files es gratuito? ¿Qué licencia tiene?
planning-with-files es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿planning-with-files sigue mantenido?
Mantenimiento activo. El último commit de planning-with-files fue el 4 nov 2026.
¿Para qué puedo usar planning-with-files?
Refactorizaciones o migraciones de larga duración que abarcan varias sesiones Tareas de programación de varios pasos en las que el agente no debe perder el hilo después de /clear Mantener un registro auditable de las decisiones y los resultados de las pruebas durante el trabajo del agente
¿Dónde consigo planning-with-files?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/OthmanAdi/planning-with-files

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados