superpowers-tdd

Instead of this chaotic workflow:

```

You: "Build me a CLI tool"

AI: immediately starts writing code

You: realizes halfway through it's not what you wanted

```

You get this structured approach:

```

You: "Build me a CLI tool"

→ Brainstorm: AI asks clarifying questions

→ Plan: AI writes a step-by-step plan with verification

→ You approve the plan

→ Execute: AI builds it step-by-step with tests

→ Review: AI checks for issues

→ Finish: Everything documented and working

```

Bonus: If your plan has independent steps (like "add 3 separate features"), the AI can work on them in parallel to save time!

---

Workflows (Slash Commands)

These are commands you type in Antigravity:

• /superpowers-brainstorm - Explore ideas and ask questions before planning
• /superpowers-write-plan - Create a detailed plan (no code yet!)
• /superpowers-execute-plan - Build the code step-by-step
• /superpowers-execute-plan-parallel - Build independent steps in parallel (faster!)
• /superpowers-review - Check code quality
• /superpowers-debug - Systematic debugging
• /superpowers-finish - Final summary and documentation

Skills (Building Blocks)

These teach the AI how to work:

• TDD - Test-driven development (write tests first)
• Debug - Systematic problem solving
• Review - Code quality checks
• REST/Python Automation - Best practices for specific tasks

Rules (Guardrails)

Automatic enforcement of good practices:

• ✅ Must write a plan before coding
• ✅ Must get approval before implementing
• ✅ Must verify each step works
• ✅ Must save outputs to disk (not just chat)

---

Step 1: Check What You Have Installed

Before starting, make sure you have these tools:

#### ✅ Required (You must have these):

Google Antigravity

• How to check: Open Antigravity (if it opens, you have it!)
• Don't have it? [Install Antigravity](https://antigravity.google)

Python 3.10 or newer

• How to check:

```bash

python --version

```

• Should show: Python 3.10.x or higher
• Don't have it? [Download Python](https://www.python.org/downloads/)

#### 🎨 Optional (Only needed for parallel execution):

Gemini CLI (makes things faster but not required)

• How to check:

```bash

gemini --version

```

• If it says "command not found", you don't have it
• To install:

```bash

npm install -g @google/gemini-cli

```

Windows users: After installing, verify it works:

```powershell

gemini --version

```

If you see a version number, you're good! If not, see [Troubleshooting](#troubleshooting) below.

---

Step 2: Set Up This Framework in Your Project

You have two options:

#### Option A: Start a New Project (Recommended for First-Time Users)

1. Create a new folder for your project:

Windows (PowerShell):

```powershell

mkdir my-awesome-project

cd my-awesome-project

```

Mac/Linux:

```bash

mkdir my-awesome-project

cd my-awesome-project

```

1. Copy the .agent folder from this repo into your project:

Windows (PowerShell):

```powershell

# Replace the path with where you downloaded this repo

Copy-Item -Recurse C:\path\to\gemini-superpowers-antigravity\.agent .

```

Mac/Linux:

```bash

# Replace the path with where you cloned this repo

cp -r /path/to/gemini-superpowers-antigravity/.agent .

```

1. *