Procesos y Documentacion

# Pipeline de Informes Ejecutivos ``` TRIGGER: schedule (daily 19:00, weekly viernes, monthly ultimo dia) | v COLLECT department_progress (8 departamentos) | v AGGREGATE kpis por departamento | v GENERATE executive_summary (AGENT-CEO-001) | -> model: Qwen3.5-27B | -> context: department_summaries + kpis + previous_report | v VALIDATE format (schema check) | v STORE en executive_reports table | v NOTIFY via Slack #executive-briefing ```

# Informe ENS Alto Semanal ## Secciones obligatorias (8) 1. Resumen ejecutivo 2. Incidentes de seguridad 3. Metricas de disponibilidad 4. Estado de controles 5. Gestion de vulnerabilidades 6. Gestion de accesos 7. Backup y recuperacion 8. Plan de accion ## Fuentes de datos - AGENT-PROD-MONITOR: metricas de disponibilidad - AGENT-PROD-SECURITY: vulnerabilidades - AuditLog: eventos de acceso - SystemHealth: snapshots de salud ## Validacion - Schema check: las 8 secciones presentes - Si falta seccion: generar con datos parciales + warning - Formato: Markdown -> PDF via WeasyPrint

# Prompt Version Log: AGENT-CEO-001 ## v3.2 (2026-04-08) - Anadida seccion 'Risks & Opportunities' con datos de 7 agentes core - Mejora en formato de executive summary - Tokens: ~1,200 output avg ## v3.1 (2026-04-02) - Fix: eliminado hallucination en metricas financieras - Anadido constraint: solo citar metricas que aparezcan en scratchpad - Tokens: ~1,050 output avg ## v3.0 (2026-03-25) - Rewrite completo para formato de briefing ejecutivo - Estructura: Summary > Departments > Decisions > Risks - Tokens: ~980 output avg ## v2.x (deprecated) - Formato narrative simple, sin estructura fija - Descartado por inconsistencia en outputs

# Runbook: Latencia vLLM ## Sintomas - P95 > 5s (baseline: 2.1s) - AGENT-PROD-MONITOR genera alerta L3_URGENT ## Diagnostico 1. Verificar VRAM: `nvidia-smi` en GEX44 2. Comprobar queue depth: endpoint /metrics de vLLM 3. Verificar si hay batch de embeddings concurrente ## Mitigacion - Si VRAM > 95%: descargar modelo secundario (Codestral) - Si queue > 50: reducir max_concurrent_requests - Si fallo de GPU: reiniciar servicio vLLM ## Post-mortem - Documentar incidente en template estandar - Actualizar MTTR en metricas de producto

# Deploy de Agentes ## Pre-deploy checklist - [ ] Tests unitarios pasando (pytest) - [ ] Eval dataset ejecutado (accuracy >= threshold) - [ ] Prompt versionado en docs/prompts/ - [ ] Feature flag configurado si es feature nueva ## Pasos 1. Merge PR a main 2. CI/CD ejecuta pipeline automaticamente 3. Docker build + push a registry 4. Dokploy detecta nueva imagen y despliega 5. Health check automatico (60s timeout) ## Rollback - Dokploy: revert a imagen anterior via dashboard - Si falla rollback: `docker service update --rollback`

# SLA: Disponibilidad vLLM ## Targets - Disponibilidad: 99.5% mensual - Latencia P50: < 2s - Latencia P95: < 4s - MTTR: < 1 hora ## Medicion - AGENT-PROD-MONITOR verifica cada 30 minutos - Metricas exportadas a Grafana ## Acciones por umbral - Disponibilidad < 99%: escalar a David - P95 > 5s: reducir concurrencia - MTTR > 2h: post-mortem obligatorio

# Procedimiento de Ejecucion Diaria ## Horario - 06:30 — Inicio de cadencia matutina - 06:45 — AGENT-PROD-MONITOR: health check de infra - 06:50 — AGENT-FIN-CASHFLOW: analisis de tesoreria - 07:00 — AGENT-SALES-PIPELINE, AGENT-MKT-INTELLIGENCE, AGENT-OPS-OKRS: ejecucion paralela - 07:15 — AGENT-PEOPLE-CULTURE: pulso organizacional - 07:20 — AGENT-CEO-001: briefing consolidado - 07:30 — Fin de cadencia ## Pre-requisitos - Endpoint vLLM activo y respondiendo - Supabase accesible - Scratchpad limpio de sesion anterior ## Rollback Si falla un agente core, el briefing CEO se genera con datos parciales + indicador de incompletitud.

# Scraping Competitivo ## Targets monitorizados (8) 1. CrowdStrike — pricing, features, blog 2. SentinelOne — pricing, changelog 3. Wiz — pricing, integrations 4. Palo Alto — XSIAM features 5. Fortinet — FortiSOAR updates 6. Microsoft — Sentinel pricing 7. Rapid7 — InsightConnect 8. Splunk — SOAR features ## Frecuencia - Pricing pages: diario - Feature pages: semanal - Blog/changelog: diario ## Fallbacks - Si 403: reintentar con headers rotados - Si estructura cambiada: flag para revision manual - Cache de ultimo valor valido: 7 dias max

