🛰️ Antigravity Subagents

Production-Grade Specialized Subagents & Multi-Agent Swarms for Google Antigravity

🚀 Quick Install  •  🤖 Agent Catalog  •  🐝 Swarm Patterns  •  💻 CLI Reference  •  📖 Orchestration Guide

---

🌟 Overview

Antigravity Subagents is a modular collection of 15+ hyper-specialized subagents, multi-agent swarms, skills, and orchestration rules engineered specifically for Google Antigravity (CLI agy, Antigravity IDE, and Antigravity 2.0).

Instead of relying on a single monolithic model context, Antigravity Subagents empowers you to decompose complex software tasks across specialized, bounded agent personas with isolated tool permissions, optimal model tiers (flash, inherit, pro), and structured communication contracts.

---

⚡ Multi-Agent Orchestration Architecture

┌─────────────────────────────────────────────────────────────┐
│               CENTRAL ANTIGRAVITY ORCHESTRATOR              │
└──────┬──────────────┬──────────────┬──────────────┬─────────┘
       │              │              │              │
       ▼              ▼              ▼              ▼
┌──────────────┐┌──────────────┐┌──────────────┐┌──────────────┐
│  Codebase    ││   Security   ││   Surgical   ││     Test     │
│ Investigator ││   Auditor    ││  Refactorer  ││   Sentinel   │
│ (Model:flash)││ (Model:pro)  ││(Model:inherit││(Model:inherit│
└──────────────┘└──────────────┘└──────────────┘└──────────────┘

---

🤖 Subagent Catalog

Subagent	Category	Role	Model Tier	Write Tools	Description
🔍 codebase-investigator	Exploration	Codebase & Symbol Explorer	flash	❌ No	Rapidly finds symbols, callers, references, schemas, and configurations without context bloat.
📐 architecture-mapper	Architecture	System Flow & Topology Mapper	pro	❌ No	Generates clean Mermaid diagrams, module topology, ERDs, and component dependency trees.
🌐 web-researcher	Research	Live Docs & RFC Researcher	flash	❌ No	Performs targeted research on framework documentation, official API specs, and breaking changelogs.
🔨 surgical-refactorer	Engineering	Atomic Code Refactoring Specialist	inherit	✅ Yes	Clean, zero-regression code refactorings, applying SOLID patterns and type safety.
🔌 api-craftsman	Engineering	REST, GraphQL & gRPC Designer	inherit	✅ Yes	Scaffolds robust API endpoints, OpenAPI schemas, validation pipelines (Pydantic, Zod), and fixtures.
🗄️ database-architect	Engineering	Database Schema & Query Architect	inherit	✅ Yes	Designs relational schemas, migrations, composite indexes, and ACID transactional integrity.
🎨 ui-ux-stylist	Frontend	Modern UI/UX & Tailwind Artisan	inherit	✅ Yes	Builds accessible, responsive, modern UIs with Tailwind CSS, React, Vue, and slick micro-interactions.
🧪 test-sentinel	Quality	QA & Test Suite Automation Engineer	inherit	✅ Yes	Authors rock-solid unit, integration, edge-case, and property test suites (PyTest, Vitest, Go, Cargo).
🐛 bug-hunter	Debugging	Root-Cause Forensics Detective	pro	✅ Yes	Stack trace forensics, memory leak tracking, race condition isolation, and deterministic bug fixes.
⚡ performance-optimizer	Optimization	Runtime, Memory & Query Optimizer	pro	✅ Yes	Eliminates N+1 queries, optimizes memory overhead, reduces latency, and slashes bundle sizes.
🛡️ security-auditor	Security	AppSec & Vulnerability Sentinel	pro	❌ No	Static code security audit for OWASP Top 10 risks, hardcoded secrets, SQLi, SSRF, RCE, and auth flaws.
📦 dependency-inspector	Security	Supply Chain & Dependency Auditor	flash	✅ Yes	Scans lockfiles for CVE advisories, peer dependency conflicts, breaking changes, and license risks.
🐳 docker-devops	DevOps	Multi-Stage Docker & Compose Expert	flash	✅ Yes	Crafts lightweight multi-stage Dockerfiles, non-root users, layer caching, and docker-compose setups.
🤖 ci-cd-architect	DevOps	CI/CD Pipeline & Actions Engineer	flash	✅ Yes	Builds GitHub Actions workflows for matrix testing, caching, automated releases, and deployments.
📝 docs-artisan	Documentation	Technical Documentation Specialist	flash	✅ Yes	Writes stunning READMEs, JSDoc/Sphinx docs, API specifications, and Architectural Decision Records.

---

🚀 Quick Installation

Option 1: One-Line Auto Installer (Recommended)

Run this command in your terminal to automatically detect your Antigravity installation and install all subagents, skills, plugins, and rules:

curl -fsSL https://raw.githubusercontent.com/Pikaswelt/antigravity-subagents/main/install.sh | bash

To install into the current project workspace only (.agents/):

curl -fsSL https://raw.githubusercontent.com/Pikaswelt/antigravity-subagents/main/install.sh | bash -s -- --workspace

---

Option 2: Python CLI & Package Install

# Clone and install locally
git clone https://github.com/Pikaswelt/antigravity-subagents.git
cd antigravity-subagents
pip install -e .

# Install subagents into global Antigravity config
subagents install --global

# Or install to current project workspace
subagents install --workspace

---

Option 3: Manual Drop-In

Simply copy or symlink the directories into your Antigravity configuration:

# For Workspace-level usage (current project):
mkdir -p .agents
cp -r skills/ plugins/ rules/ .agents/

# For Global usage (all projects):
mkdir -p ~/.gemini/config
cp -r skills/ plugins/ rules/ ~/.gemini/config/

---

🐝 Swarm Orchestration Patterns

1. The Verified Triplet Pipeline (Locate → Refactor → Test)

1. Scout: codebase-investigator maps the target functions and callers.
2. Build: surgical-refactorer applies clean, atomic code changes.
3. Verify: test-sentinel adds test assertions and runs automated test suites.

# Programmatic AGY orchestration
invoke_subagent(
    Subagents=[
        {
            "TypeName": "codebase-investigator",
            "Role": "Codebase Investigator",
            "Prompt": "Locate where user session tokens are parsed and validated.",
            "Model": "flash"
        }
    ]
)

2. The Hardening Sprint (Parallel Security & Performance Audit)

Run independent audit agents in parallel without blocking:

invoke_subagent(
    Subagents=[
        {
            "TypeName": "security-auditor",
            "Role": "Security Auditor",
            "Prompt": "Audit auth/jwt.py for signature bypass and secret exposure.",
            "Model": "pro"
        },
        {
            "TypeName": "performance-optimizer",
            "Role": "Performance Optimizer",
            "Prompt": "Profile auth/jwt.py for cryptographic bottlenecks or memory leaks.",
            "Model": "pro"
        }
    ]
)

---

💻 CLI Management Suite

The included subagents CLI makes it easy to inspect, validate, export, and manage your agent collection:

# List all 15 available subagents
subagents list

# Inspect detailed prompt and configuration for a subagent
subagents show security-auditor

# Export ready-to-run define_subagent() snippets
subagents export --format python

# Validate all agent manifests and schemas
subagents validate

---

🏗️ Directory Structure

antigravity-subagents/
├── agents/                     # Master JSON manifests & Markdown specifications
│   ├── index.json              # Catalog index of all 15 subagents
│   ├── codebase-investigator.json
│   ├── architecture-mapper.json
│   ├── security-auditor.json
│   └── ...
├── skills/                     # Antigravity Skills package
│   ├── subagents/SKILL.md      # Master orchestrator skill
│   ├── subagent-generator/     # Dynamic agent creator skill
│   ├── swarm/SKILL.md          # Multi-agent swarm coordinator
│   ├── security-auditor/       # Direct security audit skill
│   └── architecture-mapper/    # Architecture visualization skill
├── plugins/                    # Antigravity Plugins package
│   └── antigravity-subagents/  # Complete bundled plugin
├── rules/                      # Delegation rules
│   ├── AGENTS.md               # Contextual agent routing guidelines
│   └── GEMINI.md               # Workspace rules
├── cli/                        # Python CLI management engine
├── assets/                     # High-resolution visual diagrams and hero banner
├── references/                 # In-depth architectural documentation
├── tests/                      # Automated validation & unit test suite
├── install.sh                  # One-line bash installer
├── setup.py                    # Python package setup
└── README.md                   # Project documentation

---

🤝 Contributing

We welcome contributions of new subagents, custom swarm configurations, and optimizations! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/new-subagent)
3. Add your agent manifest under agents/<name>.json
4. Run validation tests (python3 -m unittest discover -s tests)
5. Commit and open a Pull Request!

---

📄 License

This project is open source and available under the MIT License.

Made with 💜 for the Google Antigravity Developer Community by Pikaswelt