claude-code-ultimate-guide/docs/resource-evaluations/obra-superpowers-evaluation.md

Evaluation: obra/superpowers — Agentic Skills Framework for Claude Code

Resource Type: GitHub Repository (Claude Code Plugin) Author: Jesse Vincent, Prime Radiant URL: https://github.com/obra/superpowers Evaluation Date: 2026-03-18 Evaluator: Claude Sonnet 4.6

---

1. Content Summary

Superpowers is a complete software development methodology packaged as a Claude Code plugin — a suite of composable skills that enforces structured workflows from idea to merged branch. Skills trigger automatically based on context (no manual invocation needed).

Key content:

• Brainstorm-first gate: Before any code, the agent elicits a spec through Socratic questioning and presents it in reviewable sections
• Implementation planning: Breaks work into 2-5 minute tasks with exact file paths, complete code blocks, and verification steps
• Subagent-driven development: Dispatches a fresh subagent per task with a two-stage review (spec compliance, then code quality); designed for hours of autonomous work
• Mandatory TDD: RED → GREEN → REFACTOR enforced; code written before a test gets deleted and redone
• Full branch lifecycle: using-git-worktrees + finishing-a-development-branch cover the complete arc from workspace creation to merge/PR decision

Philosophy: Test-driven development as non-negotiable, systematic over ad-hoc, complexity reduction as primary goal, evidence over claims.

---

2. Score: 5/5 (Essential)

Score	Signification	Action
5	Essential — fills major gap	< 24h
4	High value — significant improvement	< 1 week
3	Moderate — useful complement	When time available
2	Marginal — secondary info	Minimal or skip
1	Low — reject	—

Justification

Points forts:

• ✅ 95,299 GitHub stars (verified via GitHub API, March 18, 2026) — among the most-starred Claude Code resources in existence
• ✅ 7,546 forks — genuine adoption signal, not bot-inflated
• ✅ Available on the official Claude Code plugin marketplace — /plugin install superpowers@claude-plugins-official
• ✅ obra already in our guide (line 8104, TDD skill at 721 skills.sh installs) — not mentioning the full suite is a credibility gap
• ✅ MIT license — freely integrable, referentiable
• ✅ Multi-platform (Claude Code, Cursor, Codex, OpenCode, Gemini CLI) — broad ecosystem relevance
• ✅ Structured workflow the guide lacks: brainstorm → spec → plan → subagent TDD → review → close — no single page in the guide covers this end-to-end pipeline
• ✅ Created Oct 2025, reached 95k stars in 5.5 months — clear community signal

Pourquoi 5/5 et pas 4/5: At 95k stars on a Claude Code tool (verified), this is the dominant community methodology for structured agentic development. The guide documents TDD, spec-first, plan-driven, and worktrees separately — but has no unified workflow suite entry at this adoption level. Not covering it is a meaningful gap.

---

3. Comparative Analysis

Aspect	Superpowers	Current guide
End-to-end methodology as a plugin suite	✅ Single /plugin install	❌ Scattered across 5+ workflow pages
Automatic skill triggering	✅ Context-based activation	❌ No equivalent (manual skill use)
Subagent-driven development	✅ Native skill with two-stage review	⚠️ Task tool documented mechanically
Branch lifecycle workflow	✅ finishing-a-development-branch	⚠️ Worktrees documented, not end-to-end lifecycle
TDD enforcement	✅ Code deleted if written before test	✅ tdd-with-claude.md covers cycle
Brainstorm-first spec gate	✅ brainstorming skill mandatory	⚠️ spec-first.md exists but not enforced
Plugin marketplace listing	✅ Official	❌ Not cross-referenced
Community adoption signal	✅ 95k stars / 7.5k forks	N/A

---

4. Fact-Check

Claim	Verified	Source
95k+ GitHub stars	✅ 95,299	GitHub API, March 18, 2026
7,546 forks	✅ Exact	GitHub API
MIT license	✅	GitHub API (license.spdx_id: MIT)
Available on official Claude Code marketplace	✅	README: /plugin install superpowers@claude-plugins-official
Created by Jesse Vincent, Prime Radiant	✅	GitHub repo, README attribution
Works with Claude Code, Cursor, Codex, OpenCode	✅	README installation sections
obra = test-driven-development skill on skills.sh	✅	Guide line 8104 (existing reference)
"Couple hours autonomous" claim	⚠️ Not measurable	Self-reported in README, no benchmark
Gemini CLI support	✅	README: gemini extensions install

