Planning With Files

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

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)

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