Communitygithub.com

rrrrrredy/industry-research-framework

業界リサーチフレームワーク:エージェント非依存の、ソースに基づいた業界調査とパブリッシュ可能な記事作成のためのフレームワーク

industry-research-framework とは?

このスキルは、長編の業界調査とパブリッシュ可能な記事作成のためのエージェント非依存型フレームワークです。データソースや固定のレポートテンプレートは付属せず、エージェントが状態を永続化し、エビデンスと散文を分離し、トピックのドリフトを回避し、レビューをスケジュールし、大規模なリサーチバックエンドをクリーンな読者向け記事に変換するための規約を定義します。このフレームワークは、Claude Code、Cursor、Codex、GitHub Copilot、Aider、OpenAI Codex CLI などの主要なAIエージェント上で動作し、エビデンスベースの調査、主張の分類、深さ予算管理、段階的実行といった原則を提供します。主な特徴として、タスク状態ファイルによるコンテキスト復旧、ソース/主張/不確実性のレジストリによる監査証跡、リサーチブリーフゲートによるスコープ定義、セクションレベルの進捗管理、そしてサブエージェントレビューループによる品質保証が含まれます。このフレームワークは、トピックの過適合、プロセス漏洩、エビデンスのドリフト、不完全な完了、深さの崩壊といった一般的なリサーチエージェントの5つの障害を解決するように設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add rrrrrredy/industry-research-framework

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

業界リサーチフレームワーク

このスキルは、長編の業界調査とパブリッシュ可能な記事作成のためのフレームワークです。スクレイパー、データソース、固定のレポートテンプレートは付属しません。その代わりに、AIエージェントが状態を永続化し、エビデンスと散文を分離し、トピックのドリフトを回避し、レビューをスケジュールし、大規模なリサーチバックエンドをクリーンな読者向けの記事やレポートに変換するための規約を定義します。

1. 動機

長編リサーチエージェントは、以下の5つの繰り返し発生する方法で失敗する傾向があります。

  1. トピックの過適合: あるプロジェクトから抽出された手法が、誤って普遍的なフレームワークとして扱われる。
  2. プロセス漏洩: 最終記事が作業ログのようになり、「ユーザーが提供した」や「資料が示している」といったフレーズが含まれる。
  3. エビデンスのドリフト: ソース、主張、不確実性、著者の判断が、1つの区別されない議論に崩壊する。
  4. 誤った完了: カバレッジ、レビュー、読者品質のリビジョンが完了する前に、部分的なマイルストーンが最終完了として報告される。
  5. 深さの崩壊: レポートがソース数やカバレッジチェックリストを満たしているが、ユーザーの期待する調査深度に対して短すぎ、圧縮されすぎ、または薄すぎる。

このフレームワークのすべてのメカニズムは、これらの失敗のいずれかを対象としています。

2. スコープ契約

このスキルは、 substantial なリサーチ成果物を生成するための実行フレームワークです。理論体系、製品アーキテクチャ、または汎用モデリング言語ではありません。

このスキルに含めるもの:

  1. プロセス: リサーチスコープの調整、段階的実行、ソース処理、ドラフト作成、レビュー、リビジョン、最終クリーンアップ。
  2. 状態: タスク状態、進捗、発見、前提、決定、方向性の追跡。
  3. 監査: ソース、主張、不確実性、カバレッジ、深さ、読者品質のチェック。

ユーザーが別途システム設計プロジェクトを明示的に要求しない限り、このスキルの範囲外とするもの:

  1. ドメインオントロジー、普遍的な分類法、または汎用モデリング言語。
  2. 中間表現、スコアリングシステム、埋め込み、ナレッジグラフ、またはランキングエンジン。
  3. ダッシュボード、CLI、データベース、自動化パイプライン、または製品アーキテクチャ。
  4. 現在のリサーチ成果物を直接的に改善しない方法論のマニフェスト。

タスクが除外されたレイヤーにドリフトし始めた場合、現在の成果物のパスを維持し、アイデアを将来の拡張として記録し、ワークフローを拡大しないでください。

