Cómo Organizar Agentes de Redes Neuronales en Tu Proyecto Sin Caos y Accidentes rm -rf

Un problema común surge frecuentemente con asistentes de IA autónomos en el código. Le das al modelo acceso al terminal y al sistema de archivos, le pides que construya el proyecto o corrija un error, y un par de minutos después decide limpiar la caché y elimina algo valioso. O empieza a improvisar, olvidando completamente los acuerdos arquitectónicos que discutieron hace una hora.

El repositorio vudovn/ag-kit ofrece una solución sistemática a este problema. Es un conjunto listo para usar de contratos, reglas y herramientas para el entorno de Google Antigravity. Transforma las interacciones caóticas de redes neuronales en un proceso predecible con separación de roles y protección contra acciones peligrosas.

Qué Hay Dentro del Kit

Tras la inicialización, AG Kit crea una estructura .agents/ en la raíz del proyecto. Dentro encontrarás descripciones declarativas de roles especializados, habilidades, flujos de trabajo listos para usar y memoria a largo plazo.

Cuando un proyecto se abre en Google Antigravity, el entorno lee esta configuración. En lugar de un único chatbot universal intentando hacerlo todo a la vez, las tareas comienzan a distribuirse entre especialistas estrechos.

El repositorio incluye los siguientes componentes:

• 20 agentes de enfoque estrecho para diferentes tareas de desarrollo
• 47 habilidades con reglas y lógica de validación
• 13 escenarios listos para usar invocados mediante comandos de barra
• 6 reglas generales del espacio de trabajo
• Módulo de memoria a largo plazo en .agents/memory/ para preservar decisiones arquitectónicas

Gancho Protector para Comandos de Consola

La parte más práctica del kit es el interceptor integrado PreToolUse. Antes de ejecutar un comando en la terminal, el sistema lo ejecuta a través de un script local validate-tool-call.mjs.

Si un agente intenta ejecutar rm -rf /, formatear el disco o sobrescribir particiones del sistema, el script bloquea instantáneamente la ejecución y genera un error. Mientras tanto, la limpieza rutinaria como eliminar node_modules o dist continúa sin demoras.

La configuración del gancho se define en .agents/hooks.json:

{
  "enabled": true,
  "PreToolUse": [
    {
      "matcher": "run_command",
      "command": "node .agents/hooks/validate-tool-call.mjs",
      "timeout": 10
    }
  ]
}

Este mecanismo no reemplaza los controles de permisos regulares ni el aislamiento en sandbox, pero protege contra errores fatales de redes neuronales.

Escenarios Claros Mediante Comandos de Barra

En lugar de escribir instrucciones extensas en el chat desde cero cada vez, el kit ofrece procesos listos para usar. Simplemente ingresas un comando de barra en la interfaz.

Aquí hay algunos ejemplos de los 13 escenarios incluidos:

• /plan primero construye un plan de implementación detallado y una lista de verificación sin tocar el código fuente
• /coordinate ejecuta varias tareas de investigación en paralelo y luego compila un resumen unificado
• /debug enfoca al agente en encontrar las causas de errores a partir de registros y hechos, prohibiendo las conjeturas salvajes
• /remember registra decisiones técnicas importantes y acuerdos en la memoria permanente del proyecto
• /verify ejecuta verificaciones y pruebas para demostrar que el código realmente funciona

Versionado y Actualizaciones Seguras

Los creadores del proyecto trataron los prompts y reglas como código fuente regular. Cada agente, escenario y regla tiene una versión semántica clara. El estado del kit se captura en archivos .agents/manifest.json y .agents/manifest.lock.json.

Las actualizaciones también se manejan con cuidado. El comando ag-kit update no sobrescribe tu configuración local. Fusiona los cambios y crea automáticamente una copia de seguridad exacta en la carpeta .ag-kit-backups/.

Si una nueva actualización rompe algo, puedes restaurar el estado anterior con un solo comando:

ag-kit rollback

Cómo Probarlo en Tu Proyecto

Necesitarás Node.js versión 22 o superior y Python 3.10+. Inicializa en un repositorio existente con un solo comando:

npx @vudovn/ag-kit init

Para verificar que la configuración se implementó correctamente y los ganchos están funcionando, el proyecto incluye scripts de validación integrados:

npm run check:agents
npm run check:antigravity

Puedes probar el gancho protector sin ejecutar comandos peligrosos reales enviando una carga de prueba directamente al script de validación:

printf '%s' '{"tool_args":{"CommandLine":"rm -rf /"}}' \
  | node .agents/hooks/validate-tool-call.mjs

La respuesta debería mostrar el mensaje BLOCKED by AG Kit, y el proceso debería salir con un código distinto de cero.

Para Quién Es Esta Herramienta

AG Kit será útil para equipos y desarrolladores individuales que han elegido Google Antigravity como su entorno principal y quieren traer orden a los flujos de trabajo de IA. En proyectos grandes donde el contexto se ensucia rápidamente, la separación estricta en 20 roles y guardar decisiones en memoria ahorra tiempo considerable.

Sin embargo, hay una limitación a tener en cuenta: la compatibilidad completa solo está garantizada dentro de Antigravity. Otros editores pueden leer los archivos de marcado en .agents/, pero las reacciones de ganchos y el enrutamiento automático no funcionarán allí.