Hoe u neurale netwerkagenten organiseert in uw project zonder chaos en onbedoeld rm -rf

Een veelvoorkomend probleem doet zich vaak voor bij autonome AI-assistenten in code. U geeft het model toegang tot de terminal en het bestandssysteem, vraagt het om het project te bouwen of een bug te verhelpen, en een paar minuten later besluit het de cache op te ruimen en iets waardevols te verwijderen. Of het begint te improviseren en vergeet volledig de architectuurafspraken die u een uur eerder besproken heeft.

Repository vudovn/ag-kit biedt een systematische oplossing voor dit probleem. Het is een kant-en-klare set van contracten, regels en tools voor de Google Antigravity-omgeving. Het transformeert chaotische neurale netwerkinteracties in een voorspelbaar proces met rolverdeling en bescherming tegen gevaarlijke acties.

Wat er in de Kit zit

Na initialisatie creëert AG Kit een structuur .agents/ in de projectroot. Daarin vindt u declaratieve beschrijvingen van gespecialiseerde rollen, vaardigheden, kant-en-klare werkstromen en langetermijngeheugen.

Wanneer een project opent in Google Antigravity, leest de omgeving deze configuratie. In plaats van één universele chatbot die alles tegelijk probeert te doen, worden taken verdeeld naar nauwe specialisten.

De repository bevat de volgende componenten:

• 20 smal gefocuste agenten voor verschillende ontwikkeltaken
• 47 vaardigheden met regels en validatielogica
• 13 kant-en-klare scenario's die worden aangeroepen via slash-commando's
• 6 algemene werkruimteregels
• Langetermijngeheugenmodule in .agents/memory/ voor het behouden van architectuurbeslissingen

Beschermende Hook voor Console-commando's

Het meest praktische onderdeel van de kit is de ingebouwde interceptor PreToolUse. Voordat een commando in de terminal wordt uitgevoerd, voert het systeem het uit via een lokaal script validate-tool-call.mjs.

Als een agent probeert rm -rf / uit te voeren, de schijf te formatteren of systeempartities te overschrijven, blokkeert het script de uitvoering onmiddellijk en geeft een foutmelding. Ondertussen gaat routinematig opschoning zoals het verwijderen van node_modules of dist zonder vertragingen door.

De hook-configuratie is gedefinieerd in .agents/hooks.json:

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

Dit mechanisme vervangt reguliere permissiecontroles of sandboxing niet, maar beschermt tegen fatale neurale netwerkfouten.

Duidelijke Scenario's via Slash-commando's

In plaats van elke keer vanaf nul lange instructies in de chat te schrijven, biedt de kit kant-en-klare processen. U voert simpelweg een slash-commando in de interface in.

Hier zijn een paar voorbeelden van de 13 meegeleverde scenario's:

• /plan bouwt eerst een gedetailleerd implementatieplan en checklist zonder de broncode aan te raken
• /coordinate voert verschillende onderzoekstaken parallel uit en stelt vervolgens een uniform overzicht samen
• /debug richt de agent op het vinden van bugoorzaken uit logs en feiten, waarbij wild gissen verboden is
• /remember legt belangrijke technische beslissingen en afspraken vast in het permanente geheugen van het project
• /verify voert controles en tests uit om te bewijzen dat de code daadwerkelijk werkt

Versiebeheer en Veilige Updates

De projectmakers hebben prompts en regels behandeld als gewone broncode. Elke agent, scenario en regel heeft een duidelijke semantische versie. De status van de kit wordt vastgelegd in .agents/manifest.json en .agents/manifest.lock.json bestanden.

Updates worden ook doordacht afgehandeld. Het ag-kit update commando overschrijft uw lokale instellingen niet. Het voegt wijzigingen samen en maakt automatisch een exacte back-up in de .ag-kit-backups/ map.

Als een nieuwe update iets breekt, kunt u de vorige status herstellen met één commando:

ag-kit rollback

Hoe het uit te proberen in uw Project

U heeft Node.js versie 22 of nieuwer en Python 3.10+ nodig. Initialiseer in een bestaande repository met één commando:

npx @vudovn/ag-kit init

Om te verifiëren dat de configuratie correct is geïmplementeerd en hooks werken, bevat het project ingebouwde validatiescripts:

npm run check:agents
npm run check:antigravity

U kunt de beschermende hook testen zonder daadwerkelijk gevaarlijke commando's uit te voeren door een testpayload rechtstreeks naar het validatiescript te sturen:

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

De respons zou de melding BLOCKED by AG Kit moeten tonen, en het proces zou moeten afsluiten met een niet-nul code.

Voor wie dit Instrument bedoeld is

AG Kit is nuttig voor teams en individuele ontwikkelaars die Google Antigravity als primaire omgeving hebben gekozen en orde willen brengen in AI-werkstromen. In grote projecten waar context snel rommelig wordt, bespaart strikte verdeling in 20 rollen en het opslaan van beslissingen in het geheugen aanzienlijk tijd.

Dat gezegd hebbende, er is een beperking om in gedachten te houden: volledige compatibiliteit is alleen gegarandeerd binnen Antigravity. Andere editors kunnen de markup-bestanden in .agents/ lezen, maar hook-reacties en automatische routing werken daar niet.