3. 行動制約

  1. 成果物ファースト: 要求された出力が記事またはレポートである場合、システム設計、プロンプト設計、またはワークフローの説明にドリフトしないでください。
  2. 収集前のリサーチブリーフゲート: 意思決定に重要な情報が欠けている場合、1つのコンパクトな質問バッチを依頼してください。
  3. スケール前の状態: 長時間のタスクの場合、ソース収集を拡張する前に、タスク状態をファイルに書き込んでください。
  4. エビデンスは散文ではない: レジストリ、ログ、監査ラベル、アクセス障害は、ユーザーが監査付録を要求しない限り、バックステージに留めてください。
  5. ドラフト前の深さ予算: 期待される深さ、おおよその長さの範囲、ユニットレベルの拡張計画、およびこのタスクで「短すぎる」とはどういう意味かを記録してください。
  6. 段階的実行: 計画、収集、分析、ドラフト、レビュー、リビジョン、状態更新を次のユニットに移る前に行ってください。
  7. セクションレベルの進捗: 複雑な作業は、セクション、企業、ケース、期間、または議論ごとに記述し、レポート全体を1回のパスで生成しないでください。
  8. オプションレンズのみ: フレーミング/カテゴリ分析、水平-垂直分析、資本分析、採用分析はツールであり、デフォルトの構造ではありません。
  9. レビューでループを閉じる: すべての監査所見は、リビジョンアクション、格下げされた主張、または明示的な制限事項にしなければなりません。
  10. 読者レビューは最後: 事実、カバレッジ、構造、深さのチェックが安定した後にのみ、読みやすさを改善してください。

4. アーキテクチャ

メインエージェント
テーゼ、構造、最終判断を所有

リサーチバックエンド   パブリッシングフロントエンド
状態ファイル          テーゼ / セクション
ソースレジストリ      メカニズム / 統合
主張レジストリ        反証
不確実性リスト        読者向け参考文献
レビューログ          最終散文クリーンアップ

サブエージェントはバックエンドの限定された部分を検査または挑戦できますが、メインエージェントが議論と最終散文を所有します。

5. 状態ファイル

substantial な作業の場合、以下を作成してください:

{task}/state/
  task_spec.md            # 目的、読者、出力、スコープ、深さ、エビデンス基準、前提
  progress.json           # ステージ、完了ユニット、未解決問題、stale_count
  findings.jsonl          # 追加専用の発見と判断
  directions_tried.json   # すでに試みた方向
  iteration_log.jsonl     # ステージサマリー

{task}/logs/
  work.jsonl              # 実行上の決定
  review.jsonl            # レビュー所見とルーティングされた修正

{task}/data/
  source_registry.csv
  claims_registry.csv
  uncertainty_registry.csv

状態ファイルを使用して、コンテキスト損失後に復旧してください。チャット履歴を唯一のメモリとして依存しないでください。

コンテキスト復旧プロトコル

コンテキスト損失、セッション再開、またはハンドオフ後に再開する場合:

  1. state/task_spec.md を読み、目的、スコープ、読者、出力、深さ、エビデンス基準、前提を確認します。
  2. state/progress.json を読み、現在のステージ、完了ユニット、未解決問題、stale_count、次のアクションを確認します。
  3. state/findings.jsonl と state/iteration_log.jsonl の最新エントリを読み、最近の方向性を復旧します。
  4. state/directions_tried.json を読み、失敗または枯渇したパスの繰り返しを回避します。
  5. オペレーティングループの該当するステップから再開します。

完了したステージを再実行しないでください。task_spec.md にすでに回答が記録されている場合、リサーチブリーフを再度尋ねないでください。

6. リサーチブリーフゲート

収集の前に、リクエストに意思決定に十分な情報が含まれているかどうかを判断します。含まれていない場合、開始する前に1つのコンパクトな質問バッチを依頼します。バッチには通常3〜7の質問が含まれ、期待される長さまたは深さが欠けている場合はそれをカバーする必要があります。

不足している重要な情報のみを尋ねてください:

  • リサーチ対象とスコープの境界
  • ターゲット読者と意思決定コンテキスト
  • 出力形式、言語、公開コンテキスト
  • 期待される深さ、おおよその長さの範囲、または深さレベル
  • 必ずカバーするユニット、除外事項、優先領域
  • 必要なソースまたは資料、ソースの除外、エビデンス基準
  • 期間、地域、期限、チャート/テーブルが期待されるかどうか

ユーザーがすでに十分なコンテキストを提供している場合、儀式的な質問はしないでください。先に進み、task_spec.md に前提を記録し、未解決の重要でない詳細を前提または不確実性としてマークしてください。

1回の明確化バッチの後も重要な詳細が未回答のままの場合、保守的な前提を立て、それを記録し、停止する代わりに境界のあるステージ1から開始してください。

7. オペレーティングループ

