Una tarea que dice «implementa la funcionalidad» no es una tarea, es una intención. Cuando un trabajo parece demasiado grande para empezar, el problema normalmente no es el volumen: es que nadie ha decidido el primer paso que se pueda verificar.
El proceso de planificación
1. Planificar antes de tocar nada. La fase inicial es de solo lectura: se lee la especificación y se estudia el código existente, sin modificar nada. El plan nace de lo que hay, no de lo que se imagina.
2. El grafo de dependencias. Se identifica qué depende de qué. La base va primero (esquema de datos, tipos, interfaces), después lo que la usa. El orden de trabajo sigue las dependencias, no el orden en que vinieron las ideas.
3. Rebanadas verticales. El trabajo se divide en rebanadas que atraviesan todas las capas y producen algo que funciona, no en capas horizontales («primero toda la base de datos, luego toda la interfaz»). Una rebanada vertical se puede probar y enseñar; una capa sola, no. Si una tarea tarda seis semanas en mostrar un resultado, la descomposición es errónea.
4. Escribir las tareas. Cada una tiene un título descriptivo, los criterios de aceptación (cómo se sabe que está terminada), la verificación (qué prueba o control la demuestra), las dependencias y los archivos tocados.
5. Ordenar y poner puntos de control. Después de cada grupo de tareas hay un control: ¿todo funciona junto? ¿Se puede enseñar? Si la respuesta es no, no se avanza.
Qué tamaño debe tener una tarea
Lo bastante pequeña para concluirse y verificarse en una sesión de trabajo, lo bastante grande para tener sentido para quien la recibe. Una señal útil: si el título contiene «y», probablemente son dos tareas. Un plan en el que todas las tareas son «grandes» ha aplazado la descomposición, no la ha hecho.
El documento del plan
Un plan bien hecho tiene: panorámica, decisiones arquitectónicas, lista de tareas agrupadas por fase (cimientos, funciones principales, acabado), un punto de control tras cada fase, riesgos con su mitigación, preguntas abiertas y las tareas que pueden hacer en paralelo personas distintas.
Las excusas más comunes
| Excusa | Realidad |
|---|---|
| «Lo escribo mientras trabajo» | Sin lista no sabes si has terminado, y nadie más puede ayudarte. |
| «Las dependencias se ven por el camino» | Se ven tarde, cuando el orden equivocado cuesta una rehecha. |
| «Los puntos de control frenan» | Frenan menos que un error descubierto al final. |
Señales de alarma
- Se empieza a construir sin una lista escrita de tareas.
- Tareas que dicen «implementa la funcionalidad» sin criterios de aceptación.
- Ninguna verificación en el plan.
- Todas las tareas son grandes.
- Ningún punto de control entre tareas.
- No se ha considerado el orden de las dependencias.
Un ejemplo
Hay que construir un módulo de reserva de salas. Una descomposición por capas («base de datos, luego API, luego pantallas») no muestra nada durante dos semanas. Una por rebanadas verticales: primero «reservar una sala durante una hora, sin controles» (de la base de datos a la pantalla), luego «impedir los solapamientos», luego «cancelar». Cada rebanada se enseña a un usuario el mismo día en que termina.
Cuándo usarlo
Cuando hay una especificación o requisitos claros y hay que convertirlos en trabajo ejecutable, cuando una tarea parece demasiado grande para empezar, cuando hay que estimar el alcance o cuando se puede trabajar en paralelo.
Este método deriva de la familia de skills de código abierto agent-skills de Addy Osmani (licencia MIT), reescrita y adaptada.
Este artículo es una skill de OIAR
Lo que acabas de leer es el contenido de una skill del catálogo de OIAR, escrito para las personas. Un conocimiento como este pero más rico y profundo, escrito para los agentes, guía las entrevistas, el análisis y el informe dentro de la plataforma. Las skills se usan en OIAR: para probarla en un proyecto tuyo necesitas una cuenta.
planning-and-task-breakdownMétodo para convertir una especificación en un plan de tareas verificables: estudio de solo lectura, grafo de dependencias, rebanadas verticales, tareas con criterios de aceptación, tamaños, orden y puntos de control. Úsese cuando existe una especificación o requisitos claros y un trabajo parece demasiado grande para empezar.