SuperPowers：Claude Codeの開発ワークフローを変えるプラグイン

注意: 本記事は2026年2月21日時点のSuperPowers v4.3.0（2026-02-12リリース）に基づいています。オープンソースプロジェクトのため、最新の仕様は公式リポジトリをご確認ください。

はじめに

「Claude Codeに機能実装を頼んだら、いきなりコードを書き始めて、あとから手戻りが大量に発生した...」

「テスト書いてねと指示したのに、実装コードを先に書いてからテストを後付けしていた...」

Claude Codeを日常的に使っている開発者なら、こうした経験に心当たりがあるのではないでしょうか。Claude CodeはTDDやシステマティックデバッグの概念を知っています。しかし、知っていることと実践することは別です。時間的プレッシャーや文脈の複雑さの中で、近道を選んでしまうことがあります。

SuperPowersは、この問題に構造的に対処するClaude Code用のオープンソースプラグインです。Jesse Vincent氏によって開発され、MITライセンスで公開されています。

本記事では、SuperPowersの導入方法から主要スキルの活用術まで、コードに基づいた事実をもとに解説します。

SuperPowersとは

SuperPowersは、Claude Codeに体系的なソフトウェア開発ワークフローを付与するプラグインです。READMEには、目標として「Claudeが1〜2時間、計画から外れることなく自律的に作業し続けられること」と記されています。

具体的には、以下のような振る舞いを実現します。

• 実装を依頼すると、いきなりコードを書かず、まずbrainstormingで設計を固める
• 設計が決まると実装計画書を作成し、タスクを分割する
• 各タスクはTDD（テスト駆動開発）で実装される
• 実装後に2段階のレビュー（仕様準拠→コード品質）が自動で走る

これらは「スキル」と呼ばれるMarkdownファイルで定義されており、ユーザーが明示的にコマンドを打たなくても、会話の文脈に応じてClaude自身が適切なスキルを自動で呼び出します。これが「スキルの自動発火」です。

インストール方法

前提条件

Claude Codeがインストールされていること。

インストール

claude plugin add obra/superpowers

これだけで導入は完了です。

アンインストール

claude plugin remove superpowers

動作確認

新しいセッションを開始して、何か機能の実装を依頼してみてください。以下のように Skill(superpowers:brainstorming) が表示され、設計の質問から始まれば、SuperPowersが正しく動作しています。

仕組み：スキルの自動発火

SuperPowersの動作原理は、Claude Codeのフックシステムを使ったシンプルな設計です。

SessionStartフック

プラグインのエントリポイントは hooks/hooks.json です。

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume|clear|compact",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh",
            "async": false
          }
        ]
      }
    ]
  }
}

セッション開始時にシェルスクリプトが実行され、using-superpowers というブートストラップスキルの全文がClaudeのシステムコンテキストに注入されます。async: false に設定されているのは、非同期だと最初のメッセージにコンテキストが間に合わないという問題がv4.3.0で修正されたためです。

スキルの構造

スキルは skills/<スキル名>/SKILL.md というMarkdownファイルです。YAMLフロントマターに名前と説明を持ちます。

---
name: brainstorming
description: Use when starting any creative work - creating features,
  building components, adding functionality, or modifying behavior
---
 
# Brainstorming Ideas Into Designs
 
## Overview
Help turn ideas into fully formed designs through natural
collaborative dialogue.

descriptionフィールドにはスキルが発火する条件のみが書かれています。ワークフローの詳細は本文に記載されます。リリースノートには「The Description Trap」と呼ばれる発見が記録されています。descriptionにワークフロー概要を書くと、Claudeが本文を読まずにdescriptionだけに従ってしまう問題です。そのため、descriptionは「Use when...」で始まるトリガー条件のみに制限されています。

合理化防止テーブル

SuperPowersの設計で注目すべきは、AIがスキルを飛ばそうとする「合理化」パターンへの明示的な対策です。using-superpowers/SKILL.md には以下のテーブルが含まれています。

各エントリは、実際のテスト中にAIがその合理化を使ってスキルを飛ばした事例から追加されたものです。

主要スキル紹介

SuperPowersに含まれる主要なスキルを紹介します。

1. brainstorming - 設計を先に固める

発火条件: 機能実装、コンポーネント作成、動作変更など、何かを「作る」タスク

実装に入る前に、1問ずつ質問して設計を合意するスキルです。SKILL.mdに記されたプロセスは以下の通りです。

1. プロジェクトの現状を把握する
2. 1回のメッセージで1つの質問をする（選択肢形式を優先）
3. 2〜3のアプローチを提案し、推奨案と理由を示す
4. 設計を200〜300語ずつのセクションに分けて提示し、各セクションごとに承認を取る
5. 承認された設計を docs/plans/ にドキュメントとして保存する

2. writing-plans - タスクに分割した実装計画

発火条件: 仕様やbrainstormingの成果がある状態で、複数ステップの実装に入るとき

設計を元に具体的な実装計画を作成するスキルです。計画は docs/plans/YYYY-MM-DD-<トピック>-plan.md に保存されます。

3. test-driven-development - テスト駆動開発の強制

発火条件: 機能実装やバグ修正に入るとき

SuperPowersのTDDスキルは、SKILL.mdで以下のルールを明示しています。

