/projects/runbookguard
Runbook Guard
Capa de seguridad para runbooks de automatización operativa
Runbook Guard
Capa de seguridad para runbooks de automatización operativa
07
Contexto del proyecto05
Problema
Runbook Guard aborda el reto de convertir Capa de seguridad para runbooks de automatización operativa en un sistema útil, gobernado y explicable.
Solución
Runbook Guard se organiza alrededor de límites explícitos, flujos inspeccionables y un stack de entrega visible que incluye Python, FastAPI, Typer y Pydantic.
Desafíos
El trabajo difícil es mantener autonomía, datos, herramientas y experiencia de usuario alineados sin ocultar riesgo operativo ni evidencia.
Innovación
El valor distintivo está en tratar la arquitectura como una superficie del producto: las capacidades se explican mediante responsabilidades, rutas de prueba y límites de entrega.
Experiencia de dominio
Runbook Guard demuestra criterio de ingeniería aplicada en arquitectura de producto, sistemas de agentes, límites de datos, controles y disciplina de entrega.
Evidencia del caso de estudio11
Resultados
- Runbook Guard convierte un concepto técnico en un flujo de producto revisable.
- Mantiene el comportamiento del sistema ligado a límites explícitos, evidencia y decisiones visibles para operadores.
- Crea una referencia de arquitectura reutilizable para trabajos relacionados de productos de IA.
Decisiones de arquitectura
- Runbook Guard separa las superficies de usuario de las responsabilidades de runtime y control de datos.
- Python y las decisiones de stack cercanas se presentan como decisiones de entrega, no como insignias decorativas.
- La evidencia, la revisión y el estado operativo siguen visibles para poder inspeccionar el sistema después de usarlo.
Señales de experiencia del dominio
Arquitectura de agentesGobernanzaEvidenciaUX operativaPython
Análisis técnico profundo09
Runbook Guard es un caso de estudio sobre Capa de seguridad para runbooks de automatización operativa. Capa de seguridad para runbooks de automatización operativa La profundidad está en hacer legibles los límites, la evidencia, el workflow y las decisiones de entrega.
Límite del sistema
Runbook Guard se presenta mediante responsabilidades claras para que usuarios, herramientas, datos y acciones de runtime no se mezclen en una llamada opaca al modelo.
Modelo de workflow
El flujo mantiene planificación, uso de herramientas, estado y presentación de resultados lo bastante separados para que un operador entienda qué ocurrió y por qué.
Postura de evidencia
La página trata pruebas, logs, artefactos y rutas de revisión como parte del producto, no como notas opcionales de implementación.
Stack de entrega
Python sostiene la historia de implementación mientras el stack alrededor cubre persistencia, interfaces, automatización y verificación.
Qué demuestra esto
- Runbook Guard expone decisiones de arquitectura como contenido de producto inspeccionable.
- Python se conecta con responsabilidades de runtime y entrega.
- El caso distingue experiencia de usuario, límites de herramientas, evidencia y operaciones.
- La estructura se puede reutilizar en productos agentivos relacionados.
7Indicador: lifecycle stages
2Indicador: adapter seams
dry-runIndicador: by default
100%Indicador: audited runs
3Indicador: example workflows
✓Indicador: hash · sign · chain
Stack tecnológico07
Python
Motivo técnico: Keeps the control plane approachable for SRE and platform automation scripts.
FastAPI
Motivo técnico: Provides typed HTTP endpoints for plan, status, execute, health, and readiness.
Typer
Motivo técnico: Gives operators a CLI that mirrors the API without duplicating command parsing.
Pydantic
Motivo técnico: Makes runbook requests, plans, receipts, approvals, and audit bundles explicit contracts.
SQLite
Motivo técnico: Stores workflow state locally with almost no operational overhead.
Docker
Motivo técnico: Packages the guardrail service for repeatable local and deployment checks.
uv
Motivo técnico: Keeps Python dependency resolution and command startup fast for operator workflows.
Herramientas implementadas09
FastAPI control plane
Herramienta implementada: Accepts plan, execute, status, health, and readiness calls.
Typer CLI
Herramienta implementada: Runs validate, plan, execute, audit-list, and audit-show from the terminal.
Pydantic contracts
Herramienta implementada: Rejects malformed requests before they enter the state machine.
Evidence collection
Herramienta implementada: Pulls read-only evidence before any write action can be planned.
Risk checks
Herramienta implementada: Applies allowlists, denylists, risk thresholds, and budget limits.
Approval gate
Herramienta implementada: Holds higher-risk plans until a named human approves them.
Dry-run write adapters
Herramienta implementada: Keep mutations behind a separate seam and emit receipts by default.
Postcondition verifiers
Herramienta implementada: Confirm the intended outcome before the run is marked verified.
Hashed audit bundle
Herramienta implementada: Seals request, evidence, plan, approvals, receipts, and verification into a reviewable record.