mcpField
D
discover

discover

github.com/lvlup-sw生産性22101 回インストール1 日前に更新
リポジトリ

discover について

discover は、コードではなく調査・分析文書を作成するワークフロースキルです。情報源の収集と文書化を案内し、明示的に確認した調査を起点の ideation 仕様に関連付けることもできます。

主な機能

  1. 01調査ソースの収集と記録
  2. 02収集資料に基づく文書作成
  3. 03ワークフロー状態へのレポートパス記録
  4. 04発展調査と ideation 仕様の関連付け

活用シーン

  1. 01競合・市場調査
  2. 02アーキテクチャ比較と ADR の準備
  3. 03文献レビューとベンダー評価

インストール

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

$npx skills add https://github.com/lvlup-sw/exarchos --skill discover

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

詳細

ディスカバリーワークフロースキル

成果物がコードではなくドキュメントであるタスク向けのワークフロー種別です。検証ゲートはありません（テストするものがないため）。そのため、検証ラダーは適用されません。

使用する場合

  • 競合分析や市場調査
  • アーキテクチャの比較や ADR の下書き
  • 文献レビューやベンダー評価
  • 実装計画に反映しないデザインリサーチ

使用しない場合

  • 成果物にコード変更が含まれる場合 → /exarchos:oneshot または /exarchos:ideate を使用します
  • TDD の適用が必要な場合 → ほかのワークフロー種別を使用します
  • 調査結果を実装に直接反映する場合 → /exarchos:ideate を使用します（統合された docs/specs/ 成果物の「デザインと根拠」セクションを作成します）

Discover ブリッジ（深い段階へのエスカレーション）

計画の deep 段階では、/exarchos:ideate からこのワークフローへエスカレーションし、手動で「新しいワークフローを開始する」引き継ぎを行う代わりに、イベントにリンクされた第一級の調査前処理として利用できます。このブリッジはオプトイン（作成者が確認し、自動実行はされません）です。利用可能なアクションは next_actions に表示されます。また、discover_bridge オーケストレーションアクションを confirm: true で呼び出すと、決定論的な correlationId によってこのディスカバリー実行と元の仕様が結び付けられます（機能ストリーム上で state.patched リンクイベントとして記録されます）。この方法でエスカレーションされたディスカバリーを実行した場合は、仕様の ## Design & Rationale → 探索セクションでレポートのパスを引用し、両方のドキュメントにわたって来歴を保つために、ブリッジの correlationId を指定してこのワークフローを init します。

フェーズ

フェーズ 1：情報収集（初期）

成果物に必要な情報源、参考資料、一次資料を収集します。

  1. 調査の問い、または成果物の範囲を定義します
  2. 情報源（URL、ドキュメント、コード参照）を特定して収集します
  3. 情報源をワークフローの状態に記録します：
exarchos:exarchos_workflow({
  action: "update", featureId: "<id>",
  updates: { "artifacts.sources": ["<source1>", "<source2>", "..."] }
})
  1. 成果物のアウトラインを作成します

遷移： artifacts.sources が空でない配列になったら → synthesizing

フェーズ 2：統合

収集した情報源を基に、成果物となるドキュメントを作成します。

  1. 収集した情報源とアウトラインに基づいてドキュメントを作成します
  2. ドキュメントをリポジトリにコミットします（通常は docs/research/ または docs/designs/ 配下）
  3. レポートのパスを記録します：
exarchos:exarchos_workflow({
  action: "update", featureId: "<id>",
  updates: { "artifacts.report": "<path-to-document>" }
})

遷移： artifacts.report が設定されたら → completed

オプション：実装へのエスカレーション

ディスカバリーで実装の必要性が明らかになった場合：

  1. レポートに調査結果を記載します
  2. ディスカバリーワークフローの完了後、新しいワークフローを開始します： 
    ideate <implementation-topic>
    デザイン入力としてディスカバリーレポートを参照します。

コメント

Markdown 対応