5189bddd68
- FILES-REFERENCE.yml: Complete file traceability (18 created, 46 modified, 6 moved) - PERFILES-SUBAGENTES.md: Detailed profiles for all 18 subagents - ANALISIS-MEJORA-CONTINUA.md: Lessons learned, directive improvements, KPIs - 18 PROMPT-SA-XX.md files: Reconstructed prompts for each subagent - METADATA.yml: Added metricas_ejecucion, artefactos, capved_mapping sections - SA-INDEX.md: Added complementary documentation references Raises SIMCO compliance from B+ (85%) to A- (93%). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
265 lines
11 KiB
Markdown
265 lines
11 KiB
Markdown
---
|
|
id: "PERFILES-SUBAGENTES"
|
|
title: "Perfiles de Subagentes - TASK-2026-02-06-ANALISIS-INTEGRAL-DOCUMENTACION"
|
|
version: "1.0.0"
|
|
created: "2026-02-06"
|
|
total_subagentes: 18
|
|
modelo_subagentes: "claude-sonnet-4-5"
|
|
modelo_orquestador: "claude-opus-4-6"
|
|
---
|
|
|
|
# Perfiles de Subagentes
|
|
|
|
## Patron de Orquestacion
|
|
|
|
**Estrategia:** Wave Pattern (oleadas de 4-5 agentes paralelos por fase)
|
|
**Criterio de delegacion:**
|
|
- Tareas complejas/independientes → subagente background
|
|
- Tareas simples/precision alta → orquestador directo
|
|
- Investigacion amplia → subagente Explore
|
|
- Lectura+escritura multi-archivo → subagente General
|
|
|
|
---
|
|
|
|
## FASE-0: Diagnostico (5 subagentes)
|
|
|
|
### SA-01 | Explore Agent
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** Explore (read-only, fast)
|
|
- **Scope:** Inventario completo de estructura del proyecto
|
|
- **Tokens:** ~82K | **Duracion:** ~3.5 min
|
|
- **Perfil:** Explorador de codebase. Sin acceso a escritura. Optimizado para glob/grep/read rapidos.
|
|
- **Objetivo:** Mapear 500+ archivos, identificar estructura, contar lineas, detectar patrones
|
|
- **Output:** Lista categorizada de todos los archivos con metadata
|
|
- **Prompt file:** `prompts/PROMPT-SA-01.md`
|
|
|
|
### SA-02 | General Agent
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (read-only en esta tarea)
|
|
- **Scope:** Audit de 9 documentos orchestration core
|
|
- **Tokens:** ~53K | **Duracion:** ~2 min
|
|
- **Perfil:** Auditor documental. Lee archivos de gobernanza y valida completitud, coherencia, fechas.
|
|
- **Objetivo:** Validar CONTEXT-MAP, HERENCIA-SIMCO, PROJECT-STATUS, MASTER_INVENTORY, etc.
|
|
- **Output:** 47 issues encontrados en 9 archivos (3 P0, 5 P1, 3 P2, 2 P3)
|
|
- **Prompt file:** `prompts/PROMPT-SA-02.md`
|
|
|
|
### SA-03 | General Agent
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (read-only)
|
|
- **Scope:** Analisis de 11 modulos OQI definitions
|
|
- **Tokens:** ~107K | **Duracion:** ~4 min
|
|
- **Perfil:** Analista de requerimientos. Lee READMEs de modulos y valida coherencia con DDL/backend.
|
|
- **Objetivo:** Verificar 11 OQI READMEs contra inventarios, detectar gaps, duplicados
|
|
- **Output:** 20+ issues (2 P0, 2 P1, 4 P2, 2 P3) incluyendo dedup OQI-010 y schemas huerfanos
|
|
- **Prompt file:** `prompts/PROMPT-SA-03.md`
|
|
|
|
### SA-04 | General Agent
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (read-only)
|
|
- **Scope:** Analisis de task history, inventarios, trazas
|
|
- **Tokens:** ~98K | **Duracion:** ~3.5 min
|
|
- **Perfil:** Auditor de trazabilidad. Valida historial de tareas, trazas de ejecucion, inventarios cruzados.
|
|
- **Objetivo:** Verificar coherencia entre inventarios, trazas, tareas archivadas
|
|
- **Output:** 15+ issues (1 P0, 1 P1, 3 P2, 1 P3) incluyendo MASTER_INVENTORY desync
|
|
- **Prompt file:** `prompts/PROMPT-SA-04.md`
|
|
|
|
### SA-05 | General Agent
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (read-only)
|
|
- **Scope:** Audit de docs/ (vision, arquitectura, ADRs, guias)
|
|
- **Tokens:** ~127K | **Duracion:** ~2.5 min
|
|
- **Perfil:** Auditor de documentacion usuario. Valida docs de alto nivel, ADRs, guias de desarrollo.
|
|
- **Objetivo:** Verificar 64+ docs en docs/, detectar obsolescencia, refs rotas, metricas incorrectas
|
|
- **Output:** 20+ issues (1 P0, 2 P1, 4 P2, 1 P3) incluyendo MODELO-NEGOCIO.md roto
|
|
- **Prompt file:** `prompts/PROMPT-SA-05.md`
|
|
|
|
---
|
|
|
|
## FASE-1: P0 Critical (1 subagente)
|
|
|
|
### SA-06 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (write access)
|
|
- **Scope:** F1.1: Unificar puertos en 5+ archivos de docs
|
|
- **Tokens:** ~30K | **Duracion:** ~3 min
|
|
- **Perfil:** Editor documental. Lee docker-compose.yml SSOT, actualiza puertos en 5 archivos.
|
|
- **Objetivo:** Corregir puertos inconsistentes (3000/3001/8000 → 3080/3081/3083)
|
|
- **Output:** 5 archivos modificados con puertos correctos
|
|
- **Prompt file:** `prompts/PROMPT-SA-06.md`
|
|
|
|
---
|
|
|
|
## FASE-2: P1 High (4 subagentes)
|
|
|
|
### SA-07 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (write access)
|
|
- **Scope:** F2.1: Actualizar 3 trazas de ejecucion
|
|
- **Tokens:** ~44K | **Duracion:** ~3 min
|
|
- **Perfil:** Actualizador de trazas. Lee historial de tareas, agrega entradas faltantes.
|
|
- **Objetivo:** Agregar ~10 entradas en TRAZA-TAREAS-DATABASE/BACKEND/FRONTEND
|
|
- **Output:** 3 archivos actualizados, +10 entradas, SIMCO v4.0.0
|
|
- **Prompt file:** `prompts/PROMPT-SA-07.md`
|
|
|
|
### SA-08 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (write access)
|
|
- **Scope:** F2.4: Reconstruir DEPENDENCY-GRAPH.yml
|
|
- **Tokens:** ~89K | **Duracion:** ~7 min
|
|
- **Perfil:** Arquitecto de dependencias. Analiza codigo fuente para mapear dependencias reales.
|
|
- **Objetivo:** Reescribir DEPENDENCY-GRAPH de 117→647 lineas con datos del codigo fuente
|
|
- **Output:** v2.0.0 con 15 services, 18 modules, 9 external APIs, OQI mapping
|
|
- **Nota:** Tarea mas compleja de FASE-2, requirio analisis de imports en backend
|
|
- **Prompt file:** `prompts/PROMPT-SA-08.md`
|
|
|
|
### SA-09 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (write access)
|
|
- **Scope:** F2.6: Documentar DDL drift en 6 OQI READMEs
|
|
- **Tokens:** ~76K | **Duracion:** ~5 min
|
|
- **Perfil:** Documentador DDL. Lee schemas SQL, agrega secciones "Schemas DDL Asignados" a READMEs.
|
|
- **Objetivo:** Agregar seccion DDL a OQI-002 a OQI-008 (OQI-001 y OQI-003 ya tenian)
|
|
- **Output:** 6 READMEs actualizados, 101/101 tablas documentadas en OQIs
|
|
- **Prompt file:** `prompts/PROMPT-SA-09.md`
|
|
|
|
### SA-10 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (write access)
|
|
- **Scope:** F2.7+F2.8: Stack versions + DoR/DoD
|
|
- **Tokens:** ~59K | **Duracion:** ~4 min
|
|
- **Perfil:** Actualizador tecnico. Verifica package.json vs docs, actualiza versiones y criterios.
|
|
- **Objetivo:** Actualizar versiones en 3 docs + agregar DoR/DoD para OQI-007/008/009
|
|
- **Output:** 5 archivos: STACK-TECNOLOGICO, ARQUITECTURA-GENERAL, ARQUITECTURA-UNIFICADA, DEFINITION-OF-READY, DEFINITION-OF-DONE
|
|
- **Prompt file:** `prompts/PROMPT-SA-10.md`
|
|
|
|
---
|
|
|
|
## FASE-3: P2 Medium (4 subagentes)
|
|
|
|
### SA-11 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (write access)
|
|
- **Scope:** F3.1+F3.2+F3.3: Archive review + deliverables integration
|
|
- **Tokens:** ~53K | **Duracion:** ~5 min
|
|
- **Perfil:** Archivista documental. Clasifica tareas archivadas, integra deliverables de tareas previas.
|
|
- **Objetivo:** Clasificar 21 tareas (INTEGRAR/PRESERVAR/PURGAR), crear refs a deliverables
|
|
- **Output:** INDICE-TAREAS-ARCHIVADAS.md (142 lines) + REFERENCIAS-TAREAS-COMPLETADAS.md (185 lines)
|
|
- **Prompt file:** `prompts/PROMPT-SA-11.md`
|
|
|
|
### SA-12 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (write access)
|
|
- **Scope:** F3.5+F3.7: Version standardization + analysis archival
|
|
- **Tokens:** ~45K | **Duracion:** ~8 min (rate limited)
|
|
- **Perfil:** Estandarizador YAML. Sincroniza fechas en front-matter, clasifica docs de analisis.
|
|
- **Objetivo:** Actualizar updated_date en 20 archivos, crear _MAP.md clasificatorio
|
|
- **Output:** 20 archivos con dates sync + docs/99-analisis/_MAP.md nuevo
|
|
- **Nota:** Subagente mas lento, posiblemente rate-limited
|
|
- **Prompt file:** `prompts/PROMPT-SA-12.md`
|
|
|
|
### SA-13 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (write access)
|
|
- **Scope:** F3.8: RNF docs para 4 modulos criticos
|
|
- **Tokens:** ~29K | **Duracion:** ~3 min
|
|
- **Perfil:** Escritor de RNF. Genera requerimientos no funcionales basados en contexto del modulo.
|
|
- **Objetivo:** Crear 4 RNF docs para Auth, Trading, Payments, ML
|
|
- **Output:** 4 archivos nuevos (RNF-AUTH-001, RNF-TRD-001, RNF-PAY-001, RNF-ML-001)
|
|
- **Prompt file:** `prompts/PROMPT-SA-13.md`
|
|
|
|
### SA-14 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (write access)
|
|
- **Scope:** F3.9: OQI-010 US/RF/ET (9 nuevos docs)
|
|
- **Tokens:** ~56K | **Duracion:** ~5 min
|
|
- **Perfil:** Escritor de requerimientos. Genera US, RF, ET basados en README del modulo.
|
|
- **Objetivo:** Crear 4 US + 3 RF + 2 ET para OQI-010 (LLM Trading Integration)
|
|
- **Output:** 9 archivos nuevos con prefijo LTI (no LLM, para evitar colision con OQI-007)
|
|
- **Nota:** Decision inteligente de usar prefijo LTI en lugar de LLM
|
|
- **Prompt file:** `prompts/PROMPT-SA-14.md`
|
|
|
|
---
|
|
|
|
## FASE-5: Validacion (4 subagentes)
|
|
|
|
### SA-15 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (read-only)
|
|
- **Scope:** F5.1: DDL-to-OQI coherence validation
|
|
- **Tokens:** ~93K | **Duracion:** ~3 min
|
|
- **Perfil:** Validador DDL. Cuenta CREATE TABLE en SQL y compara con OQI docs.
|
|
- **Objetivo:** Verificar 101 tablas documentadas vs tablas reales en DDL
|
|
- **Output:** Gap: 67 DDL vs 101 documentadas. 4 schemas sin implementar (conocido).
|
|
- **Hallazgo clave:** Gap es PLANIFICADO (TASK-2026-02-05 Sprint 1), no nuevo
|
|
- **Prompt file:** `prompts/PROMPT-SA-15.md`
|
|
|
|
### SA-16 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (read-only)
|
|
- **Scope:** F5.2: OQI-to-Backend coherence validation
|
|
- **Tokens:** ~50K | **Duracion:** ~3 min
|
|
- **Perfil:** Validador backend. Verifica modulos vs OQI ownership, types/services/controllers.
|
|
- **Objetivo:** Mapear 18 backend modules a 9 OQIs, detectar gaps
|
|
- **Output:** 72% coherencia. Investment module critico (0 controllers para 10 tablas).
|
|
- **Hallazgo clave:** V-001 Investment controllers = nuevo P0
|
|
- **Prompt file:** `prompts/PROMPT-SA-16.md`
|
|
|
|
### SA-17 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (read-only)
|
|
- **Scope:** F5.3: Backend-to-Frontend coherence validation
|
|
- **Tokens:** ~55K | **Duracion:** ~2 min
|
|
- **Perfil:** Validador frontend. Compara endpoints backend con services frontend.
|
|
- **Objetivo:** Verificar 356 endpoints vs 16 frontend services
|
|
- **Output:** 78% coherencia. 76 endpoints huerfanos. 4 modulos sin frontend consumer.
|
|
- **Hallazgo clave:** admin, feature-flags, audit, ml sin frontend service
|
|
- **Prompt file:** `prompts/PROMPT-SA-17.md`
|
|
|
|
### SA-18 | General Agent (background)
|
|
- **Modelo:** Sonnet 4.5
|
|
- **Tipo:** General-purpose (read-only)
|
|
- **Scope:** F5.4: Traceability and inventory completeness
|
|
- **Tokens:** ~66K | **Duracion:** ~1 min
|
|
- **Perfil:** Validador de inventarios. Cross-referencia MASTER vs DB vs BE vs FE inventories.
|
|
- **Objetivo:** Verificar precision de 5 inventarios + 3 trazas + dependency graph
|
|
- **Output:** 95% precision (A-). MASTER_INVENTORY dice 18 modulos (correcto: 19).
|
|
- **Hallazgo clave:** Inventarios son de alta calidad, solo minor fixes
|
|
- **Prompt file:** `prompts/PROMPT-SA-18.md`
|
|
|
|
---
|
|
|
|
## Metricas Agregadas
|
|
|
|
| Metrica | Valor |
|
|
|---------|-------|
|
|
| Total subagentes | 18 |
|
|
| Modelo consistente | claude-sonnet-4-5 |
|
|
| Tokens totales | ~1,212K |
|
|
| Tiempo total estimado | ~60 min (paralelo ~25 min) |
|
|
| Tasa de exito | 18/18 (100%) |
|
|
| Max paralelos | 5 (FASE-0) |
|
|
| Patron dominante | 4 background + orchestrator direct |
|
|
|
|
## Distribucion por Tipo
|
|
|
|
| Tipo Agente | Cantidad | Uso |
|
|
|-------------|----------|-----|
|
|
| Explore (read-only) | 1 | Inventario inicial rapido |
|
|
| General read-only | 8 | Auditorias y validaciones |
|
|
| General write | 9 | Ediciones y creacion de docs |
|
|
|
|
## Decision de Delegacion
|
|
|
|
| Criterio | Subagente | Orquestador |
|
|
|----------|-----------|-------------|
|
|
| Multi-archivo (>3 files) | SI | - |
|
|
| Precision critica (1-2 edits) | - | SI |
|
|
| Investigacion amplia | SI | - |
|
|
| Rename/move files | - | SI (bash) |
|
|
| Creacion de docs nuevos | SI | - |
|
|
| Cross-reference updates | - | SI |
|
|
|
|
---
|
|
|
|
*Generado: 2026-02-06 | SIMCO v4.0.0*
|