Saltar al contenido principal

Gobernanza declarativa de agentes

Los guardrails en runtime llegan demasiado tarde. Cuando el agente ya tecleó un comando destructivo, el prompt terminó y tú estás haciendo triage del desastre. StrayMark mueve la gobernanza de agentes upstream: las reglas se declaran en archivos versionados que el agente lee antes de empezar, y las actualizaciones a esas reglas son visibles en git log.

Por qué importa​

  • Runtime ≠ workflow. La mayoría de los guardrails de LLM son defensas contra prompt injection o filtros de salida — importantes, pero no deciden si el agente debería escribir esa migración de base de datos en primer lugar. La gobernanza a nivel de workflow sí.
  • Reglas versionadas son reglas revisables. STRAYMARK.md es un archivo con diffs de PR. Apretar o aflojar una regla aparece en git log con autor, fecha e hilo de discusión. Eso es auditable de una forma que los configs en runtime no.
  • Mismo contrato a través de CLIs. El mismo STRAYMARK.md dirige a Claude Code, Gemini CLI, Copilot CLI, Codex CLI. Una fuente de verdad, N agentes. Cambiar de modelo no implica reescribir el contrato operativo.

Las capas del contrato​

  1. STRAYMARK.md en la raíz del repo (~600 líneas, ~12 secciones). Las reglas unificadas: jerarquías, operaciones prohibidas, política documental, postura de seguridad, cuándo preguntar antes de actuar. Los agentes están obligados a leerlo antes de cualquier acción no trivial.
  2. AGENT-RULES.md bajo .straymark/00-governance/: reglas operativas más estrictas — cuándo señalar drift, cuándo recomendar un TDE, la cláusula "Be Proactive" que autoriza al agente a surfacear hallazgos sin que se los pidan.
  3. El frontmatter de skills aumenta las reglas globales para rituales específicos. Cada skill /straymark-* tiene sus propias precondiciones, contrato de salida y post-condiciones.

Cuando la versión del framework sube, el contrato sube. straymark update-framework te muestra el diff antes de aplicarlo.

Aprende más​