# Runbook: Extraccion de Clausulas ## Sintomas - Precision de extraccion < 80% en batch - Output JSON malformado ## Diagnostico 1. Verificar formato del PDF de entrada 2. Comprobar version de prompt en uso 3. Revisar logs de parsing ## Mitigacion - Si PDF corrupto: solicitar version limpia - Si prompt degradado: revertir a version anterior - Si parsing falla: activar OCR como fallback

# Prompt Version Log: AGENT-OPS-OKRS ## v2.0 (2026-04-05) - Anadido modelo de trayectoria no-lineal para KRs - velocity_lookback_weeks cambiado de 2 a 3 - Mejora en deteccion de KRs at_risk (+15% recall) ## v1.2 (2026-03-20) - Fix: calibracion de estacionalidad trimestral - Tokens: ~650 output avg ## v1.1 (2026-03-10) - Anadido soporte para OKRs con dependencias cross-department - Tokens: ~600 output avg ## v1.0 (2026-03-01) - Version inicial - Trayectoria lineal simple - Tokens: ~500 output avg

# Cadencia Matutina — Flow Diagram ``` 06:30 START | 06:45 AGENT-PROD-MONITOR (health check) | -> outputs: system_status, error_rate, latency_p95 | 06:50 AGENT-FIN-CASHFLOW (tesoreria) | -> outputs: runway, burn_rate, mrr, cash_position | -> depends_on: API bancaria, Stripe API | 07:00 [PARALLEL] |-- AGENT-SALES-PIPELINE -> outputs: pipeline_total, coverage, win_rate |-- AGENT-MKT-INTELLIGENCE -> outputs: competitor_updates, market_signals |-- AGENT-OPS-OKRS -> outputs: okr_status, kr_progress, blockers | 07:15 AGENT-PEOPLE-CULTURE (pulso) | -> outputs: enps, team_health, alerts | 07:20 AGENT-CEO-001 (briefing) | -> reads: ALL previous outputs from scratchpad | -> outputs: daily_briefing, decisions_required | 07:30 END ``` ## Dependencias criticas - AGENT-CEO-001 requiere >= 5/7 outputs para briefing completo - Si < 5 disponibles: genera briefing parcial con warnings

# Runbook: Fallo de API Bancaria ## Sintomas - AGENT-FIN-CASHFLOW reporta timeout > 15s - Metricas de tesoreria no actualizadas - Alerta L2_WARN en dashboard ## Pasos de recuperacion 1. Verificar status page del banco (CaixaBank API Portal) 2. Comprobar credenciales en vault (expiran cada 90 dias) 3. Si API no disponible: - Activar modo cache: usar datos del dia anterior - Notificar al equipo financiero via Slack #finance 4. Si credenciales expiradas: - Renovar en portal de desarrolladores - Actualizar secret en Docker Swarm - Reiniciar agente ## Escalacion - Si no se resuelve en 2h: escalar a David - Si afecta a briefing CEO: notificar en #critical

# Anonimizacion de Datos de Equipo ## Regla critica - Equipos con < 5 personas: NUNCA reportar metricas individualizables - Consolidar con departamento padre ## Implementacion ```python if team_size < 5: # Merge with parent department data = aggregate_to_department(team_data) data['anonymized'] = True ``` ## Validacion - Check automatico pre-output - Test en eval pipeline con equipos de 2, 3, 4, 5, 10 personas - Alerta CRITICAL si falla anonimizacion

# SLA: Respuesta HITL ## Tiempos maximos de respuesta por impacto | Impacto | Tiempo max | Auto-escalacion | |---------|------------|------------------| | CRITICAL | 1 hora | Escalacion a David + notificacion SMS | | HIGH | 4 horas | Escalacion a David via Slack | | MEDIUM | 24 horas | Reminder automatico cada 8h | | LOW | 72 horas | Reminder automatico cada 24h | ## Politica de expiracion - Items CRITICAL no expiran: requieren resolucion explicita - Items HIGH: expiran a las 48h con default_option aplicada - Items MEDIUM/LOW: expiran a las 72h con default_option aplicada ## Metricas de cumplimiento - Target: 95% de items resueltos dentro del SLA - Actual (Q1 2026): 89% — accion requerida

# Actualizacion de Etapas CRM ## Contexto El CRM se actualizo de 5 a 7 etapas. AGENT-SALES-PIPELINE debe mapear correctamente. ## Mapeo actual 1. Lead -> Lead 2. Qualified -> MQL + SQL (split) 3. Proposal -> Proposal Sent + Negotiation (split) 4. Closed Won -> Closed Won 5. Closed Lost -> Closed Lost ## Validacion - Ejecutar reconciliacion semanal contra CRM directo - Verificar que pipeline_total coincide +/- 2% - Flag discrepancias > 5% como alerta L2_WARN