265,000 Stars and I Don't Use Any of It

A friend sent me obra/superpowers. I read the whole ecosystem instead — nine frameworks, what they mechanically do, and the nine conventions they all independently converged on. Then the honest case against building your own, and what I'm stealing anyway.

265,000 Stars and I Don't Use Any of It — AI

A friend sent me a link this morning: obra/superpowers. Jesse Vincent's agentic skills framework for Claude Code.

265,503 stars. I pulled that from the API rather than trusting the badge, because I assumed I was misreading it. I wasn't. Twenty-three thousand forks. Created in October 2025. It is, by star count, one of the most popular repositories on GitHub.

I have never used it. I have never used any of them. I run a heavily customised setup of my own design, and my justification has always been the same one sentence: I know exactly what mine does.

That's a comfortable position. It's also the kind of position that quietly rots if you never test it. So I spent the morning actually reading the ecosystem — the source, not the marketing — and this is what's in there, what they've all independently agreed on, and what I'm stealing without installing anything.


First, the Scale of This Thing

Star counts are a vanity metric. They are also the only comparable number available across projects with wildly different distribution channels. Pulled live from the GitHub API on 3 August 2026:

ProjectStarsForksWhat it is
obra/superpowers265,50323,735Skills framework + enforced development method
github/spec-kit125,13511,184Spec-driven development toolkit
Fission-AI/OpenSpec63,6064,400Change-local specs and archival
hesreallyhim/awesome-claude-code51,5774,493Curated list — not a framework
bmad-code-org/BMAD-METHOD51,4205,900Agile-org-as-personas methodology
eyaltoledano/claude-task-master27,9352,623Persistent task graph layer
oraios/serena27,4671,822Semantic code retrieval via MCP
SuperClaude-Org/SuperClaude_Framework23,6131,988Command and persona configuration
buildermethods/agent-os5,158813Workflow and standards layer

Two things stand out. Superpowers has more than twice the stars of GitHub's own spec-kit. And awesome-claude-code, sitting at 51k, is a list of links — it out-stars most of the actual software. Discovery is apparently a harder problem than methodology.


What Superpowers Actually Is

Mechanically it is unglamorous, and that's the point. It's Markdown. A skill is a directory containing an instruction file plus any scripts it references. There is no runtime, no model wrapper, no clever inference.

It installs through Anthropic's own plugin marketplace:

/plugin install superpowers@claude-plugins-official

# or from the project's own marketplace
/plugin marketplace add obra/superpowers-marketplace

What you get is a library of skills that trigger on context rather than on request — the agent is instructed to check whether a skill applies before doing anything, load it, and follow it. The README is blunt about the intent: "Mandatory workflows, not suggestions."

The enforced sequence:

PhaseWhat it does
1. BrainstormingRefines a rough idea through questions, explores alternatives, presents the design in sections for approval. You do not get to code yet.
2. Git worktreeIsolates the work in its own branch and directory before anything is written
3. Writing plansDecomposes into tasks of 2–5 minutes each
4. Subagent-driven developmentA fresh subagent per task, each passed through a two-stage review
5. Test-driven developmentStrict RED-GREEN-REFACTOR — write the failing test, watch it fail, then write the minimum code
6. Code reviewChecked against the plan, issues reported by severity
7. Verification before completionFresh evidence required. Not "this should work"
8. Branch completionAn explicit merge-or-PR decision rather than an ambiguous working state

The stated philosophy is four lines: test-driven development, systematic over ad-hoc, complexity reduction, evidence over claims. The pitch is that agents can work autonomously for a couple of hours without drifting off the plan.

🎯
THE CLAIM UNDERNEATH IT

Superpowers is arguing that model capability is not what is failing you. The failure is uncontrolled process: coding before the problem is defined, untested assumptions, vague plans, and agents declaring victory without ever running anything.

I think that diagnosis is largely correct. Almost every bad session I have had was a process failure, not an intelligence failure. Where I part company is on how much ceremony is the right response.

These Are Not All the Same Thing

The single most useful thing to come out of the morning was realising that "Claude Code framework" is a label covering at least seven different categories of software, which people compare as though they were competitors. A prompt library cannot give you process isolation. An orchestration runtime does not produce good specifications. A GUI that launches six agents is not a multi-agent strategy — it's six terminals with better ergonomics.

