¿Qué hace Company Agent Guardrails?
Propósito
Definir y aplicar reglas de seguridad prácticas para agentes de IA codificadores en toda Keshet — control visible y confirmado por humanos sobre acciones peligrosas, no seguridad a nivel de sandbox. Aplica a todos los agentes en Claude Code, Cowork, y cualquier pipeline o automatización que use Claude. Las categorías de políticas predeterminadas y las rutas de colocación de archivos por aplicación viven en reference.md.
Condiciones de activación
Siempre activo para cualquier sesión de agente de IA. Activar explícitamente cuando: se inicia una nueva sesión en un proyecto de Keshet, un agente está a punto de ejecutar llamadas shell/git/MCP, un usuario otorga autonomía amplia ("solo maneja esto"), se está diseñando o revisando un pipeline, o una acción tocaría secretos o archivos fuera del directorio del proyecto.
Primeros principios
- Identificar la superficie de acción: shell, lecturas/escrituras de archivos, git, llamadas MCP, instalación de paquetes, hooks, habilidades, secretos.
- Clasificar cada control como
deny,ask,monitoroguidance. - Preferir reglas pequeñas y explícitas sobre reglas amplias y vagas.
- Preservar la productividad del desarrollador — preguntar en acciones ambiguas, denegar solo las claramente inseguras.
- Indicar las limitaciones claramente: los archivos de instrucciones guían el comportamiento; los hooks/herramientas de endpoint aplican más, pero ninguno es un sandbox completo de SO sin un contenedor real.
Flujo de trabajo de redacción de reglas
- Preguntar dónde debe vivir la regla: configuración personal, configuración compartida del proyecto, o ambas.
- Preguntar qué debería suceder por categoría: bloquear, preguntar, monitorear o permitir.
- Redactar el conjunto de reglas útil más pequeño.
- Incluir ejemplos de acciones que activan la regla.
- Incluir limitaciones conocidas — qué sigue necesitando sandboxing o controles de endpoint.
- Si se escriben archivos, usar la ubicación nativa de la aplicación objetivo; mantener el lenguaje de la política agnóstico a la aplicación.
Postura predeterminada recomendada
Usar esta a menos que la empresa proporcione una política más estricta:
- Deny: exfiltración de secretos, pipe-to-shell (
curl ... | sh), deshabilitación de sandbox/permisos, comandos destructivos del sistema (borrado recursivo, formato de disco, limpieza de historial), acceso a almacenes de credenciales. - Ask: git push/force-push, despliegues, instalaciones de paquetes, cambios de esquema, escrituras fuera del directorio del proyecto, cualquier llamada a herramienta MCP que no esté en la lista aprobada por la organización.
- Monitor: toda ejecución de shell, escrituras de archivos dentro del proyecto, llamadas a API externas — registrado y visible, no bloqueado.
Qué NO hacer
- No instalar servidores MCP, hooks o servicios persistentes sin la aprobación explícita del usuario
- No leer, mostrar ni pasar archivos
.envo archivos de credenciales a ningún contexto - No ejecutar comandos destructivos de shell sin confirmación
- No hacer push a git ni desplegar sin que el usuario vea exactamente lo que se enviará
- No acceder a rutas de archivo fuera del directorio actual del proyecto
- No reintentar operaciones fallidas en silencio — siempre mostrar los fallos
- No tratar los archivos de reglas de solo instrucción como una aplicación a nivel de SO
- No instalar herramientas de agente de terceros de fuentes no verificadas sin una revisión de seguridad — preferir revisar el código fuente sobre instalar artefactos de lanzamiento precompilados, y enrutar las instalaciones a través de verificación de suma de comprobación y un entorno piloto
Plantilla de salida
Al proponer un conjunto de reglas de seguridad, responder siempre con:
## Resumen de reglas de seguridad
<breve resumen de lo que se está protegiendo>
## Políticas
- Deny: <acciones que están bloqueadas directamente>
- Ask: <acciones que requieren confirmación explícita del usuario>
- Monitor: <acciones que se registran y son visibles pero no están bloqueadas>
## Archivos a crear o actualizar
- `<ruta>`: <propósito de este archivo>
## Limitaciones
<qué NO aplican estas reglas de seguridad — qué requiere sandboxing adicional o controles de endpoint>