# Planning With Files

> 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.

- Skill: `jantoniofc/planning-with-files-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jantoniofc/planning-with-files-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jantoniofc/planning-with-files-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: JantonioFC (https://skillmd.com/u/jantoniofc)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/jantoniofc/planning-with-files-2

---


# 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 |