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

id	agent_id	model	type	fase	scope	mode	created
PROMPT-SA-08	SA-08	claude-sonnet-4.5	General background	FASE-2	Rebuild DEPENDENCY-GRAPH.yml v2.0.0	write	2026-02-06

PROMPT-SA-08: Rebuild DEPENDENCY-GRAPH.yml v2.0.0 (P1)

Contexto

Eres un agente ejecutor de análisis de dependencias. Se ha identificado un gap P1-ALTO: el archivo DEPENDENCY-GRAPH.yml está obsoleto o inexistente, y necesita ser reconstruido desde el análisis real del código fuente.

Proyecto: trading-platform Stack: Express.js 5 + TypeScript (backend), React 18 + TypeScript (frontend)

Objetivo: Generar orchestration/DEPENDENCY-GRAPH.yml v2.0.0 con el grafo completo de dependencias entre módulos del proyecto.

Instrucciones

PASO 1: Analizar dependencias Backend

1. Listar todos los servicios backend:

   • Ubicación: apps/backend/src/services/
   • Usar Glob para encontrar todos los *.service.ts
   • Contar: ~15 servicios esperados

2. Para cada servicio, identificar imports:

   • Leer cada archivo .service.ts
   • Buscar líneas import { XXX } from './otro-servicio' o from '../otro-modulo'
   • Identificar dependencias entre servicios
   • Identificar dependencias con tipos/interfaces compartidos

3. Identificar módulos:

   • Ubicación: apps/backend/src/modules/ (si existen)
   • O inferir módulos desde estructura de carpetas
   • ~18 módulos esperados (auth, trading, market-data, portfolio, etc.)

PASO 2: Analizar dependencias Frontend

1. Listar componentes y páginas principales:

   • apps/frontend/src/pages/
   • apps/frontend/src/components/

2. Identificar API clients y su uso:

   • apps/frontend/src/services/ o src/api/
   • Ver qué páginas/componentes consumen qué servicios

3. Mapear dependencias frontend → backend:

   • Qué páginas llaman a qué endpoints/servicios backend

PASO 3: Identificar dependencias cross-module

1. Trading → Market Data (ej: obtener precios para órdenes)
2. Portfolio → Trading (ej: calcular posiciones desde órdenes)
3. Auth → [todos] (casi todo depende de autenticación)
4. Payments → Trading (ej: depósitos para trading)
5. Etc.

PASO 4: Generar DEPENDENCY-GRAPH.yml

Estructura del archivo:

version: "2.0.0"
project: trading-platform
updated: "2026-02-06"
description: "Grafo de dependencias entre módulos del proyecto"

metadata:
  total_modules: 18
  total_services: 15
  analysis_date: "2026-02-06"
  analysis_tool: "Manual source code analysis"

# Módulos de negocio
modules:
  - id: auth
    name: "Authentication & Authorization"
    layer: backend
    depends_on:
      - audit
      - feature-flags
    dependents:
      - trading
      - portfolio
      - payments
      - [casi todos]

  - id: trading
    name: "Trading Operations"
    layer: backend
    depends_on:
      - auth
      - market-data
      - portfolio
      - audit
    dependents:
      - portfolio
      - payments

  # [repetir para 18 módulos]

# Servicios backend
services:
  - id: auth-service
    file: "apps/backend/src/services/auth.service.ts"
    module: auth
    depends_on:
      - user-service
      - token-service
    dependents:
      - trading-service
      - portfolio-service

  # [repetir para 15 servicios]

# Dependencias frontend → backend
frontend_to_backend:
  - frontend_component: "TradingDashboard"
    backend_services:
      - trading-service
      - market-data-service
      - portfolio-service

  # [mapear principales páginas]

# Dependencias críticas (ciclos, alto acoplamiento)
critical_dependencies:
  - type: "circular"
    modules: [trading, portfolio]
    description: "Trading actualiza portfolio, portfolio consulta trading"
    severity: medium

  - type: "high_coupling"
    module: auth
    dependents_count: 16
    description: "Casi todos los módulos dependen de auth"
    severity: low

PASO 5: Validar y escribir archivo

1. Si DEPENDENCY-GRAPH.yml existe: leer versión anterior, comparar cambios
2. Si NO existe: crear nuevo archivo
3. Escribir usando herramienta Write
4. Validar YAML con grep o similar

Restricciones

• MODO WRITE: Crear/sobrescribir solo orchestration/DEPENDENCY-GRAPH.yml
• ANÁLISIS REAL: Basarse en imports reales del código, NO asumir
• NO EJECUTAR: No correr builds ni tests, solo análisis estático
• Usar Glob + Read para análisis de código
• Formato YAML válido obligatorio

Output Esperado

## Resumen del Análisis

### Módulos Identificados: 18
- auth, trading, market-data, portfolio, payments, education, ml, llm, audit, investment, financial, feature-flags, etc.

### Servicios Backend: 15
- auth.service.ts, trading.service.ts, market-data.service.ts, etc.

### Dependencias Críticas: 3
1. Ciclo: trading ↔ portfolio (MEDIUM)
2. Alto acoplamiento: auth → 16 módulos (LOW)
3. [otra si existe]

### Archivo Generado
- **Ubicación:** `orchestration/DEPENDENCY-GRAPH.yml`
- **Versión:** 2.0.0
- **Tamaño:** ~300 líneas
- **Formato:** YAML válido ✅

## Cambios vs. Versión Anterior
[si existía archivo previo, listar diferencias]

## Validación
✅ YAML válido
✅ 18 módulos documentados
✅ 15 servicios mapeados
✅ Dependencias verificadas en código fuente

Compromiso: Generar DEPENDENCY-GRAPH.yml v2.0.0 completo con análisis real del código.