# ═══════════════════════════════════════════════════════════════════════════════
# 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

```bash
# 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`:

```yaml
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:

```typescript
// 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
# ═══════════════════════════════════════════════════════════════════════════════