The Antigravity Kit vudovn is a powerful open-source enhancement for Google Antigravity, which is Google's "vibe coding" (agent-first) development environment.
Essentially, while Google Antigravity provides the basic kitchen (the editor, terminal, and browser control), the Antigravity Kit provides the "Michelin-star chefs"—a pre-configured team of specialized AI agents, expert skills, and automated workflows.
1. The Core Components
The kit organizes its intelligence into three distinct layers located in the .agent/ directory:
- Specialist Agents (20+): Instead of one generic AI, you get a roster of experts. Examples include:
- SEO Specialist: Optimizes metadata and Core Web Vitals.
- Debugger Agent: Specifically tuned to hunt and fix runtime errors.
- Game Designer: Handles physics, logic, and visual effects for games.
- Security Auditor: Scans for secrets and vulnerabilities.
- Skills (35+): These are "knowledge packs" that the agents can load as needed. They contain specific instructions for technologies like Docker, React, Supabase, or MCP (Model Context Protocol).
- Workflows (11+): These are automated sequences triggered by "slash commands" (e.g.,
/create,/review,/brainstorm). A single command can trigger a chain: Brainstorm → Plan → Code → Test.
2. Key Features & "Vibe Coding"
The kit is designed for a new style of development where the human acts more like a Director than a writer.
- Verifiable Execution: The agents don't just write code; they provide "Artifacts." They generate a plan first, then use a built-in browser to take screenshots or videos of the running app to prove it works.
- Self-Healing Loops: If the agent runs a command in the terminal and it fails, the kit uses its "Debugger" and "Linter" skills to automatically read the error, reason through a fix, and retry.
- Model Agnostic: While it shines with Google’s Gemini 3 Pro, it is fully compatible with Claude 3.5 Sonnet and Claude 4.5, allowing you to switch "brains" depending on the complexity of the task.
3. How the Architecture Works
The repository follows a strict "Trust-Grade" governance model. All agent operations are scoped to the .agent/ folder to ensure they don't overwrite your sensitive project files without explicit permission.
| Feature | Description |
|---|---|
| Slash Commands | /plan, /review, /deploy to trigger complex automation. |
| Intelligent Routing | Automatically loads the right agent based on keywords (e.g., "login" triggers the Security Agent). |
| Context Management | Keeps track of "Context as Artifact"—persistent markdown files that record decisions and architectural rules. |
| Browser Subagent | Allows the AI to interact with the web, click buttons, and perform E2E testing. |
4. Getting Started
The kit is typically installed via npx to instantly configure an existing project:
npx @vudovn/ag-kit init
This command sets up the directory structure and populates the .agent/ folder with the templates needed to turn Google Antigravity into a production-ready IDE.
Generally we developer get following type of BAU work
Work Category:-
New Feature Development
Change Request (CR)
Bugs & Defects
Security Enhancement
Security Issues (Hotfixes)
Performance Enhancement
Performance Issues
UI/UX Refactoring
Middleware/API Updates
Technical Debt/Refactoring
DevOps & Infrastructure.
As Antigravity Kit is a comprehensive framework of AI agent templates designed to streamline software development through specialized personas, domain-specific skills, and automated workflows.It functions by automatically detecting the domain of a user's request and applying the most relevant "specialist" agents and "skills" to ensure expert-level implementation and validation.
Below is a detailed explanation of how this project assists across various work categories.
Project Overview
The kit consists of four primary pillars:
- Agents (20): Specialist AI personas like
@backend-specialist,@security-auditor, and@debuggerthat handle domain-specific tasks. - Skills (37): Knowledge modules containing best practices, patterns (e.g.,
api-patterns), and validation scripts. - Workflows (11): Slash commands (e.g.,
/create,/debug,/plan) that execute multi-step procedures for common development tasks. - Validation Layer: Automated scripts like
checklist.pyandverify_all.pythat perform security scans, UX audits, and test execution before delivery.
Application by Work Category
1. New Feature Development & Change Requests (CR)
- Workflow: Use
/planto break down requirements into milestones . and/createto scaffold new features based on established templates. - Agent Utility: The
@project-plannerhandles initial discovery ., while@frontend-specialistand@backend-specialistimplement the logic using domain-specific skills likeapp-builder. - Socratic Gate: For new features, the system triggers 3 strategic questions to ensure scope and purpose are clear before coding begins.
2. Bugs, Defects & Performance Issues
- Workflow: Invoke
/debugfor a systematic root-cause analysis. - Agent Utility: The
@debuggeruses thesystematic-debuggingskill to analyze stack traces and logs, while the@performance-optimizerappliesperformance-profilingto resolve bottlenecks. - Validation: After a fix, the
/testworkflow generates and runs tests to ensure no regressions occurred.
3. Security Enhancements & Hotfixes
- Agent Utility:
@security-auditorand@penetration-testerare automatically engaged for security-related tasks. - Skills: They utilize
vulnerability-scannerandred-team-tacticsto identify and mitigate risks. - Automated Checks: The validation layer runs security scans as part of every execution to catch vulnerabilities early.
4. UI/UX Refactoring
- Workflow:
/ui-ux-pro-maxprovides access to 50 design styles and 21 color palettes to overhaul interfaces professionally. - Skills: Uses
frontend-design,web-design-guidelines, andux-psychologyto ensure accessibility and aesthetic quality. - Validation: Includes a
ux_audit.pyscript to check for common design flaws.
5. Middleware/API Updates
- Agent Utility:
@backend-specialistmanages API architecture. - Skills: The
api-patternsskill provides standardized versions for REST, GraphQL, and tRPC, ensuring updates follow industry best practices - Validation: Uses
api_validator.pyto ensure schema compliance and performance.
6. Technical Debt & Refactoring
- Workflow:
/enhanceis designed specifically to improve existing code quality. - Agent Utility: The
@code-archaeologistanalyzes legacy codebases to understand context before refactoring. - Skills: Knowledge modules like
clean-codeandarchitectureguide the restructuring of code to reduce complexity.
7. DevOps & Infrastructure
- Workflow:
/deployautomates deployment procedures across platforms like AWS, Vercel, or Docker. - Agent Utility:
@devops-engineerhandles infrastructure as code and deployment scripts. - Skills: Utilizes
deployment-proceduresanddocker-expertto manage builds and environment configurations.
But we will not use this predefined workflow but we will inform Antigravity agent itself to find and utlize the best of avaliable workflow for the given use case.
Lets first install the required package using npx command.
npx @vudovn/ag-kit init




