VPS Governance Platform v1

Esto es el mapa vivo del VPS.

Su objetivo es dejar una autoridad documental simple, mantenible y trazable para todo el servidor, no solo para OpenClaw.

Sirve para cuatro cosas:

• que Gabi pueda entender que corre en el VPS
• que una IA pueda consultar el estado documental sin adivinar
• que un admin pueda operar, mantener y restaurar servicios
• que ningun servicio nuevo se considere terminado sin quedar documentado aqui
• que exista una lectura por niveles para pasar de vista general a detalle

Alcance

Esta carpeta gobierna:

• servicios
• aplicaciones
• bases de datos
• redes
• volumenes
• dominios
• puertos
• backups
• tests
• usuarios operativos
• runbooks
• auditorias
• matriz de regresion
• estado de validacion
• control tower ejecutivo
• constitucion documental del proyecto
• arquitectura documental y blueprint governance
• operacion diaria
• monitoreo operativo
• mantenimiento
• updates
• seguridad
• preguntas de administracion asistida por IA
• plataforma documental viva O6 para infraestructura y drill-down

Regla madre

Ningun servicio nuevo se considera terminado si no actualiza Governance.

Contrato operativo del repo

Antes de cerrar cambios hechos con Codex, revisar tambien:

• Project Constitution
• Repo Operating Contract
• Active Context
• Gate Codex Efficiency
• Governance Rules
• Governance Contract

Como usar esta carpeta

1. Empezar por ACTIVE-CONTEXT.md para definir modo y lectura minima.
2. Usar GATE-CODEX-EFFICIENCY.md antes de tareas grandes, cierres importantes o prompts extensos.
3. Usar PROJECT-CONSTITUTION.md si el cambio afecta autoridad documental, principios o frontera de gobierno.
4. Seguir por INDEX.md si hace falta ubicar documentos.
5. Revisar el catalogo maestro en CATALOG.md.
6. Abrir el servicio correspondiente en services/.
7. Si el cambio afecta operacion, validar las preguntas de CHANGE-GATES.md.
8. Si el cambio afecta validacion o riesgo, revisar REGRESSION-MATRIX.md y catalog/TESTS.md.
9. Si el cambio afecta operacion o seguridad, revisar operations/ y security/.
10. Si se incorpora algo nuevo, usar las plantillas de esta carpeta.
11. Si hace falta entender la infraestructura real por niveles, entrar a knowledge/.

Regla de despliegue futuro

La estructura esta preparada para poder copiarse o sincronizarse mas adelante en /opt/governance, pero en esta etapa no se copia nada al VPS.

Limites

• No documentar secretos.
• No guardar tokens, claves, passwords ni .env reales.
• Cuando falte evidencia, declarar pendiente de validar en vez de inventar.
• Toda respuesta para admin debe estar escrita en lenguaje claro, amable y simple.