No hallucinations detected. The "couple hours autonomous" claim is marketing language — no benchmark, can't verify. All other material claims check out.

---

5. Challenge (technical-writer agent)

Key challenges raised and resolved:

Challenge 1: "Verify the 95k star count before assigning 5/5" → Verified via GitHub API. 95,299 stars, 7,546 forks, created Oct 2025. This is the gate for the score — gate passed. Score stands at 5/5.

Challenge 2: "The guide already covers each component separately (TDD, spec-first, worktrees). Is Superpowers truly additive?" → Yes: the value is the package and automatic triggering. Users installing a single plugin get a structured methodology without manually composing five workflow pages. The guide has no single entry for "install this to enforce good workflow habits automatically." That's the gap.

Challenge 3: "Is third-party-tools.md + Plugin Ecosystem the right integration point?" → Partially agreed with challenge. Better approach: (a) upgrade the obra row at line 8104 in ultimate-guide.md to reference the full Superpowers suite with link, (b) add a dedicated Notable Workflow Suites entry in the Plugin Ecosystem section of third-party-tools.md alongside gstack, (c) reference from tdd-with-claude.md and spec-first.md as "community methodology that bundles this workflow."

Challenge 4: "What about the subagent workflow — is it really different from native Task tool?" → Superpowers' subagent-driven-development enforces a two-stage review (spec compliance then code quality) that the native Task tool doesn't provide out of the box. Worth noting as a genuine workflow differentiation.

Score adjustment: Challenge confirmed 5/5 after star count verification.

---

6. Integration Plan

Decision: INTEGRATE ✅ — Score 5/5, Priority: High

Where to integrate

1. ultimate-guide.md line ~8104 — Upgrade obra row

Current row:

| **Testing** | test-driven-development | 721 | obra |

Upgrade to note the full suite exists, with link to Superpowers.

2. guide/ecosystem/third-party-tools.md — Plugin Ecosystem section

Add Superpowers to the Notable Skill Packs section alongside gstack. Entry format:

- **[Superpowers](https://github.com/obra/superpowers)** — Full software development methodology suite (95k+ stars). 7 skills covering the complete arc: spec elicitation, implementation planning, subagent-driven development with two-stage review, mandatory TDD (RED → GREEN → REFACTOR), code review, git worktrees, and branch lifecycle completion. Context-aware: skills trigger automatically based on task type. Install: `/plugin install superpowers@claude-plugins-official`. Created by Jesse Vincent (Prime Radiant). MIT. Supported platforms: Claude Code, Cursor, Codex, OpenCode, Gemini CLI.

3. guide/workflows/tdd-with-claude.md — Cross-reference

Add a note: "Superpowers bundles TDD enforcement as an automatic skill that deletes code written before a test — a stricter version of this workflow available as a plugin."

4. guide/workflows/spec-first.md — Cross-reference

Add: "Superpowers' brainstorming skill enforces spec-first as a mandatory gate before any code is written, available as a Claude Code plugin."

Priority

High — The obra credibility issue (guide mentions them at 721 installs, not the 95k-star suite) makes this time-sensitive. Fix the obra row first (5 min), then Plugin Ecosystem entry (15 min).

---

7. Final Metadata

Initial Score: 4/5 Score after challenge + fact-check: 5/5 Decision: Integrate ✅ Confidence: High (all material facts verified)

Integration Timeline:

1. ✅ Evaluation complete (2026-03-18)
2. ⏳ Upgrade obra row in ultimate-guide.md ~line 8104
3. ⏳ Add entry in Plugin Ecosystem section of third-party-tools.md
4. ⏳ Cross-reference from tdd-with-claude.md and spec-first.md

Archive: docs/resource-evaluations/obra-superpowers-evaluation.md

---

Evaluation complete: 2026-03-18 Attribution: Jesse Vincent, github.com/obra/superpowers