オープンソースプロジェクト観察
Superpowers:141kスター、AIコーディングエージェントに「ワークフローエンジン」を搭載
AIでプログラミングしているが、「メソドロジー」はあるか?
多くの人がAIプログラミングでやっていることはこうだ:
要件を渡すと、AIはすぐにコードを書き始める。書き終わったところで違和感を覚え、修正を依頼する。修正したらまた別の問題が見つかり、また修正。こうしたやり取りを数回繰り返すうちにコードは混沌としていき、最終的には何をしているのかさえ不明になる。
問題の所在:AIには「能力」はあるが、「メソドロジー」がない。
コードを書くことはできても、計画を立てられない。バグ修正はできても、立ち止まって考えるべきタイミングがわからない。指示に従って作業はするが、自発的に品質を高めようとはしない。
Superpowersが解決するのは、まさにこの問題だ。
141kスター、「エージェントワークフロー」フレームワーク
Superpowersは、AIコーディングエージェント専用に設計された完全なソフトウェア開発ワークフローフレームワークである。
その核となるのは:組み合わせ可能な「スキル」のセットと、エージェントがそれらを正しく使用するための初期命令。
これは新規ツールではなく、Claude Code、Cursor、Codex、OpenCodeなどのプラットフォームに導入できる「メソドロジーレイヤー」である。
仕組み
ステップ1:コードを書く前に
コーディングエージェントは、あなたが何を構築したいかを見ると、すぐにコードを書き始めるのではない。
その代わり、立ち止まって問いかける:「本当に何をしたいのか?」
質問を通じて、要件を具体化し、代替案を検討し、理解しやすいサイズの設計として提示する。
ステップ2:実装計画の分解
設計が承認されると、「情熱はあるがセンスがなく、判断力もプロジェクトの文脈もなく、テストを嫌う新人エンジニア」でも追えるほど明確な実装計画を作成する。
重点ポイント: - 真のレッド/グリーンTDD - YAGNI(You Aren't Gonna Need It - 必要になるまで作るな) - DRY(Don't Repeat Yourself - 繰り返しを避ける)
ステップ3:サブエージェント駆動開発
「開始」と伝えると、「サブエージェント駆動開発」プロセスが始まる:エージェントは各エンジニアリングタスクを順次完了し、作業を確認・レビューしてから次に進む。
Claudeは数時間にわたり、二人で決めた計画から逸れることなく、自律的に作業を進めることができる。
コアワークフロー
Superpowersは完全な開発プロセスを定義する:
1. brainstorming
コードを書く前に活性化。質問を通じて曖昧なアイデアを具体化し、代替案を検討し、設計をセグメントごとに提示して検証する。設計ドキュメントを保存。
2. using-git-worktrees
設計承認後に活性化。新規ブランチに隔離された作業スペースを作成し、プロジェクト設定を実行し、クリーンなテストベースラインを検証。
3. writing-plans
設計承認後に活性化。作業を小さなタスク(各2〜5分)に分解。各タスクには正確なファイルパス、完全なコード、検証手順を含める。
4. subagent-driven-development
計画策定後に活性化。各タスクに新しいサブエージェントをディスパッチし、二段階のレビュー(仕様適合性、次にコード品質)を実施。コードの品質が悪いときは、先に進まず停止してレビューする。
5. test-driven-development
実装中に活性化。RED-GREEN-REFACTORを強制:失敗するテストを書く → 失敗を確認 → 最小限のコードを書く → パスを確認 → コミット。テストの前に書かれたコードは削除。
6. requesting-code-review
タスク間で活性化。計画に基づいてレビューし、重大度別に問題を報告。重大な問題は進行をブロック。
7. finishing-a-development-branch
タスク完了後に活性化。テストを検証し、オプション(merge/PR/keep/discard)を提示し、ワークツリーをクリーンアップ。
エージェントは各タスクの前に、関連スキルをチェックする。 これは推奨ではなく、強制的なワークフローである。
スキルライブラリ
テスト
- test-driven-development:RED-GREEN-REFACTORサイクル(テストのアンチパターン参考情報を含む)
デバッグ
- systematic-debugging:4段階の根本原因特定プロセス(根本原因追跡、多層防御、条件ベースの待機技術を含む)
- verification-before-completion:確実に修正されたことを保証
コラボレーション
- brainstorming:ソクラテス式の設計具体化
- writing-plans:詳細な実装計画
- executing-plans:チェックポイント付きの一括実行
- dispatching-parallel-agents:並行サブエージェントワークフロー
- requesting-code-review:事前レビューチェックリスト
- receiving-code-review:フィードバックへの対応
- using-git-worktrees:並行開発ブランチ
- finishing-a-development-branch:マージ/PR判断ワークフロー
- subagent-driven-development:迅速な反復+二段階レビュー
メタ
- writing-skills:ベストプラクティスに従った新規スキル作成(テストメソドロジーを含む)
- using-superpowers:スキルシステムの紹介
インストール方法
複数のプラットフォームに対応:
Claude Code(公式マーケット)
/plugin install superpowers@claude-plugins-official Cursor
/add-plugin superpowers Codex
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md OpenCode
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md Gemini CLI
gemini extensions install https://github.com/obra/superpowers コア哲学
- テスト駆動開発:常にテストを先に書く
- 体系的でアドホックではない:推測よりもプロセスを優先
- 複雑性の低減:シンプルさが主目標
- 主張より証拠:成功を宣言する前に検証する
なぜ注目すべきか
多くのAIコーディングツールは「能力」だけを提供する:コードを書き、バグを修正し、ロジックを説明できる。
しかしSuperpowersが提供するのは「メソドロジー」だ:計画のために立ち止まるべきタイミング、テストすべきタイミング、レビューすべきタイミングを知っている。
能力は速さを、メソドロジーは安定をもたらす。
141kスターが証明している:AIコーディングを本当に使いやすくするのは、より強力なモデルではなく、より良いワークフローなのだ。
関連リンク:
- GitHub:https://github.com/obra/superpowers
- 作者ブログ:https://blog.fsck.com/2025/10/09/superpowers/
- Discord:https://discord.gg/35wsABTejz
- 作者:Jesse Vincent(Prime Radiant)