⚡ Antigravity Superpowers

Autonomous Superpowers & Specialized Division Skills for Google Antigravity, AGY 2.0, AGY IDE, and Gemini CLI.

[!IMPORTANT] Zero-Setup & Zero-Prompt Auto-Injection: All 13 core protocols and 88+ specialized division skills are automatically loaded into your Antigravity environment. No manual slash commands or complex configuration needed—simply ask and Antigravity executes with full division capabilities.

🚀 Quick Start & Installation

Install the entire suite of Antigravity Superpowers and 88+ Specialized Division Skills globally and locally in a single step:

Option 1: One-Line Curl Installer (Recommended)

curl -fsSL https://raw.githubusercontent.com/imMamdouhaboammar/antigravity-superpowers/master/install.sh | bash

Option 2: Via Bun / npx CLI

# Using Bun (Recommended)
bunx @mamdouh-aboammar/antigravity-superpowers install

# Using npx
npx @mamdouh-aboammar/antigravity-superpowers install

Option 3: Manual Clone & Install

git clone https://github.com/imMamdouhaboammar/antigravity-superpowers.git
cd antigravity-superpowers
bun run install.ts

[!TIP] After running the installer, run bun run verify (or antigravity-superpowers verify) to confirm that all 3 plugins and 88+ division skills are active in ~/.gemini/config/skills/.

🛡️ Privacy & Path Dynamizer Shield

Antigravity Superpowers includes an automatic Privacy Path Dynamizer & Git Pre-Push Hook to guarantee that no local machine signatures, personal home directories (e.g., /Users/<username>/..., /home/<username>/...), or private credentials ever leak when pushing code:

                  +----------------------------------------------+
                  |  Local Git Commit / Pre-Push Trigger Event   |
                  +----------------------------------------------+
                                         |
                                         v
                  +----------------------------------------------+
                  |  Privacy Path Dynamizer Interception Engine  |
                  +----------------------------------------------+
                                         |
                       +-----------------+-----------------+
                       |                                   |
                       v                                   v
        [Hardcoded Local Paths Sanitized]         [Personal Secrets Masked]
                       |                                   |
                       +-----------------+-----------------+
                                         |
                                         v
                  +----------------------------------------------+
                  |   Clean & Verified Push to Public GitHub/NPM   |
                  +----------------------------------------------+

Privacy Features

• Automatic Pre-Push Interception: Installs .git/hooks/pre-push into target projects.
• Dynamic Path Conversion: Converts absolute user paths into cross-platform environment expressions (os.homedir(), process.env.HOME, "$HOME", ~).
• Antigravity Hook Registration: Integrates into ~/.gemini/config/hooks.json on PreToolUse and SessionStart.
• Audit & Sanitize Commands:

# Audit repository for hardcoded user paths
bun run bin/cli.ts check-privacy

# Dynamize and sanitize all local user paths
bun run bin/cli.ts sanitize

🏛️ System Architecture

⚡ Core Superpowers Protocols (13 Binding Rules)

The antigravity-superpowers core plugin codifies 13 binding execution rules:

| # | Protocol | Key Capability | |---|---|---| | 1 | Mandatory Auto-Injection & Awareness | Scans and auto-injects all 88+ skills, MCP tools, and subagents on every prompt without manual commands. | | 2 | Predictive Parallel Simulation | Dispatches subagents concurrently (invoke_subagent) to audit risks, evaluate edge cases, and run parallel tests. | | 3 | Omniscient Codebase Telepathy | AST context mapping, dependency inspection (bun.lock), and schema-first verification before touching code. | | 4 | Intent-to-System Mapping | Generates production-grade, type-safe control flows directly from high-level user specifications. | | 5 | Self-Healing & Hot-Fixing Engine | Empirical error traceback inspection—never guesses root cause or masks symptoms. | | 6 | Zero-Setup Bun Orchestration | Enforces Bun-first execution for package management, script execution, and workspace builds. | | 7 | Visual Perfection & UI Finish Gate | Enforces semantic design tokens, responsive layout rules, and non-generic color palettes. | | 8 | Engineering Division Router | Delegates specialized engineering tasks across 57 dedicated domain subagent roles. | | 9 | Security Division Router | Enforces OWASP, SAST/DAST scanning, fail-closed access control, and secrets protection across 12 security roles. | | 10 | Testing & QA Division Router | Enforces evidence-based QA, E2E Playwright/Cypress automation, and performance benchmarks. | | 11 | Design & UX Division Router | Directs brand strategy, WCAG accessibility, persona walkthroughs, and UI polish across 10 design roles. | | 12 | Zero-Defect Security Shield | Guarantees zero hardcoded credentials, token leaks, or exposed private state in commits or logs. | | 13 | Continuous Self-Evolution | Captures debugging insights and architectural learnings into repeatable workspace playbooks. |