各ステージについて:

  1. リサーチブリーフゲートを実行し、スコープ、入力、出力、完了基準を計画します。
  2. そのステージに必要なソースのみを収集または処理します。
  3. ソースを主張、不確実性、分析ノートに変換します。
  4. 境界のあるセクションまたはユニットをドラフトします。
  5. エビデンス、カバレッジ、構造、懐疑、散文についてセクションをレビューします。
  6. セクションとレジストリをリビジョンします。
  7. 進捗を更新し、次のステージを定義します。

1サイクルで新しいエビデンス、ケース、反例、フレームワーク、または判断が追加されない場合、stale_count をインクリメントします。stale_count >= 2 の場合、単によりハードに検索するのではなく、構造的な角度をピボットしてください。

長編の成果物の場合、ソース数、主張数、リンク数、ファイルサイズを完了の代替として使用しないでください。これらはバックエンドの健全性シグナルであり、完成したレポートが十分な深さを持っていることの証明ではありません。最終アセンブリの前に、ドラフトを深さ予算と比較し、読者レビューの前に薄いユニットを拡張してください。

8. ソースと主張の規律

ソースを、それらが証明できるものによって分類してください:

  • 公式資料: 表明された立場、意図、製品表面、または正式なポリシーを示す
  • 一次データ: 定義と収集方法が明確な場合、測定可能な主張をサポートする
  • 専門家資料: 推論、コンテキスト、解釈を説明する
  • メディア資料: 公的なフレーミングを示すが、確かな事実には裏付けが必要
  • ユーザー/コミュニティ証拠: 受け入れられ方を示すが、自動的に代表性があるわけではない
  • 反証: 主たる主張を制限、弱体化、または反証する

主張を別々に分類してください:

  • 検証済みの事実
  • ソースの主張
  • 解釈
  • 著者の判断
  • 推測

すべての重要なハードな主張には、信頼性の境界が必要です。企業のPR、投資家の希望、メディアの増幅を事実に変えないでください。

9. 分析レンズのスケジューリング

リサーチクエスチョンに合ったレンズを選択してください:

  • フレーミング/カテゴリ分析: ポジショニング、正当性、カテゴリ創造、公的な意味、メディア変換
  • 水平-垂直分析: タイムラインの深さと、現在の競合他社/代替品の比較
  • 採用分析: ユーザー行動、ワークフロー変更、置き換え、摩擦
  • 資本分析: 価格設定、収益、評価、資金調達、コスト構造、マージン
  • 組織/人材分析: 運営モデル、採用、リーダーシップ、人材フロー
  • ポリシー/正当性分析: 規制、コンプライアンス、信頼、地政学的または制度的圧力
  • 反証ケース分析: 最も強力な代替説明と障害モード

ユーザーが明示的にマルチメソッドレポートを要求しない限り、1つのプライマリレンズと最大2つのセカンダリレンズを選択してください。

レンズを選択する際は references/optional-analysis-lenses.md を読んでください。そのレンズが選択された後にのみ references/horizontal-vertical-analysis.md を読んでください。

10. サブエージェントのスケジューリング

境界のある作業にのみサブエージェントを使用してください:

  • 要件マッピング
  • 別々の地域、アクター、またはソースクラスのためのソース発見
  • エビデンスチェーン検証
  • カバレッジ監査
  • 懐疑的レビュー
  • 構造レビュー
  • ドラフトが安定した後の読者品質レビュー

サブエージェントのプロンプトには、目的、検査するファイルまたはセクション、出力形式、PASS/FAIL基準、境界を含める必要があります。サブエージェントはレポート全体を書き換えたり、テーゼを所有したりしないでください。

委任の前に references/subagents-and-review-loop.md を読んでください。

11. 最終化

最終的な記事またはレポートには、読者向けの素材のみを含めてください:

  • 有用な場合の結論ファーストの洞察
  • スコープノート
  • 議論、ケース、期間、またはメカニズムごとに整理された分析セクション
  • ユニット間の統合
  • 明確に表現された反証と不確実性
  • インプリケーション
  • 読者向けの参考文献付録

以下を削除してください:

  • 可視のソースID
  • 監査ラベル
  • ファイルパス
  • 「ユーザーが提供した」
  • 「資料が示している」
  • 「このソースは補足する」
  • 「このセクションは監査に合格しました」
  • 判断を弱めるのではなく不明瞭にする過度の注意書き

12. 検証と限界

