---
id: PROMPT-SA-05
agent_id: SA-05
model: claude-sonnet-4.5
type: General
fase: FASE-0
scope: Audit de docs/ (visión, arquitectura, ADRs, guías)
mode: read-only
created: 2026-02-06
---

# PROMPT-SA-05: Audit de Documentación Usuario (docs/)

## Contexto

Eres un agente especializado en auditoría de documentación de usuario. El proyecto `trading-platform` tiene una carpeta `docs/` que contiene documentación para desarrolladores y arquitectos.

**Ubicación:** `projects/trading-platform/docs/`

**Estructura esperada:**
- `00-vision-general/` - Visión del proyecto, objetivos, alcance
- `10-arquitectura/` - Diagramas, decisiones arquitectónicas
- `20-guias/` - Guías de desarrollo, setup, deployment
- `90-adr/` - Architecture Decision Records
- Otros subdirectorios según estructura real

## Instrucciones

### 1. Mapear estructura completa de `docs/`

- Listar todos los subdirectorios
- Identificar archivos markdown principales
- Contar documentos por categoría

### 2. Verificar completitud por categoría

**Visión (00-vision-general/):**
- ¿Existe documentación de visión/objetivos?
- ¿Está actualizada con el estado actual del proyecto?

**Arquitectura (10-arquitectura/):**
- ¿Hay diagramas arquitectónicos?
- ¿Están actualizados con el stack real? (Express 5, React 18, FastAPI, PostgreSQL 16, Redis 7)
- ¿Hay diagrama de componentes/módulos?
- ¿Hay diagrama de integraciones?

**Guías (20-guias/):**
- ¿Hay guía de setup local?
- ¿Hay guía de deployment?
- ¿Hay guía de contribución?
- ¿Están sincronizadas con docker-compose.yml y package.json reales?

**ADRs (90-adr/):**
- ¿Cuántos ADRs existen?
- ¿Están numerados secuencialmente?
- ¿Cubren decisiones importantes del proyecto?
- ¿Tienen el formato estándar (Context, Decision, Status, Consequences)?

### 3. Identificar gaps críticos

- Documentación faltante esencial
- Documentación obsoleta vs. código actual
- Contradicciones entre documentos
- Información duplicada

### 4. Clasificar por prioridad

- **P0:** Documentación crítica faltante/incorrecta
- **P1:** Documentación importante desactualizada
- **P2:** Gaps menores, mejoras de organización
- **P3:** Nice-to-have, optimizaciones

## Restricciones

- **MODO READ-ONLY:** NO modificar archivos
- Enfocarse en estructura y completitud, no validar contenido técnico profundo
- Generar reporte consolidado

## Output Esperado

Un documento markdown con:

```markdown
## Resumen Ejecutivo
- Total documentos en docs/: XX
- Subdirectorios: XX
- Documentos completos: XX
- Documentos obsoletos: XX
- Gaps críticos: XX

## Estructura de docs/
```
docs/
├── 00-vision-general/ (X archivos)
├── 10-arquitectura/ (X archivos)
├── 20-guias/ (X archivos)
└── 90-adr/ (X archivos)
```

## Análisis por Categoría

### 00-vision-general/
**Estado:** ⚠️ PARCIAL
**Archivos encontrados:**
- README.md (obsoleto, menciona stack antiguo)
**Gaps:**
- Falta documento de objetivos del proyecto
- Falta roadmap

### 10-arquitectura/
[análisis similar]

### 20-guias/
[análisis similar]

### 90-adr/
**Estado:** ✅ COMPLETO
**ADRs encontrados:** 8
**Últimas decisiones:** ADR-008 (2026-01-15)
**Gaps:**
- Falta ADR sobre elección de FastAPI para ML

## Gaps Identificados por Prioridad

### P0-CRITICO
1. [gap que bloquea desarrollo]

### P1-ALTO
1. [gap importante]

### P2-MEDIO
1. [inconsistencia menor]

### P3-BAJO
1. [mejora organizacional]

## Recomendaciones
[lista priorizada de acciones]
```

**Archivo de salida:** Reporte al orquestador.