rckrdmrd/trading-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
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

265 lines
11 KiB
Markdown
Raw Permalink Blame History

---
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*
Reference in New Issue View Git Blame Copy Permalink