---
id: PROMPT-SA-06
agent_id: SA-06
model: claude-sonnet-4.5
type: General background
fase: FASE-1
scope: Fix ports en 5 docs usando docker-compose.yml como SSOT
mode: write
created: 2026-02-06
---

# PROMPT-SA-06: Fix Ports en Documentación (P0)

## Contexto

Eres un agente ejecutor de fixes documentales. Se ha identificado un gap P0-CRITICO: **inconsistencia de puertos** entre la documentación y la configuración real en `docker-compose.yml`.

**Proyecto:** trading-platform
**Gap:** Los puertos documentados en 5 archivos NO coinciden con los puertos reales definidos en `docker-compose.yml`

**SSOT (Single Source of Truth):** `projects/trading-platform/docker-compose.yml`

**Archivos a corregir:**
1. `docs/arquitectura/PUERTOS-SERVICIOS.md`
2. `docs/arquitectura/ARQUITECTURA-GENERAL.md`
3. `docs/arquitectura/ARQUITECTURA-UNIFICADA.md`
4. `docs/arquitectura/DIAGRAMA-INTEGRACIONES.md`
5. `orchestration/CLAUDE.md` (sección "Ambiente Local")

## Instrucciones

### PASO 1: Leer SSOT

1. Leer `docker-compose.yml`
2. Extraer todos los puertos expuestos de servicios:
   - backend (Express)
   - frontend (React/Vite)
   - ml-service (FastAPI)
   - postgres
   - redis
   - nginx (si existe)

### PASO 2: Corregir cada archivo

Para cada uno de los 5 archivos:

1. **Leer el archivo actual** usando la herramienta Read
2. **Identificar las secciones que mencionan puertos**
3. **Editar ÚNICAMENTE las líneas con puertos incorrectos**
   - Usar herramienta Edit con old_string/new_string preciso
   - NO usar placeholders como "..." o "// resto del contenido"
   - Cambiar SOLO los números de puerto
4. **Preservar TODO el resto del contenido exactamente igual**

### PASO 3: Validar

Después de cada edición:
- Usar `grep -n "port\|PORT\|:[0-9]" [archivo]` para verificar que todos los puertos están correctos
- NO ejecutar validaciones de build o lint

## Restricciones

- **MODO WRITE:** Modificar solo los 5 archivos especificados
- **EDICIÓN SEGURA:** Cambios mínimos, <10 líneas por archivo
- **PROHIBIDO:** Placeholders, elipsis, cambios de formato
- **OBLIGATORIO:** Usar Edit con old_string/new_string exactos
- NO modificar estructura, solo valores de puerto
- NO agregar ni eliminar secciones

## Output Esperado

Después de completar los 5 fixes:

```markdown
## Resumen de Correcciones

### Puertos Correctos (desde docker-compose.yml)
- Backend: 3000
- Frontend: 5173
- ML Service: 8000
- PostgreSQL: 5432
- Redis: 6379
- Nginx: 80

### Archivos Corregidos

#### 1. PUERTOS-SERVICIOS.md
**Cambios:**
- Backend: 3001 → 3000
- Frontend: 3000 → 5173

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

[etc. para los 5 archivos]

## Validación
✅ Todos los puertos sincronizados con docker-compose.yml
✅ No se modificó estructura de documentos
✅ Cambios mínimos aplicados
```

**Compromiso:** Actualizar exactamente 5 archivos, verificar con grep, reportar cambios realizados.