trading-platform/orchestration/tareas/TASK-2026-02-06-ANALISIS-INTEGRAL-DOCUMENTACION/subagentes/prompts/PROMPT-SA-18.md

id	agent_id	model	type	fase	scope	mode	created
PROMPT-SA-18	SA-18	claude-sonnet-4.5	General background	FASE-5	Traceability and inventory completeness validation	read-only	2026-02-06

PROMPT-SA-18: Validación Trazabilidad e Inventarios

Contexto

Eres un agente validador de gobernanza documental. Tu tarea es verificar la completitud y coherencia de inventarios, trazas y documentos de gobernanza del proyecto.

Proyecto: trading-platform Objetivo: Validar que todos los sistemas de trazabilidad estén sincronizados y completos

FASE: FASE-5 (Validation - read only)

Archivos a validar:

1. Inventarios (5): MASTER, DATABASE, BACKEND, FRONTEND, API
2. Trazas (4): TRAZA-TAREAS-DATABASE, TRAZA-TAREAS-BACKEND, TRAZA-TAREAS-FRONTEND, TRAZA-EJECUCION-GENERAL
3. Gobernanza (3): DEPENDENCY-GRAPH, PROJECT-STATUS, CONTEXT-MAP
4. Índices: _INDEX.yml de tareas, _MAP.md

Instrucciones

PASO 1: Validar Inventarios (5 archivos)

Archivos a leer:

1. orchestration/inventarios/MASTER_INVENTORY.yml
2. orchestration/inventarios/DATABASE_INVENTORY.yml
3. orchestration/inventarios/BACKEND_INVENTORY.yml
4. orchestration/inventarios/FRONTEND_INVENTORY.yml
5. orchestration/inventarios/API_INVENTORY.yml (si existe)

Para cada inventario:

1. Verificar campos obligatorios:

   • version: ¿Presente?
   • updated: ¿Fecha reciente (últimos 7 días)?
   • project: ¿Correcto (trading-platform)?
   • Métricas principales: ¿Todas presentes?

2. Validar coherencia entre inventarios:

   • MASTER debe ser agregado de DATABASE + BACKEND + FRONTEND
   • Conteos deben coincidir:
     • MASTER.tablas = DATABASE.tablas
     • MASTER.services = BACKEND.services
     • MASTER.components = FRONTEND.components

3. Comparar con código real (validaciones previas):

   • Usar resultados de SA-15 (DDL), SA-16 (Backend), SA-17 (Frontend)
   • ¿Los conteos en inventarios coinciden con la realidad?

4. Generar tabla de coherencia:

   | Métrica | MASTER | DATABASE | BACKEND | FRONTEND | Código Real | Estado |
   |---------|--------|----------|---------|----------|-------------|--------|
   | Tablas DDL | 101 | 101 | N/A | N/A | 101 | ✅ MATCH |
   | Entities | 85 | N/A | 85 | N/A | 85 | ✅ MATCH |
   | Services | 15 | N/A | 15 | N/A | 15 | ✅ MATCH |
   | Components | 50 | N/A | N/A | 50 | 48 | ❌ GAP (-2) |
   

PASO 2: Validar Trazas de Ejecución (4 archivos)

Archivos a leer:

1. orchestration/trazas/TRAZA-TAREAS-DATABASE.yml
2. orchestration/trazas/TRAZA-TAREAS-BACKEND.yml
3. orchestration/trazas/TRAZA-TAREAS-FRONTEND.yml
4. orchestration/trazas/TRAZA-EJECUCION-GENERAL.yml

Para cada traza:

1. Verificar estructura:

   • version: ¿Presente?
   • updated: ¿Actualizada?
   • entries: ¿Array de objetos?

2. Validar entries:

   • ¿IDs consecutivos? (TRAZA-DB-001, TRAZA-DB-002, etc.)
   • ¿Fechas en orden cronológico?
   • ¿Campos obligatorios presentes? (id, fecha, tarea, descripcion)
   • ¿Checksums presentes cuando aplica?

