ark-research

Ark Research

実装前に技術的な解決策を調査し、根拠を集めます。

調査プロセス

1. まずウェブ検索

次の情報を見つけるため、必ず最初にウェブ検索を行います。

• 公式ドキュメント
• GitHub リポジトリ
• ブログ記事やチュートリアル
• プロトコル仕様（PDF、RFC）

2. GitHub リポジトリを調べる

GitHub の raw コンテンツはブロックされることがよくあります。リポジトリをクローンして調べてください。

cd /tmp
git clone https://github.com/owner/repo.git
cat /tmp/repo/README.md

次の内容を確認します。

• README のドキュメント
• コード例
• アーキテクチャのパターン
• 依存関係と要件

3. ブロックされたコンテンツへの対応

ウェブサイトを読み込めない場合は、次のようにします。

• 関連するコンテンツを貼り付けるようユーザーに依頼する
• PDF または仕様書の提供を依頼する
• 視覚的なコンテンツが必要な場合は、スクリーンショットを依頼する

プロンプトの例：

「[URL] に関連するリソースを見つけましたが、アクセスできません。重要な内容を貼り付けるか、PDF を提供していただけますか？」

4. ローカル調査用ワークスペース

調査結果を確認用に ./scratch/research/ に保存します。

mkdir -p ./scratch/research

次の内容を保存します。

• クローンしたリポジトリの概要
• コードスニペット
• アーキテクチャ図
• 比較メモ

5. 根拠に関する要件

解決策を推奨する前に、最低 2～3 件のデータポイントが必要です。

• 活発にメンテナンスされている GitHub リポジトリ
• ドキュメントまたは仕様
• 実際の使用例
• コミュニティからのフィードバック（issue、ディスカッション）

根拠が不十分な場合は、ガイダンスを求めてください。

「この方法に関する参照先は 1 件しか見つかりませんでした。追加のリソースをご案内いただくか、要件を詳しく教えていただけますか？」

出力形式

調査結果は必ず出典で裏付けてください。

## Research: [Topic]

### Option 1: [Solution Name]
- **Source**: [URL or repo link]
- **Pros**: ...
- **Cons**: ...
- **Evidence**: [What confirms this works]

### Option 2: [Solution Name]
...

### Recommendation
Based on [N] sources, I recommend [Option] because...

### Sources
- [Title](URL)
- [Repo](GitHub URL) - cloned and examined
- [Spec](URL) - user provided

使用例

ユーザー：「MCP サーバーでのターミナル録画の選択肢を調査してください」

1. ウェブ検索：「terminal recording library node typescript」
2. GitHub リポジトリを見つけて、/tmp にクローンし、調べる
3. asciinema、VHS、xterm.js を見つける
4. 選択肢を ./scratch/research/terminal-recording.md で比較する
5. それぞれ 2～3 件の出典とともに選択肢を提示する