Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/adminoryslabs/armory --skill crear-guardrailAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
Crear guardrail
Goal
Convertir una regla ("nadie hace push a main") en un límite real del entorno, configurado de forma nativa en el agente que se está usando. La skill no trae recetas por agente: trae el procedimiento para que el agente aprenda a configurarse a sí mismo con su documentación vigente.
Input
- La regla a hacer cumplir, en lenguaje natural. Ejemplos de guardrails transversales:
- bloquear
git pusha la rama principal ygit push --force; - bloquear comandos destructivos sobre el sistema de archivos fuera del proyecto;
- pedir confirmación antes de cualquier deploy o escritura contra un servicio remoto;
- impedir la lectura o escritura de archivos de secretos (
.envy similares). - Opcional: si debe aplicar a nivel de proyecto (todo el equipo) o de usuario.
Si la regla no es clara (qué acción, qué excepción), preguntar antes de seguir.
Workflow
- Detectar qué agente está corriendo esta sesión (por su propia identidad, variables de
entorno o archivos de configuración presentes en el proyecto). Decirlo al usuario en una línea.
- Consultar la documentación oficial vigente de ese agente sobre hooks, permisos o
políticas. Usar references/puntos-de-partida.md solo como punto de partida: si la documentación actual difiere, gana la documentación actual. Si el agente no tiene acceso a la web, decirlo y pedir al usuario el enlace o el fragmento de documentación.
- Elegir el mecanismo más simple que haga cumplir la regla:
- si el agente tiene permisos declarativos (allow/deny/ask) que alcanzan, usar eso;
- si no alcanza, usar un hook sobre el evento correspondiente (ej. antes de ejecutar un
comando);
- si el agente no ofrece ningún mecanismo, decirlo explícitamente y proponer la alternativa
menos frágil (y dejar la regla también escrita en AGENTS.md).
- Proponer el guardrail al usuario antes de escribir nada:
- qué evento lo dispara;
- qué bloquea, pide confirmar o ejecuta;
- en qué archivo de configuración queda y con qué alcance (proyecto / usuario);
- qué podría bloquear por error (falsos positivos).
Esperar aprobación explícita.
- Configurarlo en el archivo nativo del agente, sin borrar configuración existente.
- Probarlo provocando el evento de forma segura (ej. un
git pusha main en una rama de
prueba o en modo simulación) y mostrar al usuario que el guardrail actuó. Si no actuó, se corrige antes de darlo por terminado.
- Registrarlo en
AGENTS.md, sección## Guardrails: la regla, el mecanismo, el archivo
donde vive y cómo se probó. Así el resto del equipo (humano o agente) sabe que existe.
Constraints
- No se instala nada que el usuario no haya aprobado.
- No se desactivan guardrails existentes para crear uno nuevo.
- Un guardrail que no se probó no se da por creado.
- Si el agente no permite hacer cumplir la regla, se dice: la regla queda como regla escrita, no
como falso guardrail.
