Dear User

Dear User

AI エージェントはあなたのために働きます。では、あなたたちはどれだけうまく協力できているでしょうか？

Dear User は、Claude Code のセットアップを監査し、修正すべき点を具体的に示すオープンソースのツールです。コラボレーションのスコアを算出し、漏えいしたシークレットや設定の競合を見つけ、システムの健全性を確認します。すべてローカルで処理され、Wrapped カードを明示的に共有しない限り、何もアップロードされません。

claude mcp add --scope user dearuser -- npx -y @poisedhq/dearuser-mcp@latest

次に、Claude にこう尋ねてください：「Claude とのコラボレーションを分析して」

ランディングページ： dearuser.ai · フィードバック： Claude の feedback ツールを使うか、イシューを作成してください

---

できること

Dear User はMCP サーバーです（Model Context Protocol。Claude Code と Claude Desktop が使用するプラグインシステムです）。インストールすると、エージェントが呼び出せるツールのセットとして表示されます。GUI も、サインアップも、クラウドアカウントも必要ありません。

ローカルレポートが 3 種類、共有可能な Wrapped カードが 1 種類、フィードバック用チャンネルが 1 つあります。

ツール	機能	プロンプトの例
collab	コラボレーション全体のレポート — ペルソナ、0～100 のスコア、摩擦のパターン、具体的な推奨事項	「私の Claude のセットアップはどれくらい良いですか？」
security	漏えいしたシークレット、プロンプトインジェクションの侵入口、エージェントの契約（CLAUDE.md または AGENTS.md）におけるルールの競合	「設定に漏えいした API キーがないか確認して」
health	構造的な整合性 — 実行されていない定期タスク、重複するスキル、機能していないフック	「セットアップに何か問題はありますか？」
wrapped	Spotify 風の共有可能な統計カード — スコア、件数、ペルソナ。share_report を使うと、オプトインで公開 URL を取得できます。	「Dear User Wrapped を作って」
feedback	Dear User の受信箱にメッセージを送信	「フィードバックを送信：ヘルスレポートをもっと短くできるとよいです」

補助ツール：onboard（7 ステップのガイド付きセットアップ）、history（再スキャンせずに傾向を確認）、help（メニュー）、implement_recommendation、dismiss_recommendation、share_report（Wrapped 専用のアップロード）。

リリースの主な特徴

• 共有可能な Wrapped — wrapped を実行してから share_report を実行すると、統計カードの dearuser.ai/r/<token> URL を取得できます。アップロード前に匿名化されます（パスはベース名に集約、メールアドレスは削除、シークレットはマスキング）。コラボレーション、セキュリティ、ヘルスのレポートはローカルに保持されます。検出結果には、ビジネス上の背景情報が含まれることがあり、自動共有には適さないためです。
• 12 カテゴリーのシークレットスキャナー — OpenAI、Anthropic、GitHub、AWS、Stripe、Slack、Google、Supabase、Vercel、秘密鍵、一般的な環境変数シークレット、ベアラートークンを検出します。CLAUDE.md／AGENTS.md、メモリファイル、スキル、フックをスキャンします。
• AGENTS.md のネイティブサポート — CLAUDE.md と並ぶ第一級の入力としてサポートします。Cursor、Codex、Aider、Cline、Zed、およびLinux Foundation のツール横断標準に準拠するすべての環境で、すぐに使えます。同じディレクトリに両方のファイルがある場合は、統合します。
• 意味に基づく競合検出（新機能） — キーワードが一致しなくても、互いに矛盾するルールを検出します。「頻繁にコミットする」と「コミット前に確認する」のようなルールの組み合わせにフラグを立てます。
• 実態に合わせて調整されたスコア — 2 つの調査を実施しました。基盤設定をコミット済みの公開 Claude Code セットアップ 988 件（中央値 32／100、最大 63）と、単独の CLAUDE.md ファイル 2,895 件（中央値 18、最大 60）です。ライブスコアとの同条件比較には、基盤設定のコーパスを使用します。両方の調査結果については、research/calibration/をご覧ください。

インストール

クライアントごとに、コマンド 1 つでインストールできます。詳しいガイド：docs/install.md。

Claude Code（CLI）

claude mcp add --scope user dearuser -- npx -y @poisedhq/dearuser-mcp@latest

