getedgehq/workplan

Habilidad de Plan de Trabajo

Los planes de trabajo son archivos Markdown con marca de tiempo que sobreviven a la compactación automática. Son tu cerebro externo para trabajo de múltiples pasos.

Convención de Archivos

• Ubicación: Raíz del proyecto, ignorado por git
• Nombre: WORKPLAN-YYYYMMDD-slug.md (ej., WORKPLAN-20260228-auth-refactor.md)
• Un archivo por tarea/fase. No reutilices planes de trabajo antiguos. Empieza de nuevo para cada esfuerzo distinto.

Acciones

Crear (/workplan o /workplan create)

1. Lee primero. Antes de escribir el plan, lee todos los archivos, incidencias y contexto relevantes.

2. Asegúrate de que .gitignore incluya WORKPLAN-*.md (añádelo si falta).

3. Elige un modo de alcance antes de escribir el plan:

   • EXPANSIÓN: "¿Cuál es la versión de 10 estrellas?" Sueña en grande, expande el alcance.
   • HOLD: "Hazlo a prueba de balas." El alcance es correcto, maximiza el rigor.
   • REDUCCIÓN: "¿Cuál es el mínimo que entrega valor?" Recorta sin piedad.

   Por defecto: funcionalidad nueva = EXPANSIÓN, corrección de errores / preparación de lanzamiento = HOLD, con restricción de tiempo = REDUCCIÓN.

4. Crea el archivo con esta plantilla:

# Plan de Trabajo: [Título]

Creado: YYYY-MM-DD HH:MM
Última actualización: YYYY-MM-DD HH:MM
Estado: EN PROGRESO
Modo: HOLD / EXPANSIÓN / REDUCCIÓN

## Contexto

[Por qué existe este trabajo. El problema. Causa raíz. Restricciones clave. Enlaces a incidencias/PRs.]

## Hoja de Ruta

- [ ] 1. Descripción del paso
- [ ] 2. Descripción del paso
- [ ] 3. Descripción del paso

## Decisiones

[Registra decisiones arquitectónicas o de enfoque con marcas de tiempo]
- [HH:MM] Elegimos X sobre Y porque Z

## Problemas Descubiertos

[Cosas encontradas en el camino que no estaban en el alcance original]
- [HH:MM] Encontrado ... mientras trabajaba en el paso 2

## Registro de Verificación

[Cada ítem completado obtiene una entrada de verificación]
- [HH:MM] Paso 1: VERIFICADO - ejecuté `npm test`, todas las 42 pruebas pasan
- [HH:MM] Paso 3: VERIFICADO - probé manualmente el flujo de inicio de sesión, funciona con OAuth y correo electrónico

Actualizar (/workplan update)

1. Lee el/los archivo(s) activo(s) WORKPLAN-*.md en la raíz del proyecto.
2. Actualiza la marca de tiempo de "Última actualización".
3. Marca los ítems completados con marcas de tiempo de verificación.
4. Añade cualquier nuevo descubrimiento o decisión.
5. Informa al usuario del estado actual.

Cerrar (/workplan close)

1. Lee el plan de trabajo activo.
2. Verifica que TODOS los ítems estén marcados con marcas de tiempo de verificación.
3. Ejecuta la verificación final (compilación, pruebas, comprobaciones manuales).
4. Cambia el estado a HECHO.
5. Añade un resumen final:

## Completado

Cerrado: YYYY-MM-DD HH:MM
Todos los N ítems implementados y verificados. La compilación pasa. Las pruebas pasan.

Reanudar (después de compactación)

Cuando el contexto ha sido compactado o no estás seguro de dónde lo dejaste:

1. Encuentra planes de trabajo activos: busca WORKPLAN-*.md en la raíz del proyecto.
2. Lee el archivo del plan de trabajo.
3. Identifica el primer ítem sin marcar.
4. Continúa desde allí.

Reglas

1. VERIFICADO significa probado. No "Creo que funciona". Ejecútalo, míralo pasar, luego márcalo como verificado. Incluye qué ejecutaste y el resultado.
2. Actualiza las marcas de tiempo en cada cambio. Tu yo futuro (post-compactación) depende de esto.
3. Los nuevos descubrimientos van de inmediato. No los mantengas solo en el contexto.
4. Nunca elimines el plan hasta que el usuario confirme que el trabajo está hecho.
5. Una preocupación por ítem de lista de verificación. Divide los pasos grandes en piezas verificables más pequeñas.
6. Si un paso falla la verificación, registra el fallo, mantenlo sin marcar, añade qué salió mal.