ag-kit README

The project's README from github.com/vudovn/ag-kit. As one markdown file: README.md.

AG Kit

AG KIT

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

AG Kit on Unikorn.vn AG Kit on Trendshift AG Kit on J2TEAM Launch

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

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

npx @vudovn/ag-kit init

Or install the CLI globally:

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

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:

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 payload rather than executing a destructive command:
printf '%s' '{"tool_args":{"CommandLine":"rm -rf /"}}' \
  | node .agents/hooks/validate-tool-call.mjs

The command must exit non-zero and print BLOCKED by AG Kit.

Safe updates and rollback

AG Kit updates are merge-aware. User-owned files and locally modified managed files are preserved by default.

ag-kit update --dry-run          # Preview the exact plan
ag-kit update                    # Merge safely and create a backup
ag-kit update --strategy replace # Explicit full replacement, still backed up
ag-kit rollback                  # Restore the newest pre-update backup

Update metadata is stored in .agents/.ag-kit/. Backups are stored in .ag-kit-backups/ outside the managed toolkit tree. Read MIGRATION.md before upgrading an existing installation to the Antigravity-native release.

Antigravity-native integration

Runtime contract

.agents/antigravity.json declares the six supported integration phases and the documented Antigravity CLI capabilities used by AG Kit. It avoids inventing a minimum semantic version when upstream documentation does not define one.

Native safety hook

Antigravity loads .agents/hooks.json, which registers:

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

To temporarily disable the AG Kit hook while diagnosing a compatibility issue, set "enabled": false, reopen the workspace, and report the payload shape privately if it may contain sensitive data. Do not delete Antigravity's own permission controls.

MCP configuration

Review the workspace MCP plan without writing to the home directory:

node .agents/hooks/sync-mcp.mjs --check
node .agents/hooks/sync-mcp.mjs --print

After replacing placeholders, explicitly apply to one supported target:

node .agents/hooks/sync-mcp.mjs --apply --target suite
node .agents/hooks/sync-mcp.mjs --apply --target cli

Existing servers with the same name are preserved unless --force is supplied. A timestamped backup is created before an existing target file is changed. Never commit real MCP credentials.

Build and inspect the plugin

npm run build:antigravity-plugin

Review dist/antigravity-plugin/ before local installation. The bundle contains packaged skills, agents, rules, converted workflow commands, the native hook, an MCP example, and PLUGIN_CONTENTS.json with SHA-256 entries.

agy plugin install ./dist/antigravity-plugin
agy plugin list

Plugin installation is optional; the repository-native .agents/ workspace remains the source of truth for project development.

Included components

Component Count Purpose
Agents 20 Domain specialist and orchestration role definitions
Skills 47 Progressive domain knowledge and executable validation helpers
Workflows 13 Repeatable slash-command procedures
Rules 6 Workspace-wide routing, safety, design, and coding constraints
Memory topics 4 required topics plus index Durable project conventions, decisions, preferences, and feedback

Every agent, skill, workflow, and rule has a SemVer contract. .agents/manifest.json, .agents/manifest.lock.json, and .agents/DEPENDENCY_GRAPH.md make the managed toolkit reproducible and detect drift.

npm run generate:agents
npm run check:agents

Common workflows

Command Purpose
/brainstorm Explore options and architecture before implementation
/coordinate Run separable research or review tasks in parallel, then synthesize
/create Create a feature or application with structured gates
/debug Perform evidence-based root-cause analysis
/deploy Execute production pre-flight checks and deployment workflow
/enhance Safely modify an existing codebase
/orchestrate Plan, obtain approval, delegate to specialists, and verify
/plan Create a detailed implementation plan and checklist
/preview Manage local preview servers
/remember Save durable project information to memory
/status Summarize active work and blockers
/test Design and execute tests
/verify Prove changes by running checks instead of relying on inspection

Release and production gates

