mcpField
S
socratic-brainstorm

socratic-brainstorm

github.com/thebeardedbearsas開発107198 回インストール今日更新
リポジトリ

socratic-brainstorm について

socratic-brainstormは、コーディング前の要件明確化を支援する、開発者やプロダクトオーナー向けのスキルです。問題、制約、代替案、仮説、影響について質問し、1ページの判断要約にまとめます。単純な修正では省略できます。

主な機能

  1. 015つの観点から明確化の質問
  2. 02実装案と代替案の比較
  3. 03検証すべき主要な仮説の記録
  4. 04リスクと対策の整理
  5. 055 Whysによる根本原因分析
  6. 06単純な修正ではブレインストーミングを省略

活用シーン

  1. 01コーディング前に要件と成功指標を明確化
  2. 02レガシーコードに関わる機能案を評価
  3. 03実装の仮説と外部依存を確認
  4. 04不具合の根本原因を特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/thebeardedbearsas/claude-craft --skill socratic-brainstorm

インストール後、Claude Code で/socratic-brainstormを入力して読み込まれたか確認します。

詳細

ソクラテス式ブレインストーミング — コーディング前に明確化する

obra/superpowers に着想を得たスキルです。目的： 実装に入る前に的を絞った質問を行う段階を設け、誤ったものをすばやくコーディングしてしまうのを防ぎます。

黄金律： 質問には30秒かかりますが、誤った開発には3日かかります。

ソクラテス式の手法：5種類の質問

コードに触る前に質問します。毎回すべてを尋ねる必要はありません。状況に応じて最も適切な質問を選びます。

1. 問題に関する質問
  • 解決すべき本当の問題は何ですか？（想定されている解決策ではなく）
  • 誰のためですか？ユーザーペルソナ／役割は何ですか？
  • 何もしない場合のコストはどれくらいですか？
  • 成功をどう測定しますか？（KPI、指標）
  • ニーズの80％を満たす、より簡単な解決策はありますか？
2. 制約に関する質問
  • ビジネス上の制約：法的ルール、コンプライアンス、SLAはありますか？
  • 技術的な制約：指定された技術スタック、依存関係、レガシーシステムはありますか？
  • 時間的な制約：期限、外部依存関係はありますか？
  • リソース上の制約：インフラ予算、人員、長期的なメンテナンスはどうですか？
  • 絶対に壊してはいけないものは何ですか？
3. 代替案に関する質問
  • どのようなアプローチが考えられますか？（最低3つ）
  • なぜ他の案ではなく、この案なのですか？
  • すでに試したことや検討したことはありますか？
  • 既製の解決策（ライブラリ、SaaS）はありますか？
  • コーディングせずに済ませられますか？（設定、手作業、プロセス）
4. 前提に関する質問
  • 検証せずに想定していることは何ですか？
  • 想定されるボリューム／トラフィックはどれくらいですか？
  • 実際の利用パターンはどうですか？（95％のケース／5％のエッジケース）
  • 関係する外部の関係者はいますか？（サードパーティのAPI、チーム、ユーザー）
  • この前提が間違っていた場合、何が起こりますか？
5. 影響に関する質問
  • エンドユーザーにどのような変化がありますか？
  • 他の機能／モジュールへの影響はありますか？
  • 運用コスト（インフラ、モニタリング、サポート）はどれくらいですか？
  • 問題が起きた場合、どうロールバックしますか？
  • この解決策は1年後、3年後にどう変化しますか？

期待される成果物

ブレインストーミングの後、最大1ページで以下を作成します。

  1. 問題の言い換え：1〜2文
  2. 主な制約（最大5項目）
  3. 採用する案と、理由を添えた却下する代替案2つ
  4. 実装開始時に検証すべき主要な前提
  5. 特定したリスクとその軽減策

黄金律

次の場合は、この段階を省略しないでください。
  • 最初の依頼に「たぶん」「おそらく」「思う」という言葉が含まれている
  • 依頼者がエンドユーザーではない
  • 一見して複数の解決策がありそうに見える
  • 機能がレガシーコードや複雑な領域に関わる
次の場合は、この段階を省略してください。
  • 修正方法が1つしかない明白なバグ
  • 誤字／書式／ドキュメント
  • 範囲が単純で10分未満のタスク

アンチパターン

アンチパターン解決策
決定を下さずにブレインストーミングを延々と続ける最大30分のタイムボックスを設定する
修辞的な質問（答えが明白な質問）オープンで有益な質問をする
尋ねずに自分で答える依頼者に実際に質問する
「緊急だから」とブレインストーミングを省略する省略したブレインストーミングの10倍、緊急対応にコストがかかる
回答を頭の中だけに記録する書き出せば、可視化でき、見直せて、バージョン管理できます

Claude Craft との連携

  • /workflow:analyze — BMAD の分析段階はこのスキルから始まります
  • /workflow:plan — PRD で5種類の質問すべてに答える必要があります
  • エージェント @product-owner — 依頼者とのブレインストーミングを進行できます
  • スキル atomic-tasks — ブレインストーミングの成果をアトミックなタスクに分割します
  • スキル architect — アーキテクチャに関わる機能では、ブレインストーミングの後に使用します

クイック版：「5 Whys」

バグや根本原因の分析には、トヨタの5 Whysを使います。

Bug: "Le paiement échoue"
Why 1: Pourquoi ? → L'API retourne 500
Why 2: Pourquoi ? → Timeout DB
Why 3: Pourquoi ? → Requête sans index
Why 4: Pourquoi ? → Colonne ajoutée sans migration d'index
Why 5: Pourquoi ? → Pas de checklist PR pour les migrations

根本原因： 500エラーではなく、チェックリストがなかったことです。

Ressources

Date de dernière mise à jour : 2026-04-15 Version : 1.0.0

コメント

Markdown 対応