10
7

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

🔥まだまだ出てくる♪コード生成AIの能力を高める「oh-my-claude-code」

10
Last updated at Posted at 2026-04-02

image.png

⚡ oh-my-claudecode(OMC)とは?

oh-my-claudecodeは、韓国のエンジニアYeachan Heo氏が開発したClaude Code用のマルチエージェントオーケストレーションプラグインです。GitHub上で20,100+スターを獲得し、急速に注目を集めています。

コンセプトは「Don't learn Claude Code. Just use OMC.」——つまり、Claude Codeの複雑なコマンドや設定を覚える必要なく、自然言語で指示するだけで32の専門エージェントが自動的にタスクを分担・並列実行してくれます。

特に強力なのが Deep Interview → Ralplan → Autopilot の3ステージパイプライン。要件定義から設計レビュー、実装まで、人間のソフトウェア開発プロセスをAIが忠実に再現しつつ、各フェーズを大幅に圧縮します。


😱 素のClaude Codeあるある5選

Claude Codeをそのまま使っていると、こんな経験ありませんか?

  • 「要件が曖昧なまま実装が始まって手戻りが…」 → 要件の曖昧さを定量化する仕組みがなく、「何を作るか」が不明確なまま走り出してしまう
  • 「設計レビューなしでいきなりコード生成…」 → アーキテクチャ判断が場当たり的になり、後から大規模な修正が必要になる
  • 「複数ファイルの整合性が取れない…」 → 1つのエージェントが順番に処理するため、ファイル間の命名規則やパス規約がバラバラになりがち
  • 「大規模プロジェクトだと時間がかかりすぎる…」 → 並列処理ができず、数十ファイルの生成に膨大な時間がかかる
  • 「毎回ゼロからのスタート…」 → 過去のセッションで学んだパターンやデバッグ知見が蓄積されない

oh-my-claudecodeは、これらの課題をマルチエージェント+3ステージパイプラインで解決します。


🎯 3ステージパイプライン — OMCの心臓部

oh-my-claudecodeの最大の特徴は、Deep Interview → Ralplan → Autopilot の3段階パイプラインです。人間のソフトウェア開発プロセス(要件定義 → 設計レビュー → 実装)をAIで再現し、各フェーズを劇的に圧縮します。

🔍 Stage 1: Deep Interview(要件明確化)

