e76c623fd2
- Add resource evaluation for Obra Superpowers (docs/resource-evaluations/) - Minor updates to third-party-tools.md, ultimate-guide.md, spec-first.md, tdd-with-claude.md - Update CHANGELOG Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
161 lines
No EOL
8.8 KiB
Markdown
161 lines
No EOL
8.8 KiB
Markdown
# 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:
|
||
|
||
```markdown
|
||
- **[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](https://github.com/obra/superpowers)* |