🎯 Specialized Divisions Matrix (88 Skills)

💻 Engineering Division (57 Skills)

• Software Architecture: engineering-software-architect, engineering-backend-architect, engineering-frontend-developer, engineering-senior-developer, engineering-code-reviewer, engineering-minimal-change-engineer.
• AI, ML & RAG: engineering-ai-engineer, engineering-prompt-engineer, engineering-rag-pipeline-engineer, engineering-llm-post-training-engineer, engineering-multi-agent-systems-architect, engineering-ai-data-remediation-engineer.
• Infrastructure & DevOps: engineering-devops-automator, engineering-sre, engineering-incident-response-commander, engineering-finops-engineer, engineering-identity-access-engineer, engineering-privacy-engineer.
• Database & Search: engineering-database-optimizer, engineering-database-reliability-engineer, engineering-search-relevance-engineer, engineering-gaussdb-expert, engineering-postgresql-optimization.
• Mobile, Desktop & IoT: engineering-mobile-app-builder, engineering-mobile-release-engineer, engineering-desktop-app-engineer, engineering-iot-fleet-engineer, engineering-embedded-firmware-engineer.
• Specialized Systems: engineering-api-platform-engineer, engineering-payments-billing-engineer, engineering-realtime-collaboration-engineer, engineering-video-streaming-engineer, engineering-webassembly-engineer, engineering-solidity-smart-contract-engineer, engineering-git-workflow-master, engineering-cms-developer, engineering-filament-optimization-specialist, engineering-drupal-performance, engineering-drupal-shopping-cart, engineering-wordpress-performance, engineering-wordpress-shopping-cart, engineering-wechat-mini-program-developer, engineering-feishu-integration-developer, engineering-orgscript-engineer, engineering-email-intelligence-engineer, engineering-uswds-developer, engineering-section-508-specialist, engineering-i18n-engineer, engineering-it-service-manager.

🛡️ Security Division (12 Skills)

• security-appsec-engineer, security-architect, security-cloud-security-architect, security-compliance-auditor, security-incident-responder, security-penetration-tester, security-blockchain-security-auditor, security-ai-generated-code-auditor, security-secrets-credential-engineer, security-senior-secops, security-threat-detection-engineer, security-threat-intelligence-analyst.

🧪 QA & Testing Division (9 Skills)

• testing-test-automation-engineer, testing-api-tester, testing-performance-benchmarker, testing-accessibility-auditor, testing-reality-checker, testing-evidence-collector, testing-test-results-analyzer, testing-tool-evaluator, testing-workflow-optimizer.

🎨 Design Division (10 Skills)

• design-ui-designer, design-ux-architect, design-ux-researcher, design-ui-finish-gate-reviewer, design-brand-guardian, design-image-prompt-engineer, design-inclusive-visuals-specialist, design-persona-walkthrough, design-visual-storyteller, design-whimsy-injector.

📊 Repository Insights & Stats

🛠️ CLI Reference

The module includes the antigravity-superpowers command-line executable:

# Install plugins, skills, and privacy hooks
bun run bin/cli.ts install

# Verify system health and active skills
bun run bin/cli.ts verify

# List all available skills grouped by division
bun run bin/cli.ts list

# Sanitize hardcoded paths across current repository
bun run bin/cli.ts sanitize

# Check for hardcoded local user paths (pre-push check)
bun run bin/cli.ts check-privacy

🔒 Security Best Practices

[!SECURITY]

• Zero Postinstall Risk: .npmrc enforces ignore-scripts=true and allow-git=none by default.
• Provenance Attestations: Releases are published with npm provenance attestations.
• Zero Leaks Guarantee: Pre-push hooks sanitize absolute machine paths and sensitive user tokens automatically.

📄 License

This project is open-source and licensed under the MIT License.
Built by Antigravity Engineering.