Jesse Vincent (obra) / writing-plans
¿Para qué escribir un plan si el agente podría empezar ya?
Porque el plan es la única parte del trabajo que sobrevive a un contexto perdido.
Lo que conviene recordar
- Un plan es el mecanismo de recuperación cuando se pierde contexto, que en trabajo largo pasa constantemente.
- Los pasos sin definición de hecho son deseos, no pasos.
- Revisar un plan es mucho más barato que revisar una implementación terminada.
- Es el puente natural entre brainstorming y el desarrollo con subagentes.
01Qué cambia en la práctica
Las tareas largas con agentes fallan de una forma concreta: la conversación crece, las decisiones antiguas salen del contexto y el agente empieza a contradecir lo que hizo hace una hora. Un plan en disco es inmune a eso, porque se relee en vez de recordarse.
También abarata el desacuerdo. Discutir un plan cuesta minutos; discutir una implementación terminada cuesta lo que costó construirla.
02Dónde decepciona
Los planes caducan. Un plan que ya no coincide con el código es peor que ninguno, porque se confía en él, así que actualízalo cuando la realidad se separe.
También existe el exceso de planificación. El trabajo pequeño no necesita un documento, y producirlo es procedimiento por el procedimiento.
Instalación y primera ejecución
- Instala superpowers desde obra/superpowers, con licencia MIT.
- Exige que cada paso nombre un archivo o componente y una forma de saber que está hecho.
- Guarda el plan en el repositorio, para que sea revisable y sobreviva a la sesión.
Preguntas que la gente hace de verdad
- ¿Dónde debe vivir el plan?
- En el repositorio, para poder revisarlo, versionarlo y releerlo desde otra sesión u otro agente.
- ¿Qué hace bueno a un paso?
- Un objetivo nombrado y una forma de saber que terminó. Sin eso no se puede comprobar el avance.
- ¿Cuándo sobra planificar?
- Cuando la tarea cabe en una sesión y en una frase. Ahí el plan es ceremonia.
Fuentes
Versiones legibles por máquina de esta página