# wellulu-insight

ドノウエケンさんが Claude と話すだけで、後で振り返る価値のある気づき・学び・商談の知見を自動で GitHub に貯めていく仕組みです。専用の保存ボタンを押す必要はありません。Claude が会話の中から「これは残す価値がある」と判断したインサイトを、自動でこのリポジトリの Issue として記録します。

## これで解決すること
商談や打ち合わせで得た知見、ふとした気づき、失敗からの学びは、その場では覚えていても数日で忘れてしまいます。メモを取るのも続きません。このリポジトリは「Claude に話す → 勝手に整理されて溜まる」を実現し、あとから一覧・検索できる状態を作ります。

## できること
- Claude との会話から、インサイトを自動で Issue 化（手動操作なし）
- カテゴリ（気づき / 学び / 顧客・商談 / 意見 / アイデア）で分類
- あとから一覧表示・キーワード検索
- 別のPC・別の人の Claude Desktop でも同じ仕組みを再現

## できないこと（スコープ外）
- X やブログへの自動投稿（ここはあくまで「インサイトを溜める箱」です）
- 機密情報・個人情報の保存（Claude 側で保存対象から除外します）
- Claude 以外（ChatGPT 等）からの利用（GPT 用ではなく Claude 用 MCP です）

## 使い方の流れ
1. 別PCの Claude Desktop に、このリポジトリの MCP サーバーを1度だけ設定する（下記セットアップ）
2. あとは Claude と普通に会話するだけ
3. 残す価値がある話が出ると、Claude が `create_insight` で自動保存し「（保存しておきました）」と一言添える
4. 「インサイト一覧見せて」「〇〇について調べて」と言えば、過去の蓄積を呼び出せる

## ステータス
運用可能。MCP サーバー・Issue テンプレート・ラベルは整備済み。

## 想定ユーザー
ドノウエケンさん本人。エンジニアでなくても、下記セットアップを1度行えば使えます。

---

## 技術詳細

X 投稿ネタを Issue 管理する [x-post-ideas](https://github.com/Vortex-9191/x-post-ideas) の Claude + MCP 版。ChatGPT の GPT Actions（OpenAPI スキーマ）を MCP サーバーに置き換えたもの。提供形態は2つ。

| 形態 | 用途 | 場所 |
|------|------|------|
| クラウド（推奨） | URL をコネクタ登録するだけ。別PC・別の人がインストール不要で使える | `cloudflare/`（Cloudflare Workers・合言葉認証） |
| ローカル | 自分のPCで完結させたい場合。クローン＋Node が必要 | `mcp/`（stdio） |

別の人の Claude Desktop で再現したい場合はクラウド版を使う。手順は [cloudflare/README.md](cloudflare/README.md)。以下はローカル（stdio）版の説明。

### 構成
```
mcp/index.mjs                      MCP サーバー本体（stdio・ビルド不要）
package.json                       依存は @modelcontextprotocol/sdk のみ
prompts/claude-project-instructions.md  Claude に貼る自動保存の指示
.github/ISSUE_TEMPLATE/insight.yml 手動登録用 Issue テンプレ
```

### MCP ツール
| ツール | 用途 |
|--------|------|
| `create_insight` | インサイトを Issue として保存（title / insight / category / takeaways / url / memo） |
| `list_insights` | 保存済み一覧（category / state で絞り込み） |
| `search_insights` | キーワード全文検索 |

### 別PC（Claude Desktop）でのセットアップ

前提: その PC に Node.js 18+ が入っていること。

1. このリポジトリへの読み書きができる GitHub トークンを用意する
   - GitHub → Settings → Developer settings → Fine-grained tokens
   - Repository access: このリポジトリのみ / Permissions: Issues = Read and write
   - 生成したトークン（`github_pat_...`）を控える（リポジトリやチャットに貼らないこと）

2. リポジトリを1度クローンして依存を入れる
   ```
   git clone https://github.com/Vortex-9191/wellulu-insight.git
   cd wellulu-insight
   npm install
   ```

3. Claude Desktop の設定ファイルにサーバーを登録する
   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
   - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
   ```json
   {
     "mcpServers": {
       "wellulu-insight": {
         "command": "node",
         "args": ["/クローンした絶対パス/wellulu-insight/mcp/index.mjs"],
         "env": {
           "GITHUB_TOKEN": "github_pat_ここにトークン",
           "INSIGHT_REPO": "Vortex-9191/wellulu-insight"
         }
       }
     }
   }
   ```

4. Claude Desktop を再起動する。ツール（🔌）に `wellulu-insight` が出れば成功。

5. `prompts/claude-project-instructions.md` の中身を Claude の Project 指示（またはカスタム指示）に貼ると、頼まなくても自動保存が始まる。

### ラベル
カテゴリ: `discovery` 気づき・発見 / `learning` 学び・教訓 / `customer` 顧客・商談 / `opinion` 意見・考察 / `idea` アイデア・施策
ステータス: `status: new` 新規 / `status: reviewing` 確認中 / `status: actioned` 着手済み / `status: archived` 保管