A release candidate is not production-approved until all automated checks and the hands-on Antigravity smoke test in PRODUCTION_CHECKLIST.md are complete.

Required GitHub checks:

AG Kit never requires automatic merge, automatic deployment, or automatic MCP synchronization. Production changes should remain reviewable and reversible.

Documentation

References and attribution

AG Kit is an original open-source implementation of Markdown-based agent engineering patterns. No proprietary source files are included. Runtime integration decisions are based on public Antigravity documentation and codelabs linked in .agents/hooks/README.md.

Support the project

Buy Me a Coffee

- or -

Buy me coffee

CA: Gjpatn3d24dCRhUng7F37K6xJba4R8SDBC18xs1Apump

License

Released under the MIT License © Vudovn.

ag-kit (vudovn/ag-kit)

Searching Database…

8.2K ·GitHub
Ag-kit
Что это такое?AG Kit — это инструментарий для инженерии агентов, созданный специально для Google Antigravity. В него входят правила, навыки, агенты-специалисты, рабочие процессы, постоянная память, рекомендации по настройке MCP, команды оркестрации и встроенный хук безопасности.
Это библиотека кода, которую я импортирую, или что-то другое?Это не библиотека кода. AG Kit устанавливает прямо в ваш проект полноценный набор файлов в каталоге .agents/: правила, навыки и рабочие процессы в формате Markdown, которые Antigravity читает и по которым действует.
Как добавить AG Kit в проект?Установите его в свой проект (или установите CLI глобально), затем откройте репозиторий как доверенную рабочую область в Google Antigravity и запустите проверку doctor, чтобы убедиться, что правила, навыки и рабочие процессы найдены.
Что нужно установить перед использованием?Нужны Node.js 22+ для инструментов Antigravity, Python 3.10+ для валидаторов и служебных скриптов AG Kit и Git для безопасных сценариев обновления и отката. Всё это запускается внутри доверенной рабочей области Google Antigravity.
Будет ли это работать с агентами для программирования, кроме Antigravity?Гарантии для продакшена нет: Antigravity — единственная поддерживаемая среда выполнения для продакшена. Другие инструменты могут читать компоненты в Markdown, но их поведение во время работы не входит в обязательства AG Kit по совместимости.
Какие слэш-команды входят в AG Kit?Он добавляет команды вроде /plan, /coordinate, /orchestrate, /debug, /deploy, /enhance, /test и /verify для запуска структурированных сценариев разработки с участием агентов прямо из Antigravity.
Что на самом деле блокирует встроенный хук безопасности?Он блокирует удаление корневой файловой системы, форматирование дисков и шаблоны перезаписи диска напрямую, при этом разрешая обычную очистку, например удаление dist/ или node_modules/. Он не заменяет собственные разрешения, песочницу или подтверждение человеком в Antigravity.
Насколько большой этот инструментарий?В нём 20 агентов-специалистов, 47 навыков, 13 рабочих процессов, 6 правил для всей рабочей области и 4 обязательные темы памяти. Каждый компонент отслеживается по контракту SemVer и манифесту зависимостей, который обнаруживает расхождения.
Что происходит при обновлении до новой версии?Обновления учитывают слияние: файлы, принадлежащие пользователю, и локально изменённые управляемые файлы по умолчанию сохраняются, а резервные копии с отметкой времени хранятся вне дерева управляемого инструментария, в каталоге .ag-kit-backups/.
What are similar projects?ruflo, brigade, cc-wf-studio, awesome-claude-skills, oh-my-opencode-slim, hyperfide, agent-skills, Agentlas-OS
Which topics is it in?antigravity, agent-framework, agent-memory, workflow-automation, orchestration, skills, markdown, agent-skills, mcp, security, automation, ai-agents
Creator
vudovn
Size
3.1 MB
Stars
8.2K
Updated
CommitAug 31Releasev2026.8.31Aug 31
Age
9mo
Commits · 90 Days