Skip to content
BranchesTags
 
 

Repository files navigation

Superpowered Agents

Autonomous agent workflows for software development teams. Built on Superpowers with GitHub Project automation for bug fixes and feature development.

What You Get

1. Superpowers Foundation

Fork of obra/superpowers - a complete agent workflow system with composable skills:

  • brainstorming - Design refinement before coding
  • writing-plans - Implementation plans for autonomous execution
  • subagent-driven-development - Multi-agent parallel development
  • test-driven-development - RED-GREEN-REFACTOR enforcement
  • systematic-debugging - Root cause analysis process

All the battle-tested workflows from Superpowers, plus team collaboration features.

2. Bug & Feature Resolution Workflows

Structured processes that improve first-time resolution rates:

Bug Flow (5 stages):

Triage → Fix → Test → UserTest → Done
  • Parallel hypothesis testing for root cause
  • Evidence-driven testing with RED-GREEN discipline
  • Automated CI gates
  • Optional UAT validation

Feature Flow (7 stages):

Brainstorm → Design Review → Plan → Implement → Test → Review → Done
  • Socratic design refinement
  • Spec validation before implementation
  • Subagent-driven parallel development
  • Two-stage review (spec compliance, then code quality)

3. GitHub Projects Integration

Kanban boards that map workflow stages to GitHub Projects:

  • Organization-level projects - Manage issues across repos
  • Status field automation - Track progress through stages
  • Board views - Visualize work in progress
  • Marker-based idempotency - Resume from interruptions

Set up in minutes with /setup command.

4. Loop Agents

Autonomous agents that process issues through workflow stages:

/loop bug        # Process bug issues
/loop feature    # Process feature issues
/loop all        # Process both flows

How it works:

  • Reads issues from GitHub Projects
  • Checks Status field to determine current stage
  • Dispatches appropriate skill for that stage
  • Posts progress markers to issue comments
  • Advances to next stage on completion
  • Never blocks - communicates async via GitHub

Example:

Issue #123 in "Triage" stage
→ Loop dispatches bug-triage skill
→ Investigates root cause with parallel hypotheses
→ Posts [TRIAGE_READY] marker
→ Moves to "Fix" stage

Issue #123 in "Fix" stage
→ Loop dispatches bug-fix skill
→ Implements the fix
→ Posts [FIX_COMPLETE] marker
→ Moves to "Test" stage

...continues through all stages automatically

Quick Start

1. Install Plugin

Choose your platform:

Claude Code Official Marketplace:

/plugin install superpowers@claude-plugins-official

Cursor:

/add-plugin superpowers

See Installation for all platforms.

2. Set Up GitHub Projects

From your repository:

/setup

Creates projects, configures workflows, generates configuration files.

See Integration Guide for detailed walkthrough.

3. Create Issues

gh issue create --title "Login timeout" --body "Users timing out after 5s"
gh project item-add 1 --url <issue-url>

4. Run Loop

/loop bug

Agents process issues automatically through all stages.

Credits

This project is built on Superpowers by Jesse Vincent and the Prime Radiant team.

If Superpowers has helped you, consider sponsoring Jesse's opensource work.

Documentation

Getting Started

Commands

  • /setup - Bootstrap GitHub Projects integration
  • /loop - Process issues through workflow stages

Workflows

Maintenance

Installation

Choose your platform:

Claude Code:

/plugin install superpowers@claude-plugins-official

Cursor:

/add-plugin superpowers

Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

OpenCode:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

Gemini:

gemini extensions install https://github.com/obra/superpowers

See Installation below for detailed instructions.

Skills Library

All skills from Superpowers, plus GitHub Project workflow automation:

GitHub Project Workflows:

  • bug-triage - Parallel hypothesis testing for root cause
  • bug-fix - Evidence-driven fix implementation
  • testing-gates - Automated CI validation (linting, type checking, tests)
  • user-acceptance-testing - UAT coordination
  • loop-orchestrator - Automated issue processing
  • committing - Git workflow and PR creation

Feature Development (from Superpowers):

  • brainstorming - Socratic design refinement
  • writing-plans - Detailed implementation plans
  • subagent-driven-development - Multi-agent parallel development
  • requesting-code-review - Pre-review checklist
  • finishing-a-development-branch - Merge/PR workflow

Testing & Debugging (from Superpowers):

  • test-driven-development - RED-GREEN-REFACTOR enforcement
  • systematic-debugging - Root cause analysis
  • verification-before-completion - Ensure fixes work

Supporting Skills (from Superpowers):

  • dispatching-parallel-agents - Concurrent subagent workflows
  • using-git-worktrees - Isolated development branches
  • evidence-driven-testing - Scratch/promoted/permanent test commitment
  • handler-authority - Async authority model for loop mode

Full skill list: skills/

Philosophy

  • Evidence over claims - Verify before declaring success
  • Systematic over ad-hoc - Process over guessing
  • Test-Driven Development - Write tests first, always
  • Structured workflows - Clear stages, clear progression
  • Async coordination - Work through GitHub, not blocking terminal

Read more: Superpowers for Claude Code

Installation Details

Claude Code Official Marketplace

Install from the official marketplace:

/plugin install superpowers@claude-plugins-official

Claude Code (via Superpowers Marketplace)

Register the marketplace first:

/plugin marketplace add obra/superpowers-marketplace

Then install:

/plugin install superpowers@superpowers-marketplace

Cursor

Install from marketplace:

/add-plugin superpowers

Or search "superpowers" in plugin marketplace UI.

Codex

Tell Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

See docs/README.codex.md for details.

OpenCode

Tell OpenCode:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

See docs/README.opencode.md for details.

Gemini

gemini extensions install https://github.com/obra/superpowers

Update with:

gemini extensions update superpowers

Verify Installation

After installation, verify skills are active:

/brainstorm

Agent should invoke the brainstorming skill.

Contributing

Contributions welcome! See CONTRIBUTING_LESSONS_LEARNED.md for guidelines on:

  • What to contribute vs keep local
  • How to extract generic improvements
  • PR submission process

Quick contributions:

  • Bug fixes in skills or commands
  • Documentation improvements
  • New generic skills

Keep local:

  • Project-specific configuration
  • Company workflows
  • Proprietary techniques

Community & Support

Built on Superpowers by Jesse Vincent and Prime Radiant.

License

MIT License - see LICENSE file for details

About

An agentic skills framework & software development methodology that works. LLMs are designed to truncate steps and save tokens, that's a recipe for disaster in production code workflows. Super-agents utilize GitHub Project boards and stage hooks to synchronize flows and enforce systematic approaches to code that works.

Resources

Readme
License

Code of conduct

Code of conduct
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

Packages

Contributors

Languages