3. Cross-reference con tareas reales:

   • Leer orchestration/tareas/ - listar todas las tareas completadas
   • Para cada tarea completada:
     • ¿Está registrada en la traza correspondiente?
     • Si modificó DATABASE → debe estar en TRAZA-TAREAS-DATABASE
     • Si modificó BACKEND → debe estar en TRAZA-TAREAS-BACKEND
     • Si modificó FRONTEND → debe estar en TRAZA-TAREAS-FRONTEND
     • Todas las tareas → deben estar en TRAZA-EJECUCION-GENERAL

4. Identificar gaps:

   • Tareas completadas NO registradas en trazas
   • Entries en trazas de tareas inexistentes

PASO 3: Validar Documentos de Gobernanza (3 archivos)

Archivos a leer:

1. orchestration/DEPENDENCY-GRAPH.yml
2. orchestration/PROJECT-STATUS.yml
3. orchestration/CONTEXT-MAP.yml

Para cada documento:

1. DEPENDENCY-GRAPH.yml:

   • ¿Tiene sección modules con los 18 módulos?
   • ¿Tiene sección services con los 15 servicios?
   • ¿Dependencias están documentadas?
   • ¿Hay ciclos documentados?
   • Comparar con análisis real de SA-16

2. PROJECT-STATUS.yml:

   • ¿Campo status actualizado?
   • ¿Métricas actuales coinciden con inventarios?
   • ¿Sección gaps documenta issues conocidos?
   • ¿Sección next_steps está actualizada?

3. CONTEXT-MAP.yml:

   • ¿Documenta los 11 OQIs?
   • ¿Mapeo de contextos acotados correcto?
   • ¿Relaciones entre OQIs documentadas?

PASO 4: Validar Índices de Documentación

Archivos a leer:

1. orchestration/tareas/_INDEX.yml
2. orchestration/_MAP.md

Para cada índice:

1. _INDEX.yml (tareas):

   • Listar todas las carpetas en orchestration/tareas/
   • ¿Todas las tareas están indexadas en _INDEX.yml?
   • ¿Hay entries de tareas inexistentes?
   • ¿Metadatos completos? (fecha, estado, prioridad, etc.)

2. _MAP.md:

   • ¿Documenta estructura de orchestration/?
   • ¿Secciones principales presentes? (Inventarios, Trazas, Tareas, Referencias)
   • ¿Links a archivos clave funcionan?
   • ¿Última actualización reciente?

PASO 5: Validar Flujo Tarea → Traza → Inventario

Flujo esperado:

1. Tarea se ejecuta → modifica código
2. Tarea se completa → registro en TRAZA-XXX
3. Tarea actualiza métricas → actualiza INVENTARIO-XXX
4. Inventarios se consolidan → actualiza MASTER_INVENTORY

Validación:

1. Seleccionar tarea reciente completada:

   • Ejemplo: TASK-2026-02-05-ANALISIS-VALIDACION-MODELADO-BD

2. Verificar flujo:

   • ✅ ¿Tarea tiene METADATA.yml con status=completed?
   • ✅ ¿Tarea tiene INFORME-FINAL.md?
   • ✅ ¿Tarea registrada en TRAZA-XXX correspondiente?
   • ✅ ¿Métricas de tarea reflejadas en INVENTARIO-XXX?
   • ✅ ¿MASTER_INVENTORY actualizado con fecha post-tarea?
   • ✅ ¿Tarea indexada en _INDEX.yml?

3. Repetir para 3-5 tareas recientes

4. Identificar gaps en el flujo

PASO 6: Generar Reporte de Trazabilidad

Estructura del reporte:

# Reporte de Trazabilidad e Inventarios

## Resumen Ejecutivo
- **Inventarios evaluados:** 5/5
- **Inventarios sincronizados:** X/5 (XX%)
- **Trazas evaluadas:** 4/4
- **Trazas completas:** X/4 (XX%)
- **Gobernanza evaluada:** 3/3
- **Gobernanza actualizada:** X/3 (XX%)
- **Score global de trazabilidad:** XX%

## PARTE 1: Validación de Inventarios

### 1.1 Estado de Inventarios

