Superpowers ELI5

Teaching AI to code like a real engineer

agent37.club

The Problem

AI coding agents are like interns with no process

What you say

"Build me a login page"

...

What AI does

Immediately starts writing code. No questions. No plan. No tests. Hopes for the best.

Without structure, AI agents skip thinking and jump to typing. They forget edge cases, ignore tests, and drift off course on long tasks.

What Is Superpowers?

"A recipe book that teaches AI to code like a senior engineer"

Think of it like...

A training manual for AI coding agents. Instead of letting the AI wing it, Superpowers gives it a step-by-step playbook for every phase of building software.

The key insight

AI agents are smart but undisciplined. They need guardrails and processes, not more intelligence. Superpowers provides that structure.

The Cooking Analogy

A chef without a recipe vs. a chef with one

Without Superpowers

  • Starts cooking immediately
  • Grabs random ingredients
  • Doesn't taste along the way
  • Hopes it turns out ok
  • Serves without checking
vs

With Superpowers

  • Reads the recipe first
  • Gathers all ingredients
  • Follows step-by-step
  • Tastes at every stage
  • Only serves when perfect

Seven Steps to Great Code

The Superpowers workflow, simplified

1

Talk it out

AI asks you questions to understand what you really want

2

Set up space

Creates a clean workspace so nothing else gets broken

3

Make a plan

Breaks work into tiny 2-5 minute tasks

4

Build + test

Writes tests first, then code to pass them

5

Get reviewed

Another AI agent checks the work

6

Fix issues

Address any problems found in review

7

Ship it

Merge the code once everything passes

What Are "Skills"?

Simple text files that teach AI how to behave

Think of skills as...

Instruction cards for a board game

Each card explains the rules for one specific activity. The AI reads the card and follows the rules.

There are 14 skills covering brainstorming, planning, testing, debugging, code review, and more.

# What a skill file looks like
name: test-driven-development
description: Use when implementing
  any feature or bugfix

# The Iron Law:
# Write the test FIRST.
# Watch it FAIL.
# Write minimal code to PASS.
# If you write code before a
# test, DELETE IT and start over.

The Iron Law

Write the test first. Always.

"No code without a failing test first"

RED

Write a test that checks what you want. Run it. It should fail (because you haven't built anything yet).

GREEN

Write the minimum code to make that test pass. Nothing extra.

REFACTOR

Clean up the code while keeping the test green. Make it nice.

The Nuclear Option

If the AI writes code before writing a test, Superpowers tells it to delete everything and start over. Harsh, but it works.

Why this matters

Tests prove your code actually works. Without them, you're just hoping. AI agents are especially good at appearing confident while producing broken code.

AI Agents Supervising AI Agents

The subagent pattern: fresh eyes on every task

Think of it as...

A construction site

The foreman (main agent) reads the blueprints and assigns tasks. Workers (subagents) each build one piece. An inspector (reviewer) checks each piece before moving on.

  • Each task gets a fresh agent with no old baggage
  • Two reviewers check every piece: does it match the spec? Is it well-built?
  • If something's wrong, it gets fixed before moving on
  • The main agent can work for hours autonomously

Why fresh agents?

Long conversations confuse AI. A fresh agent on each task means no "context pollution" from previous work.

Why 102k Stars?

The fastest-growing AI coding project on GitHub

  • It actually works — developers report dramatically better output from AI agents
  • One-click install — available in Claude Code marketplace since Jan 2026
  • Free and open source — MIT license, anyone can use or modify it
  • Universal — works with Claude Code, Cursor, Codex, Gemini CLI
  • Solves a real pain — AI coding without process is frustrating

The Growth

Oct 2025: First published
Jan 2026: Marketplace launch
Mar 2026: 102,700 stars

+1,867 stars in a single day

Built by Jesse Vincent at Prime Radiant. The insight: AI needs process, not more intelligence.

The Big Takeaway

"AI agents are smart but undisciplined. Give them process, and they become reliable."

Superpowers proves that the missing piece in AI coding isn't smarter models — it's better methodology.

agent37.club