Gestor de SOPs y Runbooks

1

KB Health Report — Vault Notion de CULTIVA IA

kb_ingester.py

8

Páginas escaneadas

4

Páginas huérfanas (50%)

4

Páginas obsoletas > 1 año (50%)

3

Sin owner asignado (38%)

5

Candidatos a glosario (sin pág. canónica)

🔴 Páginas huérfanas (sin enlaces entrantes)

📁index.mdÍndice principal
📋runbooks/incident-comms.mdRunbook comunicación
📋sops/facturacion.mdSin owner ⚠
📋sops/offboarding-cliente.mdSin owner ⚠

✅ Top-4 Prioridad de limpieza (score = antigüedad × enlaces entrantes)

Rk	Score	Documento	Días obsoleto	Owner
1	627	`sops/firma-nda.md`	209 d	legal@cultivaia.com
2	327	`sops/offboarding-cliente.md`	327 d	MISSING
3	284	`sops/facturacion.md`	284 d	MISSING
4	22	`sops/onboarding-cliente.md`	11 d	carmen@cultivaia.com

📚 Candidatos a glosario — Acrónimos en 3+ docs sin página canónica

CSMusado en 6 docs — ambiguo: "Customer Success Manager" vs "Customer Solutions Manager"

KAMusado en 5 docs — sin definición canónica

NDAusado en 3 docs — sin definición canónica

SOPusado en 4 docs — sin definición canónica

📌 Próximas acciones recomendadas

1Asignar owners a las 3 páginas sin dueño — ninguna otra corrección es duradera sin responsabilidad.
2Resolver drift de glosario: elegir una definición canónica de "CSM" (¿Customer Success o Customer Solutions?), crear glosario.md y enlazarlo desde todos los docs afectados.
3Sprint de limpieza: triar los 4 docs prioritarios — archivar, reescribir o refrescar. Re-ejecutar kb_ingester.py al terminar para verificar reducción de huérfanos.
4No borrar huérfanos en bloque — algunas páginas huérfanas son referencias que se encuentran por búsqueda. Curar, no eliminar masivamente.

2

Validación de Runbook — Despliegue de Agente IA al Cliente

runbook_validator.py

83 / 100

USE-WITH-CAUTION

Score: 83.3 · 3 pasos validados · Archivo: runbooks/agent-deployment.md

El runbook tiene buena estructura pero falta duración concreta en los 3 pasos. No es seguro usar en un incidente real hasta solucionar los MUST-FIX.

Paso	Título	Owner	Duración	Éxito	Fallo	Rollback	Escalado	Semáforo
1	Validar configuración del agente	OK	FAIL	OK	OK	OK	OK	AMBER
2	Pruebas de integración en staging	OK	FAIL	OK	OK	OK	OK	AMBER
3	Desplegar en producción cliente	OK	FAIL	OK	OK	OK	OK	AMBER

⚠ MUST-FIX — Issues bloqueantes

Paso 1: Validar configuración del agente

DURATION: Falta duración concreta (necesita número + unidad, ej. "15 minutes"). "Variable" no es válido para un runbook de producción.

Paso 2: Ejecutar pruebas de integración en staging

DURATION: El paso dice "45 minutes" en el texto narrativo, pero el campo Expected duration no sigue el formato correcto (número + unidad sin palabras adicionales).

Paso 3: Desplegar en producción cliente

DURATION: "Unos 30 minutos" — impreciso. Usar "30 minutes" exacto. Además, el owner dice "ops team" (vago) — nombrar persona o rotación específica.

3

SOP Generado — Onboarding de Nuevo Cliente CULTIVA IA

sop_generator.py --profile ops

SOP: Onboarding de Nuevo Cliente CULTIVA IA

⚠ GDPR overlay Profile: ops

👥 Who

Process ownercarmen@cultivaia.com (Head of Ops)

AudienceCSM / Account Manager

📋 What

Inputs requeridos

📄 Contrato firmado (PDF en DocuSign)
📋 Brief de proyecto completado
💲 Datos de facturación del cliente (CIF, dir. fiscal)
📞 Contacto técnico del cliente

Outputs producidos

✓ Workspace Notion + Drive creados y compartidos
✓ Accesos Slack + Linear configurados
✓ Kick-off call + minuta enviada
✓ Milestone 1 definido y fechado
✓ DPA firmado si aplica GDPR

📅 When

TriggerContrato firmado por cliente nuevo

FrecuenciaOn-demand · avg. 4-6 veces/mes

📈 How-much

Tiempo estimado180 min (CSM: 2-3h + Tech Lead: 1h)

SistemasNotion Slack Linear Drive DocuSign Holded

⚖ Why — GDPR Overlay

Art. 6 GDPR: La base legal para el tratamiento de datos personales del cliente debe documentarse antes de iniciar el proceso. Si el proyecto maneja datos personales del cliente final, debe firmarse un DPA (Art. 28 GDPR) antes del Paso 3.

⚙ How — Pasos 5W2H

1

Verificar contrato firmado y datos completos en DocuSign

Owner · Duración · Señal de éxito · Señal de fallo · Rollback · Escalado

2

Firmar DPA si el proyecto maneja datos personales del cliente final

⚠ Obligatorio GDPR Art. 28 — no omitir

3

Crear workspace Notion + carpeta Google Drive con estructura estándar

4

Invitar al cliente a Slack y Linear (permisos: solo lectura/comentario)

5

Asignar equipo interno: CSM + Tech Lead + Especialista de área

6

Enviar email de bienvenida con accesos, contactos y próximos pasos

7

Realizar kick-off call (60 min): objetivos, alcance, calendario, canal de comunicación

8

Enviar minuta de kick-off y definir milestone 1 con fecha comprometida

✓ Cierre del proceso — milestone 1 en Linear

Gestor de SOPs y Runbooks Internos