| Inventario | Versión | Última Actualización | Campos Obligatorios | Estado |
|------------|---------|---------------------|---------------------|--------|
| MASTER_INVENTORY | 3.1.0 | 2026-02-05 | ✅ Completos | ✅ VIGENTE |
| DATABASE_INVENTORY | 3.0.0 | 2026-02-05 | ✅ Completos | ✅ VIGENTE |
| BACKEND_INVENTORY | 2.1.0 | 2026-02-04 | ⚠️ Falta checksum | ⚠️ PARCIAL |
| FRONTEND_INVENTORY | 1.5.0 | 2026-02-03 | ✅ Completos | ⚠️ DESACTUALIZADO |
| API_INVENTORY | N/A | N/A | N/A | ❌ NO EXISTE |

### 1.2 Coherencia entre Inventarios

| Métrica | MASTER | DATABASE | BACKEND | FRONTEND | Código Real | Estado |
|---------|--------|----------|---------|----------|-------------|--------|
| Schemas DDL | 11 | 11 | N/A | N/A | 11 | ✅ MATCH |
| Tablas DDL | 101 | 101 | N/A | N/A | 101 | ✅ MATCH |
| Entities | 85 | N/A | 85 | N/A | 85 | ✅ MATCH |
| Services | 15 | N/A | 15 | N/A | 15 | ✅ MATCH |
| Controllers | 10 | N/A | 10 | N/A | 10 | ✅ MATCH |
| Components | 50 | N/A | N/A | 50 | 48 | ❌ GAP (-2) |
| Pages | 95 | N/A | N/A | 95 | 92 | ❌ GAP (-3) |
| API Clients | 16 | N/A | N/A | 16 | 16 | ✅ MATCH |

**Coherencia inventarios:** 6/8 métricas MATCH (75%)

### 1.3 Gaps Identificados

**P0-CRITICO:**
- API_INVENTORY.yml NO existe (sin seguimiento de endpoints)

**P1-ALTO:**
- FRONTEND_INVENTORY desactualizado (2 días atrás)
- Components: inventario dice 50, código real 48 (-2)
- Pages: inventario dice 95, código real 92 (-3)

**P2-MEDIO:**
- BACKEND_INVENTORY falta checksums en algunos servicios

---

## PARTE 2: Validación de Trazas

### 2.1 Estado de Trazas

| Traza | Versión | Entries | Última Entry | Estado |
|-------|---------|---------|--------------|--------|
| TRAZA-TAREAS-DATABASE | 1.3.0 | 6 | 2026-02-05 | ✅ ACTUALIZADA |
| TRAZA-TAREAS-BACKEND | 2.2.0 | 9 | 2026-02-05 | ✅ ACTUALIZADA |
| TRAZA-TAREAS-FRONTEND | 1.2.0 | 4 | 2026-02-05 | ✅ ACTUALIZADA |
| TRAZA-EJECUCION-GENERAL | 3.5.0 | 21 | 2026-02-06 | ✅ ACTUALIZADA |

### 2.2 Completitud de Trazas

**Tareas completadas en orchestration/tareas/:** 25 tareas

**Cross-reference Tareas → Trazas:**

| Tarea | DATABASE Traza | BACKEND Traza | FRONTEND Traza | GENERAL Traza | Estado |
|-------|---------------|---------------|----------------|---------------|--------|
| TASK-001-INITIAL | ✅ | ✅ | ✅ | ✅ | COMPLETO |
| TASK-002-SETUP | ✅ | ✅ | ✅ | ✅ | COMPLETO |
| TASK-2026-02-05 | ✅ | ✅ | ✅ | ✅ | COMPLETO |
| TASK-2026-02-06 | N/A | N/A | N/A | ✅ | COMPLETO (solo docs) |
| TASK-XXX | ❌ | ❌ | N/A | ✅ | PARCIAL (faltan trazas específicas) |
| [listar 25 tareas] | | | | | |

**Tareas con trazas completas:** 22/25 (88%)
**Tareas con gaps en trazas:** 3/25 (12%)

### 2.3 Validación de IDs Consecutivos

**TRAZA-TAREAS-DATABASE:**
- IDs: TRAZA-DB-001, TRAZA-DB-002, ..., TRAZA-DB-006
- ✅ Consecutivos, sin saltos

**TRAZA-TAREAS-BACKEND:**
- IDs: TRAZA-BE-001, TRAZA-BE-002, ..., TRAZA-BE-009
- ✅ Consecutivos, sin saltos