テストなしにプロダクションコードを書いてはならない

テストの前にコードを書いた？ 削除しろ。やり直せ。

例外なし:

• 「参考として」残すな
• テストを書きながら「適応」するな
• 見るな
• 削除とは削除である

RED-GREEN-REFACTORサイクルが強制されます。まずテストを書いて失敗させ（RED）、テストを通す最小限のコードを書き（GREEN）、リファクタリングする（REFACTOR）。

4. subagent-driven-development - サブエージェント並列開発

発火条件: 実装計画にある独立したタスクを実行するとき

タスクごとに新しいサブエージェントを起動し、実装後に2段階のレビューを行うスキルです。

2段階レビューの流れ:

1. サブエージェントが実装（TDD適用、コミット、セルフレビュー）
2. スペック準拠レビュー - 仕様通りに実装されているかを検証。レビュープロンプトには「実装者のレポートを信用するな。必ず実際のコードを読んで、要件と1行ずつ比較しろ」と明記されている
3. コード品質レビュー - スペック準拠レビューを通過した後にのみ実行。クリーンコード、テストカバレッジ、保守性を検証

この順序には意図があります。コードがきれいでも仕様と違えば意味がないため、スペック準拠が先です。

5. using-git-worktrees - 作業環境の分離

発火条件: 機能開発やバグ修正のために隔離された作業環境が必要なとき

gitのworktree機能を使って、作業用の独立したディレクトリとブランチを自動作成するスキルです。メインブランチの状態を汚さずに開発を進められます。

6. systematic-debugging - 体系的デバッグ

発火条件: バグ、テスト失敗、予期しない動作に遭遇したとき

推測で修正を試みるのではなく、仮説を立ててから検証する体系的なデバッグ手法を適用するスキルです。SKILL.mdには、フレイキーテスト対策の具体的なパターンも含まれています。

// ❌ タイミングを推測する
await new Promise(r => setTimeout(r, 50));
 
// ✅ 条件ベースで待機する
await waitFor(() => getResult() !== undefined);

7. finishing-a-development-branch - 作業の完了

発火条件: 実装完了後、すべてのテストが通った状態

作業ブランチの完了方法として、以下の選択肢を構造的に提示するスキルです。

• メインブランチにマージ
• Pull Requestを作成
• ブランチを保持（後で判断）
• 変更を破棄

実際の開発フロー

これらのスキルは個別に動作するのではなく、一連のワークフローとして連携します。

ユーザー「認証機能を実装して」
  │
  ▼
brainstorming
  1問ずつ質問 → 2-3案提示 → 設計合意
  │
  ▼
using-git-worktrees
  作業用worktreeを作成し、本体から分離
  │
  ▼
writing-plans
  実装計画書をdocs/plans/に作成、タスク分割
  │
  ▼
subagent-driven-development
  タスクごとにサブエージェント起動
  ├── 各タスク内でTDD適用
  └── 各タスク後に2段階レビュー
      （スペック準拠 → コード品質）
  │
  ▼
finishing-a-development-branch
  merge / PR / 保持 / 破棄 を選択

ユーザーは最初に要望を伝えるだけで、このフローがスキルの自動発火で順番に進みます。各ステップで確認が入るため、完全に自動ではなく、対話的に進行します。

カスタマイズ

個人スキルの追加

~/.claude/skills/<スキル名>/SKILL.md にファイルを配置すると、個人スキルとして認識されます。同名のスキルがある場合、個人スキルがSuperPowersのスキルよりも優先されます。

SuperPowersのスキルを明示的に呼び出したい場合は、superpowers:プレフィックスを使います（例: superpowers:brainstorming）。

カスタムスキルのファイル構成

独自スキルを作成する場合のファイル構成は以下の通りです。

~/.claude/skills/
  └── my-skill/
      └── SKILL.md

SKILL.md はYAMLフロントマターに name と description を持つMarkdownファイルです。description はスキルが発火するトリガー条件のみを記述し、ワークフロー詳細は本文に書きます。

まとめ

SuperPowersは、Claude Codeの振る舞いを「知識はあるが規律がないAI」から「体系的なワークフローに従うAI」に変えるプラグインです。

• 導入は1コマンド: claude plugin add obra/superpowers
• 自動で効く: 会話の文脈からスキルが自動発火し、設計→計画→TDD→レビューのフローが適用される
• カスタマイズ可能: ~/.claude/skills/ に個人スキルを追加できる

Claude Codeを日常的に使っていて、AIの出力品質をもう一段引き上げたい方は、試してみる価値があります。

大規模Monorepo × Claude Codeで実現する開発体験の向上

3つの大規模プロジェクトを抱えるMonorepoに、Claude Codeのフック・Agent・Skillsを統合し、開発体験を劇的に改善した実践例を紹介します。Turborepoとの組み合わせで実現した品質担保と効率化の工夫をご覧ください。

2025-11-16

LLMにWikiを育てさせる：llm-wikiとArs Contextaを実運用視点で比較する

Andrej Karpathyが提唱した「llm-wiki（Memexパターン）」とClaude Codeプラグイン「Ars Contexta」を、一次ソースの引用と7つのwikiを実運用した経験の両面から比較。それぞれの設計思想・アーキテクチャ・メリデメと、どちらを選ぶべきかの判断軸を解説します。

2026-06-03