🚀 Superpowers for Antigravity

A process-driven development workflow for agentic software engineering

Process Over Guessing.

Design First → Plan Atomic → Implementation with TDD → Verification with Hard Proof.

Getting Started · The Core Process · Commands · Philosophy

AI coding agents are powerful but often undisciplined. They might:

• ❌ Dive into code without understanding the "Why"
• ❌ Add extra features nobody asked for (scope creep)
• ❌ Skip tests or provide "trust me, it works" claims
• ❌ Get stuck in circular debugging loops

Superpowers provides the Standard Operating Procedure (SOP) that wraps agents in a professional engineering lifecycle, ensuring consistent, robust, and verifiable results.

The fastest way to install the Superpowers methodology into your project:

npx github:SriSatyaLokesh/superpowers-for-antigravity

# 1. Download the superpowers library to a temporary folder
git clone https://github.com/SriSatyaLokesh/superpowers-for-antigravity.git powers-temp

# 2. Copy the core logic into your project root (./)
xcopy /E /I powers-temp\.agent .agent
xcopy /E /I powers-temp\.gemini .gemini
xcopy /E /I powers-temp\adapters adapters
copy powers-temp\PROJECT_RULES.md .\
copy powers-temp\SUPERPOWER-STYLE.md .\

# 3. Cleanup the temporary folder
Remove-Item -Recurse -Force powers-temp

# 1. Download the superpowers library to a temporary folder
git clone https://github.com/SriSatyaLokesh/superpowers-for-antigravity.git powers-temp

# 2. Copy the core logic into your project root (./)
cp -r powers-temp/.agent ./
cp -r powers-temp/.gemini ./
cp -r powers-temp/adapters ./
cp powers-temp/PROJECT_RULES.md ./
cp powers-temp/SUPERPOWER-STYLE.md ./

# 3. Cleanup the temporary folder
rm -rf powers-temp

Once installed, simply send /help or Superpowers help to your Antigravity agent.

If you are new to the Superpowers methodology, we highly recommend following this path:

1. Read the Workflow Guideline: A visual and step-by-step primer on the methodology.
2. Explore the Example Project: See exactly how PRDs, designs, plans, and code look in a real scenario.
3. Run /help: Get a list of commands available in your current session.

graph LR
    A["💡 /brainstorm"] --> B["📐 /plan"]
    B --> C["⚙️ /execute"]
    C --> D["🔍 /review"]
    D --> E["✅ Done"]

    style A fill:#7B2D8E,color:#fff,stroke:none
    style B fill:#FF6D00,color:#fff,stroke:none
    style C fill:#E91E63,color:#fff,stroke:none
    style D fill:#2196F3,color:#fff,stroke:none
    style E fill:#00C853,color:#fff,stroke:none

We've synthesized the best skills from across the agentic ecosystem:

• Codebase Mapping: Total system understanding before making changes.
• Context Fetch: Smart retrieval to prevent context pollution.
• Context Health Monitor: Proactive detection of AI "hallucination thresholds."
• Empirical Validation: Requiring hard proof (logs/screenshots) for every task.

• Webapp Testing: Professional Playwright-based frontend verification.
• MCP Builder: Guided creation of Model Context Protocol servers.
• Frontend Design: Stunning, production-grade UI components with rich aesthetics.
• Web Artifacts: Complex React/Tailwind/shadcn dashboard generation.

• PROJECT_RULES.md: The "Constitution" of the Superpowers workflow.
• SUPERPOWER-STYLE.md: Standards for documentation and agent communication.
• Workflow Guideline: (NEW) visual guide to the core methodology.
• Example Project: (NEW) End-to-end demonstration of the workflow in action.
• PRD.md: The original Product Requirements Document for this integration.
• INSTALL.md: Detailed installation guide for all environments.
• docs/plans/: Recommended directory for all design and implementation artifacts.

1. Never Skip Brainstorming: Even for "simple" fixes, the /brainstorm phase prevents logic errors.
2. Aggressive Atomicity: Keep tasks under 5 minutes. If it's longer, break it down.
3. Hard Proof Only: Never accept "it should work." Require captured evidence.
4. Clean State Check: Use /help or /resume to ensure the agent has loaded the process correctly at the start of a session.

Superpowers for Antigravity is designed to be fully compatible with the GSD-for-Antigravity methodology.

• Synergy: Use GSD for high-level project management (SPEC.md, ROADMAP.md) and Superpowers for the low-level implementation cycle (/brainstorm, /plan).
• Shared Skills: Both frameworks share core context-management and verification skills, ensuring a unified experience.

If you want to update the version available via npx, follow these steps:

The command npx github:SriSatyaLokesh/superpowers-for-antigravity works immediately after you push to the main branch. No extra publishing step is required!

To allow users to just run npx superpowers-for-antigravity, you must publish to the NPM registry:

1. Login: npm login
2. Version Update: npm version patch (or minor/major)
3. Publish: npm publish --access public

This project honors its roots and peers:

1. Superpowers (Original): By obra. The pioneer of process-wrapped skills.
2. GSD for Antigravity: By toonight. The primary architectural inspiration for the Antigravity adapter and .agent structure.
3. Anthropic Skills: For the high-quality technical capability templates.