[Repetir para las 4 trazas]

### 2.4 Gaps en Trazas

**Tareas NO registradas:**
1. TASK-XXX-YYY: Modificó backend pero NO está en TRAZA-TAREAS-BACKEND
2. TASK-AAA-BBB: Modificó frontend pero NO está en TRAZA-TAREAS-FRONTEND

**Entries de tareas inexistentes:**
- Ninguna detectada ✅

---

## PARTE 3: Validación Gobernanza

### 3.1 DEPENDENCY-GRAPH.yml

**Estado:** ⚠️ PARCIAL
- **Versión:** 2.0.0 (actualizada recientemente)
- **Módulos documentados:** 18/18 ✅
- **Servicios documentados:** 15/15 ✅
- **Dependencias documentadas:** ✅ Sí
- **Ciclos documentados:** ✅ 1 ciclo (trading ↔ portfolio)

**Coherencia con código real (SA-16):**
- Módulos: ✅ Coincide
- Servicios: ✅ Coincide
- Dependencias: ⚠️ Falta documentar 2 dependencias nuevas detectadas

### 3.2 PROJECT-STATUS.yml

**Estado:** ⚠️ DESACTUALIZADO
- **Versión:** 1.2.0
- **Última actualización:** 2026-02-04 (2 días atrás)
- **Métricas coherentes con inventarios:** ⚠️ Parcial (algunas desactualizadas)
- **Sección `gaps`:** ✅ Presente (documenta 37 gaps conocidos)
- **Sección `next_steps`:** ✅ Presente

**Métricas a actualizar:**
- tablas: 98 → 101 (inventario dice 101)
- components: 52 → 48 (código real 48)

### 3.3 CONTEXT-MAP.yml

**Estado:** ✅ ACTUALIZADO
- **Versión:** 1.1.0
- **OQIs documentados:** 11/11 ✅
- **Bounded contexts:** ✅ Definidos
- **Relaciones OQI:** ✅ Documentadas

**Coherencia con OQIs reales:** ✅ 100%

---

## PARTE 4: Validación de Índices

### 4.1 orchestration/tareas/_INDEX.yml

**Estado:** ⚠️ INCOMPLETO
- **Tareas en filesystem:** 25
- **Tareas indexadas:** 22
- **Tareas sin indexar:** 3

**Tareas faltantes en índice:**
1. TASK-2026-01-XX-XXXXX
2. TASK-2026-02-01-YYYYY
3. TASK-2026-02-06-ANALISIS-INTEGRAL-DOCUMENTACION (esta misma tarea)

### 4.2 orchestration/_MAP.md

**Estado:** ⚠️ PARCIAL
- **Última actualización:** 2026-01-30 (7 días atrás)
- **Secciones principales:** ✅ Presentes
- **Links funcionan:** ⚠️ 3 links rotos detectados
- **Documentos de análisis clasificados:** ⚠️ Falta sección (pendiente SA-12)

---

## PARTE 5: Validación Flujo Tarea → Traza → Inventario

### Caso 1: TASK-2026-02-05-ANALISIS-VALIDACION-MODELADO-BD

**Flujo:**
1. ✅ METADATA.yml: status=completed
2. ✅ INFORME-FINAL.md: Presente (13 deliverables)
3. ✅ TRAZA-TAREAS-DATABASE: Entry TRAZA-DB-006
4. ✅ TRAZA-TAREAS-BACKEND: Entry TRAZA-BE-008, TRAZA-BE-009
5. ✅ DATABASE_INVENTORY: v3.0.0 (2026-02-05) - Post-tarea
6. ✅ MASTER_INVENTORY: v3.1.0 (2026-02-05) - Consolidado
7. ✅ _INDEX.yml: Tarea indexada

**Estado:** ✅ FLUJO COMPLETO

### Caso 2: TASK-002-INITIAL-SETUP

**Flujo:**
1. ✅ METADATA.yml: status=completed
2. ✅ INFORME-FINAL.md: Presente
3. ✅ TRAZA-EJECUCION-GENERAL: Entry TRAZA-GEN-002
4. ⚠️ Deliverables: Algunos NO integrados en ubicaciones finales
5. ❌ _INDEX.yml: Metadata incompleto (falta fecha_fin)

