rckrdmrd
a7575d6096
Propagated via automated script (scripts/propagate-governance.sh): - orchestration/_definitions/: canonical definitions - orchestration/directivas/checklists/: CAPVED phase checklists - docs/_SSOT/: Single Source of Truth - orchestration/tareas/_templates/TASK-TEMPLATE-UNIFIED/ Configured as STANDALONE project Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
130 lines
3.5 KiB
Markdown
130 lines
3.5 KiB
Markdown
# TASK-TEMPLATE-UNIFIED
|
|
|
|
**Version:** 2.0.0
|
|
**Actualizado:** 2026-01-18
|
|
|
|
## Proposito
|
|
|
|
Template unificado para tareas que integra:
|
|
- Metadata estructurada (METADATA.yml)
|
|
- Sistema recursivo de subtareas N niveles (SUBTASKS.yml)
|
|
- Registro de lecciones aprendidas (LESSONS-LEARNED.yml)
|
|
|
|
## Archivos
|
|
|
|
| Archivo | Proposito |
|
|
|---------|-----------|
|
|
| `METADATA.yml` | Identificacion, clasificacion, estado, fases CAPVED |
|
|
| `SUBTASKS.yml` | Desglose recursivo hasta 5 niveles |
|
|
| `LESSONS-LEARNED.yml` | Documentacion de aprendizajes post-tarea |
|
|
| `README.md` | Este archivo |
|
|
|
|
## Como Usar
|
|
|
|
### 1. Crear nueva tarea
|
|
|
|
```bash
|
|
# Crear carpeta con ID de tarea
|
|
mkdir orchestration/tareas/TASK-2026-01-18-001
|
|
|
|
# Copiar template
|
|
cp -r orchestration/tareas/_templates/TASK-TEMPLATE-UNIFIED/* orchestration/tareas/TASK-2026-01-18-001/
|
|
```
|
|
|
|
### 2. Actualizar METADATA.yml
|
|
|
|
```yaml
|
|
task:
|
|
id: "TASK-2026-01-18-001"
|
|
title: "Titulo real de la tarea"
|
|
created: "2026-01-18"
|
|
```
|
|
|
|
### 3. Definir subtareas en SUBTASKS.yml
|
|
|
|
Adaptar las subtareas segun los dominios afectados:
|
|
- Eliminar grupos no necesarios (ej: E.FE si no hay cambios frontend)
|
|
- Agregar subtareas especificas
|
|
- Definir criterios de aceptacion
|
|
|
|
### 4. Ejecutar tarea siguiendo CAPVED
|
|
|
|
1. **C** - Contexto: Vincular con RF/ET/US
|
|
2. **A** - Analisis: Mapear dependencias e impacto
|
|
3. **P** - Plan: Detallar subtareas en SUBTASKS.yml
|
|
4. **V** - Validacion: Gate de aprobacion
|
|
5. **E** - Ejecucion: Implementar por checkpoints (CP1-CP4)
|
|
6. **D** - Documentacion: Actualizar inventarios, trazas, lecciones
|
|
|
|
### 5. Completar LESSONS-LEARNED.yml
|
|
|
|
Al finalizar la tarea:
|
|
- Documentar que funciono bien
|
|
- Documentar problemas y resoluciones
|
|
- Agregar recomendaciones
|
|
|
|
## Estructura de Niveles (SUBTASKS.yml)
|
|
|
|
```
|
|
NIVEL 1: FASE
|
|
├── C (Contexto)
|
|
├── A (Analisis)
|
|
├── P (Plan)
|
|
├── V (Validacion)
|
|
├── E (Ejecucion) ← NIVEL 2: GRUPO
|
|
│ ├── E.DB (Database)
|
|
│ ├── E.BE (Backend) ← NIVEL 3: SUBTAREA
|
|
│ │ ├── E.BE.01
|
|
│ │ │ ├── E.BE.01.AC1 ← NIVEL 4: CRITERIO
|
|
│ │ │ │ └── AC1.1 ← NIVEL 5: SUB-CRITERIO
|
|
│ │ │ └── E.BE.01.AC2
|
|
│ │ └── E.BE.02
|
|
│ ├── E.FE (Frontend)
|
|
│ └── E.COH (Coherencia)
|
|
└── D (Documentacion)
|
|
```
|
|
|
|
## Checkpoints de Ejecucion
|
|
|
|
| Checkpoint | Validaciones |
|
|
|------------|--------------|
|
|
| CP1: Post-Database | DDL ejecuta, recreate-database.sh exitoso |
|
|
| CP2: Post-Backend | npm run build, lint, test - PASAN |
|
|
| CP3: Post-Frontend | npm run build, typecheck - PASAN |
|
|
| CP4: Coherencia | Entity↔DDL, DTO↔Entity, FE↔BE alineados |
|
|
|
|
## Estados de Subtareas
|
|
|
|
| Estado | Descripcion |
|
|
|--------|-------------|
|
|
| `pending` | No iniciado |
|
|
| `in_progress` | En ejecucion |
|
|
| `completed` | Terminado exitosamente |
|
|
| `blocked` | Bloqueado por dependencia |
|
|
| `skipped` | Omitido (documentar razon) |
|
|
|
|
## Integracion con Sistema
|
|
|
|
### Actualizar _INDEX.yml al completar
|
|
|
|
```yaml
|
|
tasks:
|
|
- id: TASK-2026-01-18-001
|
|
title: "Titulo de la tarea"
|
|
date: "2026-01-18"
|
|
status: completed
|
|
path: "orchestration/tareas/TASK-2026-01-18-001/"
|
|
```
|
|
|
|
### Propagar lecciones al workspace
|
|
|
|
Si `propagation.should_propagate: true` en LESSONS-LEARNED.yml:
|
|
1. Copiar entrada relevante a `workspace-v2/orchestration/retrospectivas/LECCIONES-INDEX.yml`
|
|
2. Marcar `propagated: true`
|
|
|
|
## Referencias
|
|
|
|
- SSOT: `docs/_SSOT/`
|
|
- Checklists CAPVED: `orchestration/directivas/checklists/`
|
|
- Template anterior: `workspace-v2/orchestration/tareas/_templates/TASK-TEMPLATE/`
|