Comment organiser les agents neuronaux dans votre projet sans chaos ni rm -rf accidentel

Un problème courant survient souvent avec les assistants IA autonomes dans le code. Vous donnez au modèle l'accès au terminal et au système de fichiers, vous lui demandez de construire le projet ou de corriger un bug, et quelques minutes plus tard, il décide de nettoyer le cache et supprime quelque chose de précieux. Ou il commence à improviser, oubliant complètement les accords architecturaux que vous avez discutés une heure auparavant.

Le dépôt vudovn/ag-kit offre une solution systématique à ce problème. C'est un ensemble prêt à l'emploi de contrats, de règles et d'outils pour l'environnement Google Antigravity. Il transforme les interactions chaotiques des réseaux de neurones en un processus prévisible avec une séparation des rôles et une protection contre les actions dangereuses.

Ce qu'il y a dans le kit

Après l'initialisation, AG Kit crée une structure .agents/ à la racine du projet. À l'intérieur, vous trouverez des descriptions déclaratives de rôles spécialisés, de compétences, de workflows prêts à l'emploi et de mémoire à long terme.

Lorsqu'un projet s'ouvre dans Google Antigravity, l'environnement lit cette configuration. Au lieu d'un chatbot universel essayant de tout faire à la fois, les tâches commencent à être distribuées à des spécialistes étroits.

Le dépôt comprend les composants suivants :

• 20 agents à focus étroit pour différentes tâches de développement
• 47 compétences avec des règles et une logique de validation
• 13 scénarios prêts à l'emploi invoqués via des commandes slash
• 6 règles générales d'espace de travail
• Module de mémoire à long terme en .agents/memory/ pour préserver les décisions architecturales

Hook protecteur pour les commandes console

La partie la plus pratique du kit est l'intercepteur intégré PreToolUse. Avant d'exécuter une commande dans le terminal, le système la fait passer par un script local validate-tool-call.mjs.

Si un agent essaie d'exécuter rm -rf /, de formater le disque ou d'écraser les partitions système, le script bloque instantanément l'exécution et affiche une erreur. Pendant ce temps, le nettoyage de routine comme la suppression de node_modules ou dist se poursuit sans délai.

La configuration du hook est définie dans .agents/hooks.json :

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

Ce mécanisme ne remplace pas les contrôles de permissions réguliers ni le sandboxing, mais il protège contre les erreurs fatales des réseaux de neurones.

Scénarios clairs via les commandes slash

Au lieu d'écrire des instructions détaillées dans le chat à chaque fois, le kit propose des processus prêts à l'emploi. Vous entrez simplement une commande slash dans l'interface.

Voici quelques exemples parmi les 13 scénarios inclus :

• /plan construit d'abord un plan d'implémentation détaillé et une checklist sans toucher au code source
• /coordinate exécute plusieurs tâches de recherche en parallèle puis compile un résumé unifié
• /debug concentre l'agent sur la recherche des causes de bugs à partir des logs et des faits, en interdisant les supputations hasardeuses
• /remember enregistre les décisions techniques importantes et les accords dans la mémoire permanente du projet
• /verify exécute des vérifications et des tests pour prouver que le code fonctionne réellement

Versioning et mises à jour sûres

Les créateurs du projet ont traité les prompts et les règles comme du code source ordinaire. Chaque agent, scénario et règle a une version sémantique claire. L'état du kit est capturé dans les fichiers .agents/manifest.json et .agents/manifest.lock.json.

Les mises à jour sont également gérées avec soin. La commande ag-kit update n'écrase pas vos paramètres locaux. Elle fusionne les changements et crée automatiquement une sauvegarde exacte dans le dossier .ag-kit-backups/.

Si une nouvelle mise à jour casse quelque chose, vous pouvez restaurer l'état précédent avec une seule commande :

ag-kit rollback

Comment l'essayer dans votre projet

Vous aurez besoin de Node.js version 22 ou supérieure et de Python 3.10+. Initialisez dans un dépôt existant avec une seule commande :

npx @vudovn/ag-kit init

Pour vérifier que la configuration s'est déployée correctement et que les hooks fonctionnent, le projet inclut des scripts de validation intégrés :

npm run check:agents
npm run check:antigravity

Vous pouvez tester le hook protecteur sans exécuter de commandes dangereuses réelles en envoyant un payload de test directement au script de validation :

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

La réponse devrait afficher le message BLOCKED by AG Kit, et le processus devrait se terminer avec un code non nul.

À qui cet outil est destiné

AG Kit sera utile pour les équipes et les développeurs individuels qui ont choisi Google Antigravity comme environnement principal et qui veulent mettre de l'ordre dans les workflows IA. Dans les grands projets où le contexte se pollue rapidement, une séparation stricte en 20 rôles et la sauvegarde des décisions en mémoire font gagner un temps considérable.

Cependant, il y a une limitation à garder à l'esprit : la compatibilité complète n'est garantie qu'au sein d'Antigravity. Les autres éditeurs peuvent lire les fichiers de balisage dans .agents/, mais les réactions des hooks et le routage automatique ne fonctionneront pas.