Descomposición de Objetivos (EloPhanto)

Descomposición de Objetivos

Descripción

Prácticas recomendadas para descomponer objetivos complejos en hitos ejecutables.

Disparadores

• objetivo
• plan
• largo plazo
• multi-paso
• proyecto
• lograr
• hito

Instrucciones

Principios de Descomposición

1. Concreto sobre abstracto — Cada hito debe producir un artefacto tangible o un resultado verificable, no "pensar en X"
2. 3-10 hitos — Pocos = hitos demasiado complejos. Demasiados = sobrecarga.
3. Investigar antes de actuar — El primer hito siempre debe recopilar información
4. Verificar antes de continuar — Incluir pasos de verificación como criterios de éxito, no como hitos separados
5. Anticipar lo desconocido — Colocar hitos inciertos/arriesgados al principio para que el fracaso sea barato

Reglas de Criterios de Éxito

• Deben ser objetivamente verificables — "el archivo existe en la ruta X", "se encontraron 3 posiciones", "la prueba pasa"
• Sin criterios subjetivos — evitar "buena calidad", "bien escrito"
• Incluir cantidades cuando sea posible — "al menos 3", "menos de 500 palabras"

Cuándo Revisar

• Nueva información invalida suposiciones (la empresa no está contratando)
• Un hito revela que al plan le faltan pasos
• El usuario proporciona comentarios que cambian la dirección
• 2+ fallos de hitos sugieren un enfoque incorrecto

Anti-patrones

• No crear un objetivo para tareas completables en <5 llamadas a herramientas
• No hacer hitos que dependan de tiempos externos ("esperar respuesta") — en su lugar, pausar el objetivo y programar un recordatorio para reanudar
• No poner toda la complejidad en un solo hito — si un hito necesita 50+ llamadas a herramientas, debe dividirse

Ejemplos

Buena Descomposición: Solicitud de Empleo

Objetivo: "Conseguir un trabajo en la empresa X"

1. Investigar X (cultura, stack, noticias recientes) — criterio: resumen escrito
2. Encontrar posiciones abiertas — criterio: 3+ posiciones listadas con URLs
3. Adaptar currículum — criterio: archivo de currículum actualizado, habilidades relevantes destacadas
4. Redactar carta de presentación — criterio: archivo de carta de presentación creado, <400 palabras
5. Enviar solicitud — criterio: captura de pantalla de la página de confirmación guardada

Buena Descomposición: Sitio Web de Portafolio

Objetivo: "Créame un sitio web de portafolio"

1. Investigar tendencias de diseño y recopilar requisitos — criterio: brief de diseño escrito
2. Configurar proyecto (Next.js + destino de despliegue) — criterio: proyecto esqueletizado, servidor de desarrollo funciona
3. Construir páginas principales (inicio, acerca de, proyectos) — criterio: 3 páginas se renderizan con contenido de placeholder
4. Agregar contenido real y estilos — criterio: todas las secciones pobladas, responsivo en móvil
5. Desplegar a producción — criterio: URL en vivo accesible, sin errores de consola

Buena Descomposición: Auditoría de Seguridad

Objetivo: "Auditar este código base en busca de vulnerabilidades de seguridad"

1. Escanear dependencias en busca de CVEs conocidos — criterio: informe de dependencias generado
2. Revisar autenticación y manejo de sesiones — criterio: flujo de autenticación documentado, problemas listados
3. Verificar vulnerabilidades de inyección (SQL, XSS, comandos) — criterio: cada ruta de entrada probada
4. Escribir informe de auditoría con niveles de gravedad — criterio: archivo de informe creado, hallazgos priorizados

Mala Descomposición

Objetivo: "Conseguir un trabajo en la empresa X"

1. Hacer investigación (demasiado vago, sin criterios)
2. Aplicar (demasiado amplio, debería ser múltiples pasos)
3. Esperar respuesta (depende de tiempos externos)

Verificar

• El entregable de esta fase existe como un artefacto concreto (documento, ticket, tablero, repositorio) y su ubicación se comparte, no se describe
• Cada compromiso tiene un nombre de responsable, una fecha de vencimiento y una definición de finalización que alguien distinto al autor podría verificar
• Los riesgos están listados con probabilidad/impacto y una mitigación nombrada, no como un genérico 'riesgos: TBD'
• Las dependencias de otros equipos/proveedores/agentes son explícitas; se registra un acuse de recibo de cada dependencia o se marca como 'pendiente'
• Los criterios de éxito para la siguiente fase son numéricos o, de otro modo, objetivamente verificables
• Se escribe un criterio de reversión / interruptor de seguridad / 'nos detendremos si X' antes de comenzar el trabajo

Notas

• Siempre verificar si un goals/SKILL.md es relevante antes de crear un objetivo
• El sistema de objetivos maneja la persistencia, el contexto y la auto-continuación automáticamente
• Usar goal_status para verificar el progreso en cualquier momento