planning-with-files

name	planning-with-files
version	1.0.0
description	Planificación basada en archivos para tareas complejas. Crea task_plan.md, findings.md y progress.md. Usar para tareas multi-paso que requieren más de 5 llamadas a herramientas.
user-invocable	true
allowed-tools	["Read","Write","Edit","Bash","Glob","Grep","WebFetch","WebSearch"]

Planning with Files

Trabajar como Manus: usar archivos markdown persistentes como "memoria de trabajo en disco".

El patrón core

Context Window = RAM (volátil, limitado)
Filesystem = Disco (persistente, ilimitado)

→ Todo lo importante se escribe a disco.

Quick Start

Antes de CUALQUIER tarea compleja:

1. Crear task_plan.md — fases con criterios de aceptación
2. Crear findings.md — almacenamiento de investigación
3. Crear progress.md — log de sesión
4. Definir criterios de "listo" ANTES de escribir código
5. Re-leer el plan antes de decisiones — refresca objetivos en la ventana de atención
6. Actualizar después de cada fase — marcar completado, loggear errores

Propósito de cada archivo

Archivo	Propósito	Cuándo actualizar
task_plan.md	Fases, progreso, decisiones	Después de cada fase
findings.md	Investigación, descubrimientos	Después de CUALQUIER descubrimiento
progress.md	Log de sesión, resultados de tests	A lo largo de la sesión

Reglas críticas

1. Crear el plan primero

Nunca empezar una tarea compleja sin task_plan.md. No negociable.

2. La regla de 2 acciones

"Después de cada 2 operaciones de búsqueda/navegación, guardar hallazgos clave a archivos de texto INMEDIATAMENTE."

3. Leer antes de decidir

Antes de decisiones importantes, releer el archivo de plan.

4. Actualizar después de actuar

Después de completar una fase: marcar estado, loggear errores, anotar archivos cambiados.

5. Loggear TODOS los errores

Cada error va al archivo de plan. Construye conocimiento, previene repetición.

6. Nunca repetir fallos

if action_failed:
    next_action != same_action

Protocolo de 3 intentos

INTENTO 1: Diagnosticar y arreglar
  → Leer el error cuidadosamente, identificar root cause, aplicar fix puntual

INTENTO 2: Enfoque alternativo
  → ¿Mismo error? Método diferente, herramienta diferente

INTENTO 3: Replanteo más amplio
  → Cuestionar suposiciones, buscar soluciones, considerar actualizar el plan

DESPUÉS DE 3 FALLOS: Escalar a Juan
  → Explicar qué se intentó, compartir el error específico, pedir orientación

Test de 5 preguntas (reboot check)

Pregunta	Fuente de respuesta
¿Dónde estoy?	Fase actual en task_plan.md
¿A dónde voy?	Fases restantes
¿Cuál es el objetivo?	Goal statement en el plan
¿Qué aprendí?	findings.md
¿Qué hice?	progress.md

Cuándo usar este patrón

Usar para: Tareas multi-paso (3+ pasos), investigación, builds de proyectos, muchas llamadas a herramientas. No usar para: Preguntas simples, ediciones de un solo archivo, lookups rápidos.

Anti-patrones

No hacer	Hacer en cambio
Definir objetivos una vez y olvidarlos	Re-leer el plan antes de decisiones
Ocultar errores y reintentar silenciosamente	Loggear errores al archivo de plan
Empezar a ejecutar de inmediato	Crear archivo de plan PRIMERO
Repetir acciones fallidas	Rastrear intentos, mutar el enfoque