ソクラテス式の質問法で、プロジェクトの要件を体系的に明確化するステージです。

  • 曖昧度スコアリング: 要件の曖昧さを数値化(100% → 目標20%以下)し、ゲート条件をクリアするまで質問を繰り返す
  • Contrarian Mode: 「本当にその機能はMVPに必要ですか?」と挑戦的な問いを投げかけ、スコープクリープを防止
  • Simplifier Mode: 複雑な要件を最小限のコア価値に絞り込む
  • 出力: 構造化された仕様書(spec.md

人間同士の会議では遠慮から出にくい「本当にそれ要る?」という本質的な疑問を、AIだからこそ遠慮なく投げかけてくれるのが秀逸です。

📋 Stage 2: Ralplan(コンセンサス計画策定)

3つの専門AIロール(Planner / Architect / Critic)がコンセンサスを形成する計画策定ステージです。

  • Planner: 実装計画を立案(フェーズ構成、タスク分解、リスク分析)
  • Architect: 技術的な観点でレビューし、問題点を指摘(ITERATE / ACCEPT判定)
  • Critic: 最終的な品質評価を行い、承認(ACCEPT / ACCEPT-WITH-RESERVATIONS判定)

人間のアーキテクトレビューと同等の品質チェックが自動で行われ、サロゲートキー採用やAPI設計方針など、実装段階で問題になりがちな設計判断を事前に確定できます。

  • 出力: コンセンサス計画書(plan.md)+ ADR(Architecture Decision Record)

🚀 Stage 3: Autopilot(自律実装)

コンセンサス計画に基づき、複数の専門エージェントが並列で実装を実行するステージです。

  • 並列エージェント: Backend / Frontend / Database / Security / Documentation など、専門分野ごとにエージェントが分業
  • 自律実行: 高レベルの指示から動作するテスト済みコードまで、手動介入なしで完走
  • Architect検証: 自己参照ループで完了まで検証を繰り返す

🤖 32の専門エージェント & 実行モード

OMCには32の専門エージェントが搭載されており、タスクの性質に応じて自動的にルーティングされます。

主な実行モード

モード 説明
Autopilot 完全自律実行。アイデアから動作するコードまで一気通貫
Ultrapilot 最大5並列ワーカーで、Autopilotの3〜5倍速
Team N個の協調エージェントが共有タスクリストで連携(v4.1.7〜の標準方式)
Deep Interview ソクラテス式Q&Aで要件を精緻化
Ralph 自動検証と修正を繰り返すセルフヒーリングループ
Ralplan 反復的コンセンサス戦略による計画セッション

スマートモデルルーティング

タスクの複雑さに応じて、自動でモデルを使い分けます。

  • 簡単なタスク → Haiku(高速・低コスト)
  • 通常の実装 → Sonnet(バランス型)
  • 複雑な推論 → Opus(高精度)

これにより、トークンコストを30〜50%削減しながら、適材適所の処理を実現します。


🧠 自動学習エンジン

OMCは使えば使うほど賢くなります。

  • デバッグで苦労したパターンを自動的に識別
  • ポータブルな .omc スキルとして保存
  • 将来のセッションで自動的に注入

つまり、同じミスを繰り返さない「成長するAI開発環境」を実現しています。


🛠️ インストール方法

インストールはClaude Codeのプラグインシステムで簡単に完了します。

ステップ1: マーケットプレイスに追加

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

ステップ2: プラグインをインストール

/plugin install oh-my-claudecode

これだけで、32のエージェント・複数の実行モード・自動学習エンジンが即座に使えるようになります。

⚠️

※ npm経由のインストールは非推奨。パッケージ名がリポジトリ名と異なる(oh-my-claude-sisyphus)ため、プラグインシステム経由が推奨されています。


📝 実践レポート:3ステージパイプラインで MVPを作ってみた

実際にoh-my-claudecodeの3ステージパイプライン(Deep Interview → Ralplan → Autopilot)を使って、MVP開発を試してみました。

🔧 実験条件

  • 入力: 1,200行・3万文字の業務要件定義書
  • 技術スタック: React 18 / TypeScript + Spring Boot 3.3 / Java 21 + MySQL 8.0
  • 目標: 要件書通りの動作するフルスタックMVPを自律的に完成させる

⚡ Phase 1: Deep Interview(約10〜30分)

6ラウンドのソクラテス式Q&Aで、要件の曖昧度を 100% → 14.5% まで低減しました。

ラウンド 曖昧度 確定した主要事項
1 100% → 70.5% フル機能MVP / React+Spring Boot+MySQL
2 70.5% → 60.0% 技術スタック確定
3 60.0% → 42.5% 成功基準の定義
4(Contrarian) 42.5% → 31.5% CloudAuth/マルチテナント除外 → 開発量30%削減
5 31.5% → 22.5% 外部連携はシードデータのみ
6(Simplifier) 22.5% → 14.5% ダッシュボード・非機能要件を除外

特にContrarian Modeの「CloudAuth/マルチテナントはMVPに本当に必要か?」という問いかけが開発量30%削減につながった点が印象的でした。

📋 Phase 2: Ralplan(約15〜20分)

Planner → Architect → Criticの3者コンセンサスで実装計画を確定。

Architectが指摘した3つの必須修正:

修正事項 根拠
Phase 2に垂直スライス煙テスト追加 過去の生成でフロントエンド未実装の教訓
複合キー → サロゲートキー + ユニーク制約 JPA運用コスト削減
検索API: POST → GETパラメータ MVPでの動的クエリセキュリティリスク排除

Architectが「過去の失敗の教訓」を引用してプロアクティブにリスク回避を要求した場面は、人間のアーキテクトレビューさながらの品質でした。

🚀 Phase 3: Autopilot(約40分〜3時間)

最大10並列エージェントが一斉にコード生成を実行。

Phase 1 (基盤): Agent A〜C → Spring Boot設定 + Flyway SQL + React骨格
Phase 2 (認証): Agent D → JWT Security + Auth/Consent API
Phase 3+4 (コア): Agent E〜G → ユーザ管理CRUD + 検索エンジン
Phase 5 (管理): Agent H〜J → マスタ管理 + ユーザー管理 + README

🔄 Phase 4: QA・修正ループ(約30〜40分)

並列エージェント間の整合性の問題が発生し、4〜10件のバグを修正:

  • JPAエンティティのテーブル名不一致(複数形 vs 単数形)
  • MySQLの予約語問題(year_month のバッククォート)
  • BCryptハッシュの不正値
  • JwtFilterのパススキップ設定ミス
  • APIパスの二重化

📊 結果サマリー

メトリクス
総開発時間 5時間
ソースファイル数 136ファイル
ソースコード行数 13,400行
設計書 8ドキュメント(約4,000行)
APIエンドポイント数 40
画面数 13
DBテーブル数 11
E2Eテスト 全画面・全ロール通過 ✅

従来開発なら3〜4名のチームで2〜3週間かかるであろう規模感のMVPが、半日以内で完成しました。


🏆 OMCの強みと課題

💪 強み

  • 要件から動作するプロダクトまでの一気通貫: 業務要件定義書 → 仕様 → 計画 → 実装 → 検証 → 文書化の全フェーズをカバー
  • Deep Interviewによる要件精緻化: 「何を作るか」自体をAIとの対話で明確化する革新的アプローチ。Contrarian/Simplifierモードが特に有効
  • コンセンサス型計画策定: Planner/Architect/Criticの3者レビューで、設計判断を事前に確定。手戻りを大幅に削減
  • 並列エージェント実装: 独立したタスクを同時実行し、開発速度を3〜5倍に向上
  • 自動学習: 苦労して得たデバッグパターンを蓄積し、将来のセッションで自動適用

⚠️ 課題

  • エージェント間の整合性: 並列エージェントが生成するコードの命名規則・パス規約等の一貫性が保証されない。QAフェーズでの修正が必須
  • QAの手動性: ビルドエラーの原因調査と修正は試行錯誤的になりがち
  • コンテキスト制限: 大規模プロジェクトではコンテキストウィンドウの制約により、全体像の把握が困難になる可能性

🎬 まとめ

oh-my-claudecodeは、素のClaude Codeを「マルチエージェント開発チーム」に変貌させるプラグインです。

✅ Deep Interviewで要件の曖昧さを数値化&精緻化
✅ Ralplanで3者コンセンサスの設計レビュー
✅ Autopilotで最大10並列エージェントが自律実装
✅ 32の専門エージェント+スマートモデルルーティング
✅ 使うほど賢くなる自動学習エンジン
✅ インストールはコマンド2行だけ

実際にMVP開発で使ってみた結果、1,200行の業務要件定義書から約半日で13画面・40API・11テーブルの動作するフルスタックアプリケーションが完成しました。

「要件が曖昧なまま実装が始まって手戻りが多い」「もっと効率的にAI開発したい」と感じている方は、ぜひ試してみてください。特にDeep Interviewの「本当にそれ要る?」という問いかけは、開発の質そのものを変えてくれます。


🔗 参考リンク

10
7
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
10
7

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?