clinica-veterinaria/orchestration/_archive/directivas/triggers/TRIGGER-INICIO-TAREA.md

═══════════════════════════════════════════════════════════════════════════════

TRIGGER-INICIO-TAREA

═══════════════════════════════════════════════════════════════════════════════

Version: 1.0.0

Creado: 2026-01-16

Origen: Auditoría post-tarea TASK-2026-01-16-004

Proposito: Garantizar creación de carpeta de tarea ANTES de ejecutar código

═══════════════════════════════════════════════════════════════════════════════

CONDICION DE ACTIVACION

Este trigger se activa AUTOMATICAMENTE cuando:

1. Se recibe una solicitud que implica modificar código
2. Se recibe una solicitud que implica crear archivos nuevos
3. Se usa @FULL o @CREATE-SAFE o @MODIFY-SAFE
4. El primer item de TodoWrite incluye una tarea de implementación

EXCEPCION: No aplica para:

• Modo @QUICK en fixes menores (typos, config simple)
• Modo @ANALYSIS (solo investigación)
• Tareas puramente de lectura/exploración

---

ACCION OBLIGATORIA

Paso 1: Generar ID de Tarea

TASK-{YYYY-MM-DD}-{NNN}

Donde:

• YYYY-MM-DD: Fecha actual
• NNN: Siguiente secuencial del día (consultar _INDEX.yml)

Paso 2: Crear Estructura de Carpeta

# Ruta base
orchestration/tareas/TASK-{ID}/

# Archivos mínimos obligatorios
├── METADATA.yml          # Copiar de _templates/TASK-TEMPLATE/
├── 01-CONTEXTO.md        # Llenar con clasificación inicial
└── (otros según avance)

Paso 3: Registrar en Inventario

Agregar entrada en tareas_activas de _INDEX.yml:

tareas_activas:
  - task_id: "TASK-2026-01-XX-NNN"
    titulo: "Título descriptivo"
    agente: "PERFIL-AGENTE"
    estado: "en_progreso"
    fase: "C"  # Inicia en Contexto
    proyecto: "nombre-proyecto"

Paso 4: Incluir en TodoWrite

El PRIMER item de TodoWrite debe ser:

- Crear carpeta de tarea TASK-{ID} en orchestration/tareas/

O si ya existe:

- Documentar contexto en TASK-{ID}/01-CONTEXTO.md

---

CHECKPOINT DE VALIDACION

ANTES de ejecutar cualquier código (fase E):

[ ] ¿Existe carpeta orchestration/tareas/TASK-{ID}/?
[ ] ¿Existe METADATA.yml con información básica?
[ ] ¿Se registró en _INDEX.yml como tarea activa?
[ ] ¿TodoWrite incluye la tarea de documentación?

SI algún checkbox falla: BLOQUEAR ejecución hasta completar.

---

INTEGRACION CON TODOWRITE

Cuando se use TodoWrite para planificar una tarea de código, incluir SIEMPRE:

// Ejemplo de TodoWrite correcto
[
  { content: "Crear carpeta TASK-2026-01-16-004", status: "pending" },
  { content: "Documentar contexto y clasificación", status: "pending" },
  { content: "Analizar dependencias", status: "pending" },
  // ... tareas técnicas ...
  { content: "Actualizar _INDEX.yml al completar", status: "pending" }
]

---

REFERENCIAS

• @TAREAS - orchestration/tareas/
• @NUEVA-TAREA - orchestration/tareas/_templates/TASK-TEMPLATE/
• @TRIGGER-DOC - TRIGGER-DOCUMENTACION-OBLIGATORIA.md
• @MAPA-DOC - orchestration/MAPA-DOCUMENTACION.yml

---

CASO DE ESTUDIO: TASK-2026-01-16-004

Esta directiva nace del análisis post-mortem de la tarea:

"Integración de Servicios de API en Trading Platform Frontend"

Problema Detectado

• La tarea se ejecutó correctamente (build pasa, código funcional)
• PERO no se creó carpeta de tarea antes de ejecutar
• No se documentaron fases C, A, P, V formalmente
• No se actualizó _INDEX.yml hasta auditoría posterior

Causa Raíz

1. No existía trigger bloqueante para creación de carpeta
2. TodoWrite no recordaba incluir checkpoint de gobernanza
3. Las reglas estaban en CLAUDE.md pero sin enforcement automático

Solución Implementada

1. Crear este trigger (TRIGGER-INICIO-TAREA)
2. Documentación retroactiva de la tarea
3. Actualización de _INDEX.yml
4. Propuesta de mejora a flujo de TodoWrite

---

METRICAS DE CUMPLIMIENTO

Métrica	Objetivo	Medición
Tareas con carpeta antes de E	100%	tareas_con_carpeta / total_tareas
Fases documentadas por tarea	>= 3	promedio(fases_doc)
_INDEX.yml actualizado	100%	tareas_en_index / total_tareas

---

═══════════════════════════════════════════════════════════════════════════════

FIN DEL TRIGGER

═══════════════════════════════════════════════════════════════════════════════