ツールを表示するには、その後 Claude Code を再起動してください。

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加してください：

{
  "mcpServers": {
    "dearuser": {
      "command": "npx",
      "args": ["@poisedhq/dearuser-mcp"]
    }
  }
}

Cursor、Windsurf、Cline、Zed — docs/install.mdをご覧ください。

任意：スラッシュコマンドをインストールすると（一覧はコマンドを参照）、文章で尋ねる代わりに /dearuser-collab と入力できます。

npx -p @poisedhq/dearuser-mcp dearuser-install-skills

最初の5分

インストール後、クライアントを再起動し、次の操作を順に試してください。

1. ベースラインスキャン：

   Run Dear User collab on this project
   

   ペルソナ（Vibe Coder／Senior Developer／Indie Hacker／Venture Studio／Team Lead）、7つのカテゴリにわたる0〜100のスコア、3〜10件の具体的な推奨事項が表示されます。

2. セキュリティチェック：

   Run Dear User security
   

   エージェントの契約（CLAUDE.mdまたはAGENTS.md）、メモリ、スキル、フックを確認し、漏えいしたトークン、インジェクションの危険箇所、ルールの競合を検出します。

3. 結果を共有する（任意）：

   Share my collab report
   

   dearuser.ai/r/<token> のリンクが返されます。アップロード前に匿名化されます。リンクをどこかに貼り付けるかどうかはご自身で選べます。

collab の出力例：

Persona: Indie Hacker (87% confidence)
Score:   73 / 100

Top friction:
  • Quality Standards — no test-before-commit rule in CLAUDE.md
  • Memory Health    — 2 memory files haven't been touched in 90+ days
  • Communication    — no language preference stated (English vs Danish mixing)

Recommendations (3 shown, 5 total):
  1. Add a "Session start protocol" block to CLAUDE.md  (apply with: implement_recommendation)
  2. Rotate the OpenAI key leaked in ~/.claude/memory/api-notes.md
  3. Merge overlapping skills: deploy-check and ship-check share 80% of their rules

コマンド

Dear Userには8つのスラッシュコマンドが付属しています。エージェントに名前で依頼するか、dearuser-install-skills でインストールした場合はスラッシュコマンドを入力してください。

コマンド	機能
/dearuser-collab	コラボレーション分析 — ペルソナ、7つのカテゴリにわたる0〜100のスコア、優先順位付きの推奨事項。
/dearuser-health	システムの健全性 — 孤立したジョブ、重複、古いスケジュール、登録されていないMCP、調整の漏れ。
/dearuser-security	エージェントの契約に含まれるシークレット、プロンプトインジェクションの危険箇所、ルールの競合をスキャンします。
/dearuser-wrapped	Spotify Wrapped風のカードで共有できるコラボレーション統計。
/dearuser-onboard	初回ユーザー向けの、会話形式による7ステップのセットアップ。
/dearuser-history	過去のレポート、スコアの推移、または前回の実行からの変更点を表示します — 再スキャンは不要です。
/dearuser-feedback	Dear Userの開発者に短いメッセージ（バグ、要望、感想）を送信します。
/dearuser-help	Dear Userでできることを表示し、すべてのツールを一覧表示します。

エージェントが代わりに実行できる、チャット内アクションは3つあります：share_report（Wrappedカードをdearuser.ai/r/<token>にアップロード）、implement_recommendation（保留中の推奨事項を適用）、dismiss_recommendation（推奨事項を無関係としてマーク）。

プライバシー

Dear Userはローカル優先です。スキャン結果はお使いのマシン内に保存されます。

• エージェントの契約（CLAUDE.mdまたはAGENTS.md）、メモリ、スキル、フック、セッションのメタデータは読み取られますが、アップロードされることはありません
• 結果は~/.dearuser/dearuser.db（SQLite、WALモード）に保存されます
• オプションのローカルホストダッシュボードはこのDBを読み取るだけで、データは送信されません
• Dear Userが読み取るのはセッションのメタデータのみ（件数、長さ）です — 実際の会話内容は読み取りません
• APIキー不要、サインアップ不要、テレメトリーなし

例外は、ユーザーが明示的に実行した操作のみです。