Now lets use our PRD.txt as a product requirement document and place it in folder document inside our project.

Now lets ask the Antigravity Management window to provide the workflow for the given scenario
Application by Work Category created using Antigravity Management window.
1. New Feature Development & Change Requests (CR)
- Prompt: list the workflow that need to be executed in sequence for the scenario New Feature Development & Change Requests (CR) considering PRD.txt as the input
- Workflow: Summary Sequence: [/plan] → [User Approval] → [/orchestrate] (includes [/ui-ux-pro-max] & [/enhance]) → [/test] → [/deploy]


2. Bugs, Defects & Performance Issues
- Prompt: list the workflow that need to be executed in sequence for the scenario Bugs, Defects & Performance Issues considering PRD.txt as the input
Discovery & Reproduction: Analyze symptoms and establish a consistent reproduction path using browser-automation.
Systematic Debugging (RCA): Activate /debug and apply systematic-debugging and phase-gated-debugging to ensure the root cause is identified before fixing.
Performance Profiling: Use performance-profiling to find slow DOM updates or expensive localStorage operations.
Implementation & Validation: Apply fixes using debugger or performance-optimizer, generate tests via webapp-testing, and run final audits using checklist.py.

3. Security Enhancements & Hotfixes
- Prompt: list the workflow that need to be executed in sequence for the scenario Security Enhancements & Hotfixes considering PRD.txt as the input
Since the PRD specifies a "no-fuss" tool with no authentication, should the Security Enhancement focus on hardening the current client-side logic (CSP, input sanitization), or is adding a basic Authentication layer now within scope for "Enhancements"?
For "Hotfixes", do you require a specific "Emergency Audit" phase that differs from standard enhancement audits?
How deep should the automated scanning go (e.g., just static analysis of code, or dynamic analysis using browser automation to simulate attacks)?

4. UI/UX Refactoring
- Prompt: list the workflow that need to be executed in sequence for the scenario UI/UX Refactoring considering PRD.txt as the input
- Workflow:
- /brainstorm (Analysis & Discovery)
Purpose: Execute Phase 1 (Constraint Analysis) and Phase 2 (Design Decision) of the frontend-specialist protocol.
Goal: Identify the "soul" of the application, choose a radical design style (betraying the "Modern SaaS" clichés), and define the typographic/color foundations (adhering to the Purple Ban).
Output: A collection of design hypotheses and clarified requirements.
- /plan (Architecture & Task Breakdown)
Purpose: Document the technical approach before touching any code.
Goal: Create task.md and implementation_plan.md focusing on refactoring the Vanilla CSS architecture into a scalable design system (Utility-first or Custom Variables).
Output: A phased roadmap for refactoring the Dashboard, Create Ticket, and Search views.
- /ui-ux-pro-max (Implementation)
Purpose: The core execution phase for premium UI/UX.
Goal:
Design Commitment: Document the chosen style (e.g., Typographic Brutalism or Asymmetric Tension).
Foundation: Refactor index.css to implement the new design tokens.
Component Refactor: Update the HTML structure of the three views to support modern layouts.
Premium Motion: Add staggered reveal animations and micro-interactions for "Wow" factor.
- /test (Functional Verification)
Purpose: Ensure the "logic" described in the PRD (Search matching, localStorage persistence) is not broken by the visual changes.
Goal: Generate and run unit tests for the core logic and visual regression tests (if applicable) for the new UI.
- checklist.py (Final Quality Audit)
Purpose: The "Maestro Auditor" phase to ensure the refactor meets 2025 standards.
Action: Run python .agent/scripts/checklist.py ..
Goal: Verify the system against Security, Lint, UX, and Accessibility gates to ensure no "Safe Harbor" clichés or layout anti-patterns remain.


5. Middleware/API Updates
- Prompt: list the workflow that need to be executed in sequence for the scenario Middleware/API Updates considering PRD.txt as the input

6. Technical Debt & Refactoring
- Prompt: list the workflow that need to be executed in sequence for the scenario Technical Debt & Refactoring considering PRD.txt as the input

7. DevOps & Infrastructure
- Prompt: list the workflow that need to be executed in sequence for the scenario DevOps & Infrastructure considering PRD.txt as the input

Now lets excute the above step sequencewise
1. New Feature Development & Change Requests (CR)






5. Middleware/API Updates





4. UI/UX Refactoring
Now lets add the footer to the application we will take this footer form 21st.dev site. We will create a footer.txt file inside documents from the copy prompt from the footer component of the sites.


Now lets add the pie chart below the table on the dashboard using the workflow



Summary: If you use Google Antigravity, this kit is the "Secret Menu" that unlocks its full potential, moving it from a simple code-completion tool to a fully autonomous engineering team.

Reference :-
https://github.com/vudovn/antigravity-kit
https://antigravity-kit.unikorn.vn/docs
https://antigravity-kit.unikorn.vn/docs/guide/examples/brainstorm
source code:- https://github.com/shdhumale/antigravity-workspace-agentkit.git

No comments:
Post a Comment