rckrdmrd/trading-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
5189bddd68
trading-platform/orchestration/tareas/TASK-2026-02-06-ANALISIS-INTEGRAL-DOCUMENTACION/subagentes/PERFILES-SUBAGENTES.md
Adrian Flores Cortes 5189bddd68 [TASK-2026-02-06-ANALISIS-INTEGRAL-DOCUMENTACION] docs: Add SIMCO compliance artifacts 
- 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>
2026-02-06 11:26:21 -06:00

11 KiB
Raw Blame History

id title version created total_subagentes modelo_subagentes modelo_orquestador
PERFILES-SUBAGENTES Perfiles de Subagentes - TASK-2026-02-06-ANALISIS-INTEGRAL-DOCUMENTACION 1.0.0 2026-02-06 18 claude-sonnet-4-5 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