--- 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*