• share_report（Wrappedのみ） — Wrappedカードは匿名化され（パスを簡略化し、メールアドレスを削除し、シークレットのパターンに一致するものをすべて編集）、URLを共有できるようdearuser.aiにアップロードされます。ローカルDBは変更されません。リンクを自動的に期限切れにするexpires_atを設定できます。コラボレーション／セキュリティ／健全性レポートは共有できません — 所見にプロジェクト名、クライアント名、アーキテクチャに関するメモなどの業務上の情報が含まれる可能性があり、公開URL上に置くべきではないと考えているためです。
• feedback — フィードバックツールを呼び出すと、メッセージがSupabaseの受信トレイに送信されます。それがこのツールの目的です。スキャン結果やファイルは添付されず、送信されるのはユーザーが入力したテキストのみです。

ほかのツールからデータが送信されることはありません。share_reportにDEARUSER_SUPABASE_URLとDEARUSER_SUPABASE_SERVICE_KEYが設定されていない場合は、エラーを適切に返し、Dear Userのほかの機能はそのまま動作します。

プライバシーの詳細：docs/privacy.md。

仕組み

Your files (CLAUDE.md or AGENTS.md, memory, hooks, skills, sessions)
        │
    Scanner ──► Parser ──► Engines (scoring, secrets, conflicts, health)
        │
 Persona detection → Scoring → Gap analysis → Recommendations
        │
    Feedback loop (tracks which recommendations you implemented)
        │
    ~/.dearuser/dearuser.db  ←  dashboard reads from here

• セットアップから5つのペルソナを判定 — それぞれに合わせた推奨事項を提示します
• 7つのスコアカテゴリ：役割の明確さ、コミュニケーション、自律性のバランス、品質基準、メモリの健全性、システムの成熟度、カバレッジ
• フィードバックループ：Dear Userは推奨した内容を記憶します。次回の実行時に、実施した推奨事項を確認し、スコアの変化を表示します。

対象ユーザー

• 「バイブコーダー」 — Claude にプロンプトを入力して製品をリリースしているものの、環境が本当に機能しているのか確信が持てない方。Dear User が教えてくれます。
• シニア開発者 — カスタムの lint パイプラインを組まずに、漏えいしたシークレット、設定のずれ、ルールの競合をすばやく監査したい方。
• 個人開発者／ソロ創業者 — プロジェクトをまたいでフック、スキル、メモリが蓄積している方。Dear User が、使われていないものや互いに矛盾しているものを見つけます。
• チームリーダー — チームで共有しているエージェント環境をローカルで監査したい方。コラボレーション、セキュリティ、健全性のレポートはお使いのマシンに保存され、公開共有できるのは個人用の Wrapped カードだけです。

リポジトリの構成

• mcp/ — @poisedhq/dearuser-mcp npm パッケージ（MCP サーバー）。開発に関する説明は mcp/README.md をご覧ください。
• web/ — dearuser.ai のランディングページとレポート共有ページ（Astro）。
• docs/ — インストールガイド、プライバシーに関する文書、プラットフォームごとの設定（オプションの security プラットフォームアドバイザー向けの Supabase/GitHub/Vercel）。
• research/ — 公開可能なキャリブレーションデータとアーキテクチャに関するメモ。

コントリビューション

CONTRIBUTING.md をご覧ください。バグ報告や小さな修正は、GitHub の issue や PR から歓迎します。

コミュニティとサポート

• GitHub Discussions — 質問、アイデア、「どうすれば…」、成果の共有
• GitHub Issues — 再現可能なバグや機能リクエスト
• フィードバック受信箱 — 非公開のメモ。あるいは Claude 内から feedback MCP ツールをお使いください

リンク

• dearuser.ai — ランディングページ
• インストールガイド · プライバシー · プラットフォームアドバイザーの設定

ライセンス

Dear User は MIT ライセンスです。詳細は LICENSE をご覧ください。

オープンコアへの取り組み： このリポジトリのすべての内容は MIT ライセンスであり、今後も MIT ライセンスのままです。チーム向け機能やホスト型機能（代理店向けダッシュボード、プロジェクト横断の傾向分析、業種別ベンチマークなど）を開発する場合は、独自のライセンスを適用した別のリポジトリで提供します。このリポジトリから一部を切り出して提供することはありません。