A complete software development workflow plugin for Claude Code. Hyperpowers guides your coding agent through brainstorming, research, planning, and execution—ensuring systematic, high-quality development instead of ad-hoc code generation.
Your agent doesn't jump into writing code. It asks what you're building, helps refine the design, researches technical approaches, creates detailed implementation plans, and executes tasks with built-in review gates.
Hyperpowers follows a 4-phase workflow that activates automatically based on what you're doing.
Activates when you start any creative work—creating features, building components, adding functionality.
- Explores your current project context (files, docs, recent commits)
- Asks clarifying questions one at a time using multiple choice when possible
- Proposes 2-3 different approaches with trade-offs
- Presents design in sections of 200-300 words for validation
- Saves validated design to
docs/hyperpowers/designs/
Activates after brainstorming to gather deep technical context before planning.
- Dispatches 8+ parallel research agents simultaneously
- Codebase analyst: Architecture patterns, similar implementations, dependencies
- Git history analyzer: Code evolution, past decisions, contributor expertise
- Framework docs researcher: Official documentation, API details, version considerations
- Best practices researcher: Community patterns, security considerations, common pitfalls
- Additional agents for error handling, test coverage, architecture boundaries, dependencies
- Saves synthesized findings to
docs/hyperpowers/research/
Activates with approved design to create detailed implementation plans.
- Breaks work into bite-sized tasks (2-5 minutes each)
- Every task has exact file paths, complete code, verification steps
- Follows TDD: write failing test → implement minimal code → verify pass → commit
- References research findings in plan header
- Saves plan to
docs/hyperpowers/plans/
Activates with a plan to implement tasks. Choose from four approaches:
| Approach | Description | Best For |
|---|---|---|
| Batch | Human checkpoints after each batch of tasks | Maximum control |
| Validated Batch | 3 parallel validators (build, spec, quality) + human checkpoints | Balance of speed and quality |
| Subagent | Fresh agent per task with automated two-stage review | Faster, less interaction |
| One Shot | Execute all tasks, then build+test with fix loops (not recommended) | Well-tested, unambiguous plans |
Requires: Claude Code 1.0.33 or later
From terminal:
claude plugin marketplace add bradwindy/hyperpowers
claude plugin install hyperpowers@hyperpowers-marketplaceFrom Claude Code REPL:
/plugin marketplace add bradwindy/hyperpowers
/plugin install hyperpowers@hyperpowers-marketplace
/help
You should see skills like /hyperpowers:brainstorm, /hyperpowers:write-plan, etc.
Note: Skills may not appear in /help due to a known issue, but they still work when invoked directly.
Clone the repository and add it as a local marketplace:
git clone https://github.com/bradwindy/hyperpowers.git
claude plugin marketplace add ./hyperpowers
claude plugin install hyperpowers@hyperpowers-marketplaceRefreshing after local changes:
rm -rf ~/.claude/plugins/cache/hyperpowers-marketplace/Then restart Claude Code. The skill hot-reload feature (v2.1.0+) only applies to ~/.claude/skills/ directories, not marketplace plugins.
- Codex: See docs/hyperpowers/README.codex.md
- OpenCode: See docs/hyperpowers/README.opencode.md
Hyperpowers includes significant enhancements over the original Superpowers project:
| Improvement | Description |
|---|---|
| Enhanced Planning Workflow | Clarification phase with explicit context gathering and synthesis |
| Subagent-Driven Development | Fresh subagent per task with two-stage review (spec + code quality) |
| Skill Strengthening & Enforcement | allowed-tools frontmatter restricts tool access per skill phase |
| Model Selection Optimization | Haiku for validation, Sonnet/Opus for implementation |
| Research Skill | 8+ parallel agents for comprehensive technical research |
| Knowledge Management | Auto-captures debugging solutions to searchable knowledge base |
| Specialized Code Review | 4 parallel reviewers (security, performance, style, test) |
| Context Fork Integration | Isolated investigations reduce token usage by 40-50% |
| Issue Tracking Abstraction | Single agent abstracts beads, GitHub Issues, and Jira MCP |
| Issue Context Preservation | Issue context flows through entire workflow chain |
| Skill Instruction Following | Research-backed reinforcement patterns prevent shortcutting |
| Assumption Validation | Validates design assumptions before planning |
| Research 8-Agent Enforcement | Counter-rationalization prevents agent reduction |
| Test Infrastructure | Comprehensive skill testing with case-insensitive assertions |
| One-Shot Execution Mode | Execute all tasks without checkpoints, then build+test |
| Upstream Merges | Regular sync with Superpowers upstream improvements |
For complete details, see IMPROVEMENTS.md.
Symptoms: /help doesn't show hyperpowers skills, or invoking skills fails.
Cause: Plugin cache may be stale or corrupted.
Solution:
rm -rf ~/.claude/plugins/cache/
claude plugin install hyperpowers@hyperpowers-marketplaceThen restart Claude Code.
Symptoms: Running /plugin update but not seeing new features or fixes.
Cause: Known bugs in Claude Code plugin caching (#14061, #19197, #15642).
Solution:
rm -rf ~/.claude/plugins/cache/
claude plugin install hyperpowers@hyperpowers-marketplaceSymptoms: Skills work when invoked directly, but don't appear in /help output.
Cause: Namespace visibility bug (#17271).
Solution: This is a known Claude Code issue. Skills still work—invoke them directly:
/hyperpowers:brainstorm
/hyperpowers:write-plan
/hyperpowers:execute-plan
Symptoms: Edited skill files locally but changes don't appear in Claude Code.
Cause: Marketplace plugins are cached. Skill hot-reload (v2.1.0+) only applies to ~/.claude/skills/ directories.
Solution:
rm -rf ~/.claude/plugins/cache/hyperpowers-marketplace/Then restart Claude Code.
- Fork the repository
- Create a branch for your skill or improvement
- Follow the
writing-skillsskill (/hyperpowers:writing-skills) for creating and testing new skills - Run tests:
./tests/claude-code/run-skill-tests.sh - Submit a PR
See skills/writing-skills/SKILL.md for the complete guide.
/plugin update hyperpowersNote: Due to caching issues, you may need to clear the cache manually:
rm -rf ~/.claude/plugins/cache/
claude plugin install hyperpowers@hyperpowers-marketplaceIf Hyperpowers has helped you do stuff that makes money and you are so inclined, please consider sponsoring my opensource work.
Thanks!
- Bradley
MIT License - see LICENSE for details.
- Issues: https://github.com/bradwindy/hyperpowers/issues
- Marketplace: https://github.com/bradwindy/hyperpowers-marketplace
Hyperpowers is a fork of Superpowers, originally created by Jesse Vincent.
The original Superpowers project is licensed under the MIT License. This fork maintains the same license terms.
We gratefully acknowledge Jesse Vincent's work in creating the original project that made this fork possible.