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

id	agent_id	model	type	fase	scope	mode	created
PROMPT-SA-10	SA-10	claude-sonnet-4.5	General background	FASE-2	Update stack versions + DoR/DoD en 3 OQI docs	write	2026-02-06

PROMPT-SA-10: Update Stack Versions + DoR/DoD (P1)

Contexto

Eres un agente ejecutor de actualizaciones documentales. Se han identificado 2 gaps P1:

1. Versiones de stack obsoletas en documentos de arquitectura
2. Falta DoR/DoD (Definition of Ready / Definition of Done) en 3 módulos OQI críticos

Proyecto: trading-platform

Stack actual (SSOT):

• Backend: Express.js 5.x + TypeScript 5.x
• Frontend: React 18.x + Vite 5.x + TypeScript 5.x
• Database: PostgreSQL 16.x
• Cache: Redis 7.x
• ML Service: FastAPI 0.1xx + Python 3.11+

Fuente de verdad para versiones:

• apps/backend/package.json
• apps/frontend/package.json
• apps/ml-service/pyproject.toml o requirements.txt
• docker-compose.yml

Instrucciones

TAREA 1: Actualizar versiones de stack (3 archivos)

Archivos a corregir:

1. docs/arquitectura/STACK-TECNOLOGICO.md
2. docs/arquitectura/ARQUITECTURA-GENERAL.md
3. orchestration/PROJECT-STATUS.yml (sección stack)

Procedimiento:

1. Leer archivos de configuración SSOT:

   • apps/backend/package.json → Extraer versiones de express, typescript, etc.
   • apps/frontend/package.json → Extraer versiones de react, vite, typescript, etc.
   • apps/ml-service/requirements.txt → Extraer versión de fastapi, python
   • docker-compose.yml → Verificar versiones de postgres, redis

2. Para cada uno de los 3 archivos a corregir:

   • Leer archivo actual
   • Identificar secciones que mencionan versiones de stack
   • Editar ÚNICAMENTE las versiones incorrectas usando Edit (old_string/new_string)
   • NO cambiar formato ni estructura

3. Validar que todas las versiones estén correctas

TAREA 2: Agregar DoR/DoD en 3 OQI READMEs

Archivos a modificar:

1. docs/modulos-negocio/definitions/OQI-007-ML/README.md
2. docs/modulos-negocio/definitions/OQI-008-INVESTMENT/README.md
3. docs/modulos-negocio/definitions/OQI-009-AUDIT/README.md

Procedimiento:

Para cada README:

1. Leer README actual
2. Agregar sección "Definition of Ready (DoR)" al final del documento:

## Definition of Ready (DoR)

Una User Story de este módulo está lista para desarrollo cuando:

- [ ] **Requisitos claros:** La funcionalidad está descrita sin ambigüedades
- [ ] **Diseño de datos:** Se han identificado entidades, campos y relaciones
- [ ] **APIs definidas:** Endpoints necesarios están especificados (request/response)
- [ ] **Criterios de aceptación:** Condiciones de éxito están documentadas
- [ ] **Dependencias resueltas:** Módulos/servicios dependientes están disponibles
- [ ] **Estimación completada:** El equipo ha estimado el esfuerzo
- [ ] **Sin bloqueadores:** No hay impedimentos técnicos conocidos

3. Agregar sección "Definition of Done (DoD)":

## Definition of Done (DoD)

Una User Story de este módulo está completa cuando:

**Código:**
- [ ] **Implementación completa:** Toda la funcionalidad descrita está desarrollada
- [ ] **Code review aprobado:** Al menos 1 revisor ha aprobado los cambios
- [ ] **Estándares de código:** Cumple con guías de estilo y buenas prácticas
- [ ] **Sin deuda técnica:** No quedan TODOs ni placeholders sin resolver

**Base de Datos:**
- [ ] **DDL actualizado:** Schemas, tablas, índices están en archivos .sql
- [ ] **Migraciones creadas:** Scripts de migración están listos
- [ ] **Datos de prueba:** Existen seeds para testing

**Testing:**
- [ ] **Unit tests:** Cobertura ≥80% en servicios críticos
- [ ] **Integration tests:** Endpoints probados con casos reales
- [ ] **Tests pasando:** `npm run test` sin errores
- [ ] **Manual testing:** Funcionalidad verificada en ambiente local

**Documentación:**
- [ ] **README actualizado:** Si aplica, documentar nuevas funcionalidades
- [ ] **API docs:** Endpoints documentados en Swagger/OpenAPI
- [ ] **Comentarios en código:** Lógica compleja explicada

**Deployment:**
- [ ] **Build exitoso:** `npm run build` sin errores
- [ ] **Lint pasando:** `npm run lint` sin warnings críticos
- [ ] **Variables de entorno:** Documentadas en .env.example si se agregan nuevas
- [ ] **Docker funcional:** `docker-compose up` levanta el servicio correctamente

**Aprobación:**
- [ ] **Product Owner aprobó:** La funcionalidad cumple requisitos de negocio
- [ ] **Merged a main:** Pull Request aprobado y mergeado

4. Usar Edit para agregar las 2 secciones al final de cada README

Restricciones

• MODO WRITE: Modificar solo los 6 archivos especificados (3 stack + 3 OQI)
• EDICIÓN SEGURA: Cambios mínimos y precisos
• PROHIBIDO: Placeholders, cambios de formato
• OBLIGATORIO: Verificar versiones reales desde package.json/docker-compose
• DoR/DoD deben ser específicos del módulo, NO genéricos

Output Esperado

## TAREA 1: Versiones de Stack Actualizadas

### Versiones Correctas (desde package.json/docker-compose)
- Express.js: 5.0.1
- React: 18.2.0
- TypeScript: 5.3.3
- Vite: 5.0.10
- FastAPI: 0.109.0
- PostgreSQL: 16.1
- Redis: 7.2.3

### Archivos Corregidos

#### 1. STACK-TECNOLOGICO.md
**Cambios:**
- Express: 4.x → 5.0.1
- React: 17.x → 18.2.0
- PostgreSQL: 15.x → 16.1

#### 2. ARQUITECTURA-GENERAL.md
**Cambios:**
- [lista de cambios]

#### 3. PROJECT-STATUS.yml
**Cambios:**
- [lista de cambios]

## TAREA 2: DoR/DoD Agregados

### OQI-007-ML/README.md
**Secciones agregadas:**
- Definition of Ready (DoR) - 7 criterios
- Definition of Done (DoD) - 20 criterios en 5 categorías

### OQI-008-INVESTMENT/README.md
**Secciones agregadas:**
- [similar]

### OQI-009-AUDIT/README.md
**Secciones agregadas:**
- [similar]

## Validación
✅ 3 archivos de stack actualizados con versiones reales
✅ 3 OQI READMEs con DoR/DoD completos
✅ Total: 6 archivos modificados
✅ Formato markdown válido

Compromiso: Actualizar 6 archivos (3 stack + 3 DoR/DoD) con información precisa y verificada.