**Estado:** ⚠️ FLUJO PARCIAL

[Repetir para 3-5 tareas]

### Resumen de Flujos Validados

| Tarea | Metadata | Informe | Traza | Inventario | Índice | Estado |
|-------|----------|---------|-------|------------|--------|--------|
| TASK-2026-02-05 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ COMPLETO |
| TASK-002 | ✅ | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ PARCIAL |
| [otros] | | | | | | |

**Flujos completos:** 3/5 (60%)

---

## PARTE 6: Métricas Consolidadas

### Score de Trazabilidad por Componente

| Componente | Score | Estado |
|------------|-------|--------|
| Inventarios (sincronización) | 75% | ⚠️ MEDIO |
| Trazas (completitud) | 88% | ✅ ALTO |
| Gobernanza (actualización) | 67% | ⚠️ MEDIO |
| Índices (cobertura) | 70% | ⚠️ MEDIO |
| Flujo Tarea→Traza→Inv | 60% | ⚠️ MEDIO |

**SCORE GLOBAL DE TRAZABILIDAD:** 72% (MEDIO)

---

## PARTE 7: Gaps Consolidados

### P0-CRITICO
1. **API_INVENTORY.yml NO existe** - Sin seguimiento de endpoints
2. **3 tareas sin indexar** en _INDEX.yml
3. **FRONTEND_INVENTORY desactualizado** (components/pages gaps)

### P1-ALTO
1. **PROJECT-STATUS.yml desactualizado** (métricas desfasadas)
2. **_MAP.md con 3 links rotos**
3. **DEPENDENCY-GRAPH.yml falta 2 dependencias** nuevas
4. **3 tareas con trazas incompletas**

### P2-MEDIO
1. **BACKEND_INVENTORY falta checksums** en algunos servicios
2. **TASK-002 deliverables no integrados** completamente
3. **_MAP.md sin sección de análisis** (pendiente SA-12)

---

## PARTE 8: Recomendaciones

### Acciones Inmediatas (P0)
1. Crear `API_INVENTORY.yml` usando datos de SA-17
2. Actualizar `_INDEX.yml` con 3 tareas faltantes
3. Actualizar `FRONTEND_INVENTORY.yml` (corregir components: 48, pages: 92)

### Acciones Importantes (P1)
1. Actualizar `PROJECT-STATUS.yml` con métricas actuales de inventarios
2. Fix 3 links rotos en `_MAP.md`
3. Actualizar `DEPENDENCY-GRAPH.yml` con dependencias faltantes
4. Completar entries de trazas para 3 tareas

### Mejoras (P2)
1. Agregar checksums faltantes en `BACKEND_INVENTORY.yml`
2. Integrar deliverables de TASK-002
3. Ejecutar SA-12 para clasificar análisis en `_MAP.md`

---

## PARTE 9: Plan de Remediación

**Sprint corto (2-3 horas):**
1. SA-XX: Crear API_INVENTORY.yml
2. SA-YY: Update FRONTEND_INVENTORY.yml
3. SA-ZZ: Update _INDEX.yml + PROJECT-STATUS.yml + _MAP.md (fixes)

**Validación final:**
- Re-ejecutar SA-18 después de remediación
- Target: Score global 85%+

Restricciones

• MODO READ-ONLY: NO modificar ningún archivo
• Leer TODOS los archivos de inventarios, trazas, gobernanza
• Cross-reference exhaustivo entre documentos
• Generar métricas porcentuales precisas
• Reporte markdown muy estructurado y completo

Output Esperado

Un reporte markdown EXHAUSTIVO con:

• 9 partes (Inventarios, Trazas, Gobernanza, Índices, Flujos, Métricas, Gaps, Recomendaciones, Plan)
• Tablas comparativas detalladas
• Score global de trazabilidad
• Gaps clasificados por prioridad
• Plan de remediación accionable
• ~500-800 líneas de reporte

Archivo de salida: Documento temporal o reporte directo al orquestador.

Compromiso: Generar auditoría COMPLETA de trazabilidad e inventarios con máximo detalle.