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

TRIGGER: CIERRE DE TAREA OBLIGATORIO

Versión: 1.0.0 Fecha: 2026-01-16 Sistema: SIMCO v4.0.0 Alias: @TRIGGER_CIERRE

---

RESUMEN EJECUTIVO

Este trigger OBLIGA la ejecución del checklist post-tarea (@DEF_CHK_POST) antes de que cualquier tarea pueda ser marcada como completada.

PRINCIPIO: "Una tarea no está completada hasta que su checklist de cierre esté 100% verificado."

---

CONDICIONES DE ACTIVACIÓN

activar_cuando:
  - Agente intenta marcar tarea como "completada"
  - Agente dice "tarea finalizada" o variantes
  - Agente termina la última subtarea del plan
  - Agente declara "Done" o "DONE"
  - Agente reporta que terminó el trabajo

palabras_clave_trigger:
  - "completada"
  - "finalizada"
  - "terminada"
  - "Done"
  - "DONE"
  - "tarea cerrada"
  - "trabajo terminado"
  - "implementación completa"

---

ACCIÓN REQUERIDA

Secuencia Obligatoria

AGENTE DECLARA TAREA TERMINADA
         │
         ▼
┌─────────────────────────────────────┐
│ 1. DETENER                          │
│    No marcar como completada aún    │
└─────────────────┬───────────────────┘
                  │
                  ▼
┌─────────────────────────────────────┐
│ 2. CARGAR @DEF_CHK_POST             │
│    CHECKLIST-POST-TASK.md           │
└─────────────────┬───────────────────┘
                  │
                  ▼
┌─────────────────────────────────────┐
│ 3. EJECUTAR CHECKLIST               │
│    - Gobernanza (BLOQUEANTE)        │
│    - Validaciones técnicas          │
│    - Coherencia entre capas         │
│    - Inventarios                    │
│    - Trazas                         │
│    - Propagación                    │
└─────────────────┬───────────────────┘
                  │
                  ▼
         ┌───────────────┐
         │ ¿TODOS PASAN? │
         └───────┬───────┘
              /     \
           Sí       No
            │        │
            ▼        ▼
┌──────────────┐  ┌──────────────────────┐
│ 4. MARCAR    │  │ 4. MANTENER EN       │
│ COMPLETADA   │  │    PROGRESO          │
└──────────────┘  │                      │
                  │ - Documentar items   │
                  │   faltantes          │
                  │ - Completar antes    │
                  │   de cerrar          │
                  └──────────────────────┘

---

CHECKLIST RÁPIDO DE CIERRE

## Verificación Pre-Cierre (@DEF_CHK_POST)

### 0. Gobernanza (BLOQUEANTE - SI FALLA, NO CONTINUAR)
[ ] Carpeta de tarea existe: orchestration/tareas/TASK-{ID}/
[ ] METADATA.yml completo con fases C, E, D
[ ] _INDEX.yml de tareas actualizado

### 1. Validaciones Técnicas
[ ] Build pasa (backend y/o frontend según aplique)
[ ] Lint pasa
[ ] Tests pasan (si existen)

### 2. Coherencia Entre Capas
[ ] DDL ↔ Backend coherente (o excepciones documentadas)
[ ] Backend ↔ Frontend coherente (si aplica)

### 3. Inventarios Actualizados
[ ] DATABASE_INVENTORY.yml (si cambió BD)
[ ] BACKEND_INVENTORY.yml (si cambió BE)
[ ] FRONTEND_INVENTORY.yml (si cambió FE)
[ ] MASTER_INVENTORY.yml (siempre)

### 4. Trazas Actualizadas
[ ] Traza de tarea correspondiente actualizada
[ ] PROXIMA-ACCION.md actualizado

### 5. Propagación Evaluada
[ ] ¿Cambio debe propagarse a otros proyectos? (evaluar)
[ ] Si aplica: propagación ejecutada o documentada como pendiente

---

BLOQUEO

SI el checklist NO pasa:

accion: "BLOQUEAR cierre de tarea"
estado: "EN PROGRESO"
mensaje: |
  Tarea NO puede ser marcada como completada.
  Items faltantes del checklist:
  - [listar items que fallaron]

  Acción requerida:
  - Completar items faltantes
  - Re-ejecutar checklist
  - Solo entonces marcar como completada  

reintentar: "Después de completar items faltantes"

Items BLOQUEANTES (no negociables):

bloqueantes_absolutos:
  - Gobernanza (carpeta + METADATA + _INDEX)
  - Build que falla
  - Tests que fallan

advertencias_serias:
  - Inventarios desactualizados
  - Trazas desactualizadas
  - Coherencia no verificada

advertencias_menores:
  - Propagación no evaluada (si proyecto aislado)

---

INTEGRACIÓN CON OTROS TRIGGERS

secuencia_de_triggers:
  1: "Agente ejecuta trabajo"
  2: "Agente intenta cerrar tarea"
  3: "→ TRIGGER-CIERRE-TAREA-OBLIGATORIO se activa"
  4: "→ Carga @DEF_CHK_POST"
  5: "→ TRIGGER-INVENTARIOS-SINCRONIZADOS verifica inventarios"
  6: "→ TRIGGER-COHERENCIA-CAPAS verifica coherencia"
  7: "→ TRIGGER-DOCUMENTACION-OBLIGATORIA verifica gobernanza"
  8: "Si todo pasa: tarea = COMPLETADA"
  9: "Si algo falla: tarea = EN PROGRESO"

dependencias:
  - "@TRIGGER_INVENTARIOS"
  - "@TRIGGER_COHERENCIA"
  - "@TRIGGER_DOC"

---

MENSAJES ESTÁNDAR

Al detectar intento de cierre:

⚠️ TRIGGER-CIERRE-TAREA-OBLIGATORIO activado

Antes de marcar la tarea como completada, debo ejecutar el checklist post-tarea.

Ejecutando @DEF_CHK_POST...

Si todo pasa:

✅ Checklist post-tarea completado exitosamente

Verificaciones:
- [✓] Gobernanza
- [✓] Validaciones técnicas
- [✓] Coherencia entre capas
- [✓] Inventarios sincronizados
- [✓] Trazas actualizadas
- [✓] Propagación evaluada

TAREA MARCADA COMO COMPLETADA

Si algo falla:

❌ Checklist post-tarea NO completado

Items faltantes:
- [ ] {item que falló}
- [ ] {otro item que falló}

Acción: Completar items faltantes antes de cerrar.
Estado: EN PROGRESO (no completada)

---

EXCEPCIONES

excepciones_permitidas:
  tareas_triviales:
    - Corrección de typos
    - Actualización de comentarios
    - Cambios cosméticos
    checklist_reducido:
      - Solo Gobernanza
      - Solo Validación build

  investigación_pura:
    - Análisis sin cambios de código
    - Spikes exploratorios
    checklist_reducido:
      - Solo documentación de hallazgos

nota: "Incluso excepciones DEBEN documentar en trazas"

---

REFERENCIAS

Alias	Archivo
@DEF_CHK_POST	orchestration/_definitions/checklists/CHECKLIST-POST-TASK.md
@TRIGGER_INVENTARIOS	orchestration/directivas/triggers/TRIGGER-INVENTARIOS-SINCRONIZADOS.md
@TRIGGER_COHERENCIA	orchestration/directivas/triggers/TRIGGER-COHERENCIA-CAPAS.md
@TRIGGER_DOC	orchestration/directivas/triggers/TRIGGER-DOCUMENTACION-OBLIGATORIA.md
@CAPVED	orchestration/directivas/principios/PRINCIPIO-CAPVED.md

---

Versión: 1.0.0 | Sistema: SIMCO v4.0.0 | Tipo: Trigger de Cierre Obligatorio