完了を宣言する前に:

  1. リサーチブリーフゲートが完了したか、前提が記録されている。
  2. 必要なカバレッジが完了しているか、限界が明示されている。
  3. 主要な主張がソースまたは不確実性の記録に遡ることができる。
  4. 事実、ソースの主張、解釈、著者の判断が区別されたままである。
  5. 反証が対処されている。
  6. ドラフトが深さ予算を満たしているか、元の期待された深さがもはや適切でない理由を明示的に説明している。
  7. 事実、カバレッジ、構造、深さのレビュー後に、読者レビューが実行されている。
  8. 最終的な散文が、エージェントのプロセスレポートではなく、著者のレポートのように読める。

限界:

  1. このフレームワークは引用とエビデンスのエラーを削減しますが、排除するわけではありません。
  2. サブエージェントのレビューはチェックであり、外部の真実ではありません。
  3. オプションレンズは、機械的に使用するとレポートに過適合する可能性があります。
  4. 状態ファイルは復旧に役立ちますが、タスク中に更新された場合にのみ機能し、事後に再構築されたものでは機能しません。

13. 実行ガードレール

これらのガードレールを使用して、ループ、過剰収集、スコープドリフトを防止します:

  1. ソース収集: 3回連続の検索またはソースパスで関連するエビデンスが追加されない場合、その方向での収集を停止し、directions_tried.json を更新し、ドラフトまたはピボットします。
  2. 主張抽出: source_registry.csv が増加する一方で claims_registry.csv が薄いままの場合、収集を一時停止し、より多くのソースを収集する前に主張を抽出します。
  3. レビューループ: ユーザーがより多くを要求しない限り、完全なレビュー-リビジョンサイクルをセクションあたり最大2回に制限し、未解決の問題を制限事項またはフォローアップタスクとして記録します。
  4. 深さチェック: 読者レビューの前に、ドラフトを深さ予算と比較し、散文を最適化する前に薄いユニットを拡張します。
  5. スコープ拡張: 新しい作業が task_spec.md の範囲外にある場合、提案された拡張として記録し、プロジェクトを拡張する前に尋ねます。
  6. サブエージェントレビュー: プロンプトは、レビュー担当者に積極的に問題を探すように依頼する必要があります。問題が見つからない場合、レビュー担当者はPASSをサポートする証拠を述べなければなりません。

14. ハマりどころ

これらの繰り返し発生する失敗パターンに注意してください:

  1. レジストリ劇場: ソースと主張のレジストリは完全に見えるが、最終的な散文がメカニズムやトレードオフを統合していない。
  2. ソース列挙散文: 段落がエビデンスを読者向けの判断に変える代わりに、「ソースXはYと言っている」を繰り返す。
  3. 時期尚早な読者向け磨き: カバレッジ、エビデンス、構造、深さのチェックが安定する前に散文クリーンアップが始まる。
  4. レンズの過剰到達: オプションのレンズがレポート全体になり、ユーザーの質問がより単純な構造を必要としている場合でもそうなる。
  5. サブエージェントの拡大: レビュー担当者や収集担当者がテーゼを所有し、レポート全体を書き換え、スコープを拡大するように依頼される。
  6. 深さの代替: リンク数、ファイルサイズ、またはチェックリストのカバレッジが、レポートが十分に深いことの証明として扱われる。

繰り返されるドリフトの診断、評価の改善、または新しいエージェントへのフレームワークの適応の際には references/gotchas.md を読んでください。

15. ハードストップ

以下のいずれかが発生した場合、現在のパスを停止し、続行する前に状態を修復してください:

  1. ブリーフストップ: 重要なリサーチタスクにおいて、明確化ゲートの後も読者、スコープ、出力形式、エビデンス基準、または深さ予算が欠けている。
  2. エビデンスストップ: 3回連続の検索またはソースパスで、新しい関連エビデンス、ケース、反例、または判断が追加されない。
  3. 主張ストップ: source_registry.csv が増加する一方で claims_registry.csv が空、ジェネリック、またはドラフトから切り離されたままである。
  4. ドラフトストップ: 最終散文に依然としてプロセス言語、内部ソースID、監査ラベル、ファイルパスが含まれている。
  5. 深さストップ: ドラフトが深さ予算に著しく不足しているが、ユニットの拡張や制限事項の記録なしに読者レビューに移行しようとしている。
  6. スコープストップ: 現在の作業が task_spec.md に記録されたスコープを超えているが、拡張についてユーザーに尋ねていない。

関連スキル