rckrdmrd
dc8c5dcc52
- Updated database submodule - Added SIMCO directivas - Updated inventory files Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
161 lines
5.1 KiB
Markdown
161 lines
5.1 KiB
Markdown
# ═══════════════════════════════════════════════════════════════════════════════
|
|
# 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
|
|
# ═══════════════════════════════════════════════════════════════════════════════
|