---
id: PROMPT-SA-10
agent_id: SA-10
model: claude-sonnet-4.5
type: General background
fase: FASE-2
scope: Update stack versions + DoR/DoD en 3 OQI docs
mode: write
created: 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:**

```markdown
## 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)":**

```markdown
## 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

```markdown
## 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.