CategoryWhat it actually doesExamples
Skill & prompt librariesReusable instruction bundles that beat ad-hoc promptingSuperpowers, SuperClaude, Anthropic Skills
Workflow methodologiesPrescribed phases and gates to stop agents jumping straight to codeSuperpowers, BMAD-METHOD, Agent OS
Spec-driven systemsRepo files holding requirements, plans and change history — intent that survives compactionspec-kit, OpenSpec, cc-sdd
Orchestration runtimesA coordinator dispatching multiple agents and aggregating resultsclaude-flow
Task-management layersMachine-readable task graphs that make long work resumableclaude-task-master
Context & memoryRetrieval and project memory so agents get relevant context without the whole repoSerena
GUI runnersRunning several agents without terminal chaosConductor, Crystal
Curated listsDiscovery only. A directory, not a framework — evaluate accordinglyawesome-claude-code

The other four worth knowing

ProjectThe mechanicsIts real weakness
GitHub spec-kituv tool install specify-cli scaffolds a .specify/ workspace and adds ten commands — constitution, specify, clarify, plan, tasks, taskstoissues, implement, plus analyze, checklist and converge. Works across 30+ agents.Synchronisation. Specs, tasks, tests and code can each claim authority. Unless completion updates the right artifact, the repo accumulates beautifully structured lies.
BMAD-METHODA simulated product org — analyst, PM, architect, scrum master, dev, QA — with templates carrying an idea through requirements, architecture, stories and QA.Cargo cult. A role prompt does not create independent expertise, and passing text between personas can amplify one early false assumption.
claude-task-masterTurns a PRD into a persistent task graph with dependencies, complexity scores and a next-task operation. CLI or MCP.It inherits every omission in the input, and agents can spend more time maintaining task metadata than shipping.
SerenaAn MCP server for semantic code navigation — symbol lookup, references, structural summaries — instead of pasting whole files.It is a retrieval layer, not a method. Solves a real problem, imposes no discipline.

What They All Independently Agreed On

This is the section that changed my mind about the exercise being worthwhile.

Where these projects differ is mostly taste. Where they converged is evidence. These are separate teams, separate philosophies, separate audiences — arriving at the same primitives:

ConventionWhy everyone landed here
Plan before codeUnconstrained agents collapse problem definition and implementation into one fluent guess
Persist intent in the repoChat history is an execution trace, not durable project state. Specs and plans survive compaction; conversations don't
Decompose aggressivelySmall tasks give clearer completion conditions and shrink the blast radius of a misunderstanding
Fresh context for bounded workSubagents help less because they're "specialists" and more because they get a clean, limited problem. Context isolation is a correctness tool
Separate implementation from reviewAsking a context to reconsider its own work produces anchoring. A second, independent pass is materially different
Verify with evidenceA completion claim must name and run the tests. "This should work" is not verification
Isolate concurrent workWorktrees don't solve semantic conflicts but they stop agents trampling each other's filesystem
Curate memory, don't accumulate itSuccessful systems keep a compact curated memory. Unsuccessful ones dump an ever-growing transcript into the prompt
Human approval at high-leverage pointsApproving a plan is far cheaper than reviewing a thousand lines built on the wrong premise

That list is not one framework's opinion. It's the shape of the problem showing through. Agentic coding has developed recognisable engineering primitives, and it took about eighteen months.


The Honest Case Against Me

Let me steelman the thing I don't do, because "I know what mine does" can very easily become a flattering story.

ArgumentThe uncomfortable version
Scar tissueSomeone else already discovered that agents skip the failing-test step, claim verification from stale output, and lose task state after compaction. Mature instruction wording contains fixes for bugs I have not hit yet.
Upgrade pathModel behaviour changes. A prompt that reliably triggered tool use last year can produce ritual this year. Maintaining that compatibility is real work I am doing alone.
It isn't teachableMy system is efficient partly because it lives in my head. That is not a team platform. A named method lets someone else install the same components and argue with me in shared language.
DiscoveryFresh-agent review, worktree isolation, repo constitutions, explicit clarification passes — each obvious after seeing it. I would not have invented all of them.
Opportunity costBuilding agent infrastructure is seductive because every improvement feels multiplicative. Sometimes installing a good-enough framework is the disciplined choice, not the lazy one.

And the Case For Doing It Myself

Now the other side — and here there are actual numbers, not just preference.

📉
THE CONTEXT BILL NOBODY PUTS ON THE README

By April 2026 there were over 9,000 Claude Code plugins in circulation. Roughly 100 of them are production-ready.

Vercel ran agent evaluations and found skills were never invoked in 56% of test cases — more than half the loaded tooling sitting there doing nothing but occupying context.

MCP servers load their full tool definitions at session start whether you use them or not. In March 2026 people on $200/month plans were reporting five-hour windows evaporating in ninety.

Every instruction you install competes with the code you are trying to reason about.
ArgumentWhy it holds
CausalityWhen something behaves strangely under a layered framework, was it the base model, global instructions, project rules, an auto-selected skill, a hook, an MCP tool description, or the orchestrator? A small custom stack is a tractable one.
Generic gates mismatch real reposA monorepo with hermetic tests and mandatory ownership checks needs different gates from a mobile prototype. Framework defaults encode the author's development culture and then present it as universal method.
Version churnCommand names, directory conventions and orchestration APIs change independently of your application. Pin and forfeit improvements, or track latest and import behavioural changes.
Ceremony has a floorThe full Superpowers sequence on a three-line fix is absurd. Gates that can't be skipped are a feature on a feature and a tax on a typo.
Building it IS the understandingWriting my own planning gate forced me to define what a useful plan contains. Implementing task claims taught me where concurrency actually breaks. That understanding isn't overhead next to the value — for an AI-native engineer it may be the value.

One caveat I'll hold myself to: the strongest custom setup is not a pile of personal prompts. It's a small, inspectable framework built for one environment, with explicit interfaces and its own tests. If mine isn't that, the argument doesn't apply to me.


What I'm Stealing Without Installing Anything

This is the actual output of the morning. Nine techniques, each portable into a custom setup, none requiring you to adopt the surrounding mythology.

FromSteal thisHow
SuperpowersVerification before completionRule: every completion report must include the command run, its exit status, and a one-line interpretation. No inferring success from reading the code.
SuperpowersTwo-stage reviewOne fresh context gets the spec and the diff and answers only does this meet requirements. A second gets the diff and conventions and answers is this correct and maintainable. Asking both at once invites trading one against the other.
spec-kitThe repository constitutionA short versioned file of non-negotiables — architecture constraints, test expectations, forbidden shortcuts. Load it during spec and review, not into every trivial interaction.
OpenSpecChange-local specs with archivalEach substantial change gets its own directory: proposal, requirements delta, plan, outcome. After shipping, merge durable decisions into canonical docs and archive the rest.
BMADArtifact contracts, not role-playDefine what a PRD or implementation story must contain — open questions, acceptance criteria. You don't need six named personas to fill them in.
claude-task-masterPersistent task stateTask IDs, dependencies, status and verification criteria in a machine-readable file. Workers claim before executing and update only on evidence.
claude-flowTopology disciplineParallelise only independent leaves of the task graph. One coordinator owns shared decisions and synthesis. Don't let every worker rewrite the plan.
SerenaSemantic retrieval over file dumpsExpose symbol lookup, references and structural summaries as tools. Keep retrieved context attributable so the agent can tell repo facts from its own remembered summary.
SuperClaudeA small command vocabularyspecify, plan, implement, review, verify. Each declaring inputs, outputs, allowed tools and completion conditions. Far easier to debug than one omnipotent prompt.

Where This Goes

Anthropic shipping official Skills, Plugins and a marketplace absorbs the packaging layer. Discovery, installation, namespacing, updates, hooks, distribution — those are natural vendor features, and Superpowers already installs through the official marketplace. MCP does the same for tool exposure: "our framework can call a database" stops being an advantage once every client speaks the protocol.

Parallel sessions, worktrees, background execution, diff views and resumability will drift down into the products too. Launching several agents will stop being distinctive.

What survives is the layer containing judgment. A methodology that encodes how your company designs migrations or reviews security-sensitive changes. A context system that understands your ownership and build structure. An orchestration policy that knows which tasks are safely parallel in your architecture.

The investment rule falls out of that: don't build proprietary machinery for commodity installation, generic protocols or terminal multiplexing. Invest in inspectable workflow definitions, domain-specific gates, evaluation, durable project memory, and verification that produces evidence.


So — Do I Install It?

No. And I'm more comfortable with that than I was this morning, for a better reason than I had this morning.

The reason isn't that these projects are bad. Superpowers is genuinely good, and its core diagnosis — that process, not model capability, is what's failing you — is right. 265,000 people did not star a Markdown repository by accident.

The reason is that the value in these frameworks is the ideas, and ideas are free. The packaging costs context, opacity and version churn. The nine techniques in the table above are the entire payload. I can implement every one of them in my own system, in my own vocabulary, tuned to my own repositories, and still be able to explain what every instruction in my stack is doing and why.

But the position only holds under one condition, and it's worth stating plainly because it's the part that's easy to skip:

⚔️
"I know what mine does" is only defensible if I keep testing it against the ecosystem's best ideas.

Refusing the package can be rational.

Refusing the accumulated lessons is not.

I've been running my own setup for long enough that I'd stopped reading anyone else's. That was the actual mistake — not the building. One link from a friend was worth a morning, and I came out with nine things to implement and a much sharper account of why I'm not installing the thing that gave them to me.

💬
Working with a team that wants to adopt AI-native workflows at scale? I help engineering teams build this capability — workflow design, knowledge architecture, team training, and embedded engineering. → AI-Native Engineering Consulting

Related Reading