Auto_research

リサーチしたいトピックをメモしておくと、Claude Code がサブエージェントを使って リサーチ結果（わかりやすい文章でまとめたもの）を自動生成してくれる仕組みです。 そこから任意でNote記事の下書き・ショート動画の構成案も作れます。

詳しい構成は CLAUDE.md、デプロイ情報は docs/deployment.md を参照してください。

クイックスタート

1. デプロイ済みのメモアプリを開く

docs/deployment.md に記載の本番URLを開き、メールアドレス・パスワードでログインして、 リサーチしてほしいトピックをメモとして追加します（memo-app/ はVercelにデプロイして使う前提のアプリです）。

メモは「単発」（1回だけリサーチ）か「定期的」（毎日/毎週/毎月/カスタム、繰り返しリサーチ）を選べます。 定期メモは処理後もアーカイブされず、メモ一覧に残り続けて次回の頻度が来るたびに再処理されます。 毎週なら曜日、毎月なら日にち、さらに希望の時刻も任意で指定できます（厳密なcronではなく、 1日3回（JST 9:33/15:33/21:33、深夜〜早朝は除く）動くRoutineがその条件を満たした最初のタイミングで処理する、という精度です）。 「カスタム」はカレンダーで複数の日付を選んで指定でき、選んだ日付が来るたびに処理されます （他の頻度と同じくアーカイブされず残り続け、後から日付を追加すればさらに処理されます）。

テキストで書く代わりに、スクリーンショット画像を添付したり、Instagram/X/YouTubeなどの 投稿URLを貼り付けたりもできます。パイプラインはまずその画像/URLの内容を把握し、そこを 起点に周辺情報まで広く深くリサーチします（テキストのbriefと併用も可）。貼ったURLが YouTube/TikTok/Instagram Reelなどの動画の場合は、通常のまとめ方の代わりに、動画内容の 詳細な文字起こし再構成→かんたんな要約→詳細な要約という専用フォーマットでリサーチ結果が 作られます（完全な文字起こしが取れない場合はその旨を明記し、根拠のない引用・数値は作りません）。

2. パイプラインを実行

Claude Code で /research-pipeline を実行すると、メモアプリのAPIから pending 状態のメモと、 期限が来た定期メモ（最大3件）を取得し、リサーチ結果をまとめた上で、必要に応じて記事下書き・ ショート動画構成も生成し、output/<slug>/（定期メモは output/<slug>/<date>/）に保存し、 メモのステータス・履歴を更新します。 1日3回（JST 9:33/15:33/21:33、深夜〜早朝は除く）動くRoutineが自動実行する設定になっています。メモアプリ側から即座に起動するボタンは技術的な制約で用意できません。

3. 成果物を確認

• output/<slug>/research.md — わかりやすくまとめたリサーチ結果（出典付き）
• output/<slug>/article.md — Note記事の下書き
• output/<slug>/video-structure.md — ショート動画の構成・台本

いずれも 下書き です。公開前に必ず内容を確認してください。生成後はこのリポジトリにコミットされます。 定期メモの場合、Web UIのリサーチページで過去の実行を日付ごとに切り替えて見られます。

4. リサーチ結果がいまいちなら「修正をリクエスト」

生成物ページに「修正をリクエスト」ボタンがあります（記事下書き/動画構成タブを開いていても 表示されます）。何を直してほしいか一言入力して送ると、次回のパイプライン実行でそこだけを 狙い撃ちで調べ直してくれます（同じ内容を全部調べ直すわけではなく、既存の内容はできるだけ 再利用します）。単発メモが完了済みでも、定期メモの通常スケジュールとは無関係に処理されます。

5. 良かった結果はObsidianに保存

生成物ページで「Obsidianに保存」ボタンを押すと、以後パイプラインを実行するたびにそのメモが obsidian/<slug>.mdとしてこのリポジトリに同期されます。自分のPCでこのリポジトリをclone/pullし、 Obsidianでこのリポジトリのフォルダ（またはobsidian/サブフォルダ）をVaultとして開けば、 git pullするだけで保存したメモがObsidian側にも反映されます。

6. 使える手順・ノウハウは「Skill化」

リサーチ結果が、今後のClaude Codeでの作業にも使えそうな実用的な手順・ノウハウだった場合 （たとえばYouTubeの解説動画から作ったものなど）、生成物ページで「Skill化をリクエスト」 ボタンを押すと、次回以降のパイプライン実行でリクエストした順に（最大3件/回）そのリサーチ結果が 再利用可能なClaude Code Skill（.claude/skills/<name>/SKILL.md）に変換され、他の生成物と 同じくこのリポジトリにコミットされます。以後、Claude Codeのセッションから/<skill名>または 文脈に応じて自動的に呼び出せます。これも下書き扱いなので、内容を確認してから使ってください。

メモアプリをローカルで動かす場合

cd memo-app
npm install
npx vercel link      # 初回のみ: このVercelプロジェクトと紐付け
npx vercel env pull  # 環境変数をローカルに取得
npx vercel dev