README

AG KIT


  Antigravity-first agent engineering kit with rules, skills, specialist agents, workflows, persistent memory, MCP guidance, orchestration, and a native safety hook.



  
  
  



  Primary runtime: Google Antigravity
  Tiếng Việt · Migration guide · Production checklist · Security


---

 Production profile

AG Kit installs a complete .agents/ workspace contract. Antigravity is the supported production runtime for this release. Other tools may read the Markdown components, but runtime behavior outside Antigravity is not part of the production compatibility guarantee.

| Capability | Production implementation |
| --- | --- |
| Rules and skill discovery | .agents/rules/, .agents/skills/, .agents/workflows/ |
| Specialist routing | 20 role definitions and intelligent-routing skills |
| Persistent context | .agents/memory/ and context-compression guidance |
| Orchestration | /coordinate, /orchestrate, Antigravity /agents and /tasks |
| MCP | Workspace config plus explicit, backup-aware sync helper |
| Tool safety | Native PreToolUse gate for high-confidence destructive commands |
| Packaging | Local Antigravity plugin bundle with a SHA-256 content inventory |
| Validation | Toolkit CI, Antigravity Doctor, regression tests, Dependency Review, CLI and web checks |

The native hook is deliberately narrow. It blocks root-filesystem deletion, drive formatting, and raw-disk overwrite patterns while allowing normal project cleanup such as deleting dist/ or node_modules/. It does not replace Antigravity permissions, workspace trust, sandboxing, or human approval.

 Requirements

- Node.js 22 or newer for repository-level Antigravity tooling.
- Python 3.10 or newer for AG Kit validators and utility scripts.
- A trusted Google Antigravity workspace.
- Git for safe update, review, and rollback workflows.

The published CLI currently supports Node.js 18 or newer; the Antigravity integration checks run on Node.js 22.

 Quick start

 Install into a project

bash
npx @vudovn/ag-kit init


Or install the CLI globally:

bash
npm install -g @vudovn/ag-kit
ag-kit init


Do not add .agents/ to the project .gitignore when Antigravity needs to index rules, skills, or workflows. To keep it local without disabling discovery, add .agents/ to .git/info/exclude instead.

 Verify the workspace

bash
npm run check:agents
npm run check:antigravity
npm run test:antigravity


check:antigravity is read-only. The default MCP example contains YOUR_API_KEY, so the normal doctor reports a warning until the example is configured. Use strict mode only after all placeholders have been resolved:

bash
node .agents/hooks/antigravity-doctor.mjs --strict


 Open in Antigravity

After opening the repository as a trusted workspace:

1. Confirm slash commands such as /plan, /coordinate, and /orchestrate are discovered.
2. Confirm relevant skills are selected from .agents/skills/.
3. Run a normal command such as npm test and confirm it is allowed.
4. Verify the safety hook with a mocked