Skip to content
← Todos los capítulos

Capítulo 03

Plantillas de plan y tarea

Un Deep Work Plan es un directorio de archivos Markdown. La forma de ese directorio, y de cada archivo que contiene, es lo que hace que un plan sea revisable tanto por personas como por agentes.

Estructura del plan

Un plan es un directorio bajo .dwp/plans/ llamado PLAN_<slug>/. Contiene:

  • README.md: el resumen del plan: objetivo, material de origen, tabla de tareas y estado.
  • Un archivo por tarea, con el nombre <n>.task_<slug>.md.
  • PROGRESS.md: un registro continuo de la ejecución.

Estructura del archivo de tarea

Cada archivo de tarea se llama <n>.task_<slug>.md y sigue la anatomía de nueve secciones: Objetivo, Contexto, Pasos, Criterios de aceptación, Validación, Archivos, Dependencias, Riesgos y Finalización y registro. Las secciones aparecen siempre en ese orden para que cualquier lector sepa dónde mirar. Cada tarea se reancla al objetivo del plan antes de actuar, lo que evita que un agente se desvíe en un horizonte largo de varias horas.

Las tres tareas finales obligatorias

Todo plan debe terminar con tres tareas estándar. Aseguran que el trabajo quede auditado, que se capture el conocimiento y que se informe a las partes interesadas:

  1. Revisión de seguridad: auditar todo lo que el plan cambió en busca de secretos, riesgos de inyección y nueva superficie de ataque, y mantener docs/SECURITY.md al día. La seguridad no es un flujo de trabajo aparte añadido al final: cada plan deja sus propios cambios auditados, y un hallazgo crítico bloquea la finalización.
  2. Descubrimiento de habilidades y agentes: identificar las habilidades y agentes reutilizables creados durante el plan, para que el trabajo se acumule más allá de este esfuerzo puntual.
  3. Informe ejecutivo: un resumen conciso de los resultados, escrito para las partes interesadas, que distingue lo entregado de lo que queda pendiente.

Convenciones de README y PROGRESS

El README.md del plan debe contener un título (# Deep Work Plan: <nombre>), una declaración del objetivo en prosa, una sección opcional de material de origen, una tabla de tareas (número, nombre de la tarea, casilla de estado) y una línea de estado del plan con la forma <n>/<total> tareas completadas.

PROGRESS.md es un registro de ejecución de solo adición. Cada entrada registra una marca de tiempo en formato ISO 8601, el número y nombre de la tarea, qué se hizo y cualquier desviación o motivo de omisión. Como solo crece, es un historial fiable de cómo se desarrolló realmente el plan.

Encabezados y referencias cruzadas

Todos los encabezados usan mayúscula inicial al estilo de oración, y los documentos evitan el lenguaje publicitario y los signos de exclamación. Estas convenciones mantienen los planes coherentes entre agentes y a lo largo del tiempo.