marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: add Obra Superpowers eval + minor doc updates

Browse source 
- 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>
This commit is contained in:
Florian BRUNIAUX 2026-03-18 18:26:00 +01:00
parent 44818a3f04
commit e76c623fd2
6 changed files with 167 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

161
docs/resource-evaluations/obra-superpowers-evaluation.md Normal file
View file

@ -0,0 +1,161 @@
# 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)*