L13 · Plan · 4 min

Planes y pasos pequeños

En una frase

Un plan divide tu especificación en una serie de tareas pequeñas e independientes guardadas en tasks/plan.md y seguidas en tasks/todo.md, para que tu agente construya una pieza comprobable cada vez, guarde un commit tras cada paso que funciona y puedas verificar el avance sin agobios.

Piénsalo así

Cocinar un menú de cinco platos a la vez en la misma olla es garantía de comida quemada y caos. En una buena cocina se prepara y prueba un plato cada vez, tachándolo de la lista antes de pasar al siguiente. Tu plan es esa lista de cocina.

Cómo funciona

Una vez que apruebas SPEC.md, tu Definiciónagente de programaciónUna IA que trabaja en la carpeta de tu proyecto: lee archivos, escribe código y ejecuta comandos, con tu permiso.Abrir en el glosario → no intenta construir toda la app de un solo salto. En su lugar, convierte la Definiciónespecificación`SPEC.md`: qué vas a construir, para quién, qué entra y qué no, y cómo sabrás que funciona.Abrir en el glosario → en un DefiniciónplanLa especificación dividida en tareas pequeñas, cada una terminada y comprobable por sí sola, en `tasks/plan.md`.Abrir en el glosario → repartido en dos archivos de tu proyecto: tasks/plan.md, que explica cada tarea y cómo comprobarla, y tasks/todo.md, una lista de tareas sencilla que muestra qué está hecho y qué toca después.

Una buena tarea es lo bastante pequeña como para terminarse y comprobarse por sí sola: por ejemplo, «Crear el esqueleto inicial de la app y las páginas de error», luego «Añadir la página con la lista de recetas de ejemplo» y después «Conectar el formulario para añadir una receta». Si una tarea no se puede probar sola, todavía es demasiado grande.

Para cada tarea, tu agente crea una DefiniciónramaUna copia segura de tu proyecto donde se preparan los cambios. `main` es la publicada.Abrir en el glosario → segura (como feature/recipe-list), avanza en pasos cortos y guarda un DefinicióncommitUn punto de guardado: una foto de lo que cambió, con una nota corta. Puedes volver a cualquier commit.Abrir en el glosario → tras cada paso que funciona. Cuando la tarea está lista, te enseña el resultado para que lo pruebes, marca la casilla en tasks/todo.md y sube los puntos de guardado a GitHub con un Definiciónpush (subir)Enviar tus commits desde tu equipo a GitHub.Abrir en el glosario →.

Como tasks/todo.md vive dentro de tu Definiciónrepositorio (repo)La carpeta de tu proyecto más todo su historial. Git registra cada punto de guardado para que puedas volver a cualquier versión.Abrir en el glosario →, puedes cerrar el portátil en cualquier momento y retomar el proyecto días después. Al empezar cada sesión, tu agente lee SPEC.md y tasks/todo.md y te dice exactamente por dónde ibas.

1 · Desglosetasks/plan.md y todo.mdLa especificación se divide en tareas pequeñas en tu idioma, cada una comprobable por sí sola.
2 · Una tareaRama + commits pequeñosTu agente trabaja en una rama, guarda un commit tras cada paso que funciona y te enseña el resultado.
3 · ComprobadoMarcar y hacer pushCuando compruebas que funciona, el agente marca `tasks/todo.md` y hace push a GitHub antes de la siguiente tarea.
FIG. 1 · El ritmo de planificar y construir: dividir `SPEC.md` en tareas comprobables, construir una cada vez con commits pequeños y marcar `tasks/todo.md`.

Cómo se ve en tu proyecto

Antes de programar ninguna función, tu agente crea tasks/plan.md y tasks/todo.md en tu idioma y te explica la lista con claridad. Espera tu visto bueno al plan, empieza por la Tarea 1 y se detiene para enseñarte el resultado funcionando antes de pasar a la Tarea 2.

Copia para tu agente

Lee SPEC.md y crea tasks/plan.md y tasks/todo.md en mi idioma. Divide el trabajo en tareas pequeñas que podamos terminar y comprobar una por una, y espera mi visto bueno antes de empezar la Tarea 1.

Comprobación rápida · 1 pregunta

¿De qué tamaño debe ser cada tarea en `tasks/plan.md`?

Profundiza

Siguiente lecciónClaves y secretos: variables de entorno

Última revisión 8 nov 2026