Saltar a contenido

Repo Operating Contract

Este documento define el contrato operativo obligatorio para trabajar este repo con Codex.

Complementa las reglas ya existentes en Governance, SAFE POINT y runbooks.

Regla madre

Trabajo no documentado equivale a trabajo no cerrado.

Que revisar antes de editar

  1. PROJECT-STATE.md
  2. ROADMAP.md
  3. docs/governance/ cuando el cambio afecte reglas, operacion, seguridad, inventario, runbooks o criterios de cierre
  4. la visibilidad del cambio dentro del OpenClaw Knowledge Portal

Limites obligatorios

  • no tocar VPS sin instruccion explicita
  • no tocar Docker sin instruccion explicita
  • no tocar OpenClaw sin instruccion explicita
  • no crear APIs por defecto
  • no crear servicios por defecto
  • no cambiar arquitectura por defecto
  • no hacer commit automatico
  • no inventar evidencia faltante

Obligaciones por cada cambio relevante

  • actualizar la documentacion que corresponda
  • revisar si hay que actualizar PROJECT-STATE.md
  • revisar si hay que actualizar ROADMAP.md
  • revisar Governance cuando el cambio altere reglas, operacion o cierre
  • revisar si el cambio debe quedar visible en el portal
  • dejar el estado real, no el estado deseado

Regla de evidencia

Si falta evidencia:

  • declarar pendiente
  • declarar pendiente de validar si corresponde
  • no completar huecos con supuestos

Validaciones obligatorias

  • ejecutar git diff --check
  • ejecutar mkdocs build --strict cuando el cambio afecte docs o navegacion
  • usar .\.venv-portal\Scripts\mkdocs build --strict si existe
  • si ese path no existe, usar python -m mkdocs build --strict y dejar constancia

Criterio de cierre

Un cambio queda cerrable solo si:

  • la documentacion relevante fue actualizada
  • PROJECT-STATE y ROADMAP fueron revisados
  • Governance fue revisada cuando correspondia
  • la visibilidad en el Knowledge Portal fue revisada cuando correspondia
  • las validaciones obligatorias fueron ejecutadas
  • los pendientes quedaron declarados

Si falta uno de esos puntos, el trabajo sigue abierto.

Relacion con otros documentos

  • CODEX.md: version raiz para operar el repo desde la sesion local
  • GOVERNANCE-RULES.md: reglas permanentes de governance
  • GOVERNANCE-CONTRACT.md: contrato minimo de cierre por servicio
  • runbooks/MAINTAIN-KNOWLEDGE-PORTAL.md: mantenimiento operativo del portal