Retail Reason Intelligence

Retail Reason クライアントの配布

Retail Reason は、Walmart のサプライヤーおよびセラープラットフォームを利用する人々を対象とした、ホスト型の専門サービスです。対象には、Walmart のサプライヤー、Sam's Club のサプライヤー、Marketplace のセラー、およびそれらを支援するコンサルタントや代理店が含まれます。指標の定義、画面の操作手順、しきい値、異議申し立ての窓口に関する運用上の質問に回答します。作成中の成果物に潜む問題を確認し、各回答に as_of 検証日を付けて返します。 日付付きの回答は、すべての変更が即座に検出されることを保証するものではありません。

このリポジトリに含まれるのは 薄いクライアント だけです。Claude Code と Cowork 用のプラグイン、Codex CLI の設定、および公開機能マップです。専門知識はすべて、認証済みの MCP 接続を介してホスト型サービスから提供されます。Claude Code と Codex を利用するには、ユーザーに紐づいたアクセスキー（wadv_live_...）が必要です。サポート対象の各クライアントについて、最新の保守されたセットアップ手順は https://retailreason.com/docs/connect/ に掲載されています。この README はその内容を反映しています。キーは特定のユーザー名と Retail Reason アカウントに紐づいています。共有しないでください。ローテーションの際に有効期間を重ねられるよう、ユーザーごとに有効なキーは最大 2 個まで保持できます。各キーの有効期限は 180 日以内で、ユーザーまたはアカウントのオーナー／管理者がそれより前に失効させることもできます。

Retail Reason は独立した製品です。Walmart Inc. と提携、推奨されているものではなく、同社の製品でもありません。「Walmart」および以下のプラットフォーム名は、サービスの対象と対応範囲を説明する目的でのみ使用しています。

インストール：Claude Code

1. マーケットプレイスを追加します。

   /plugin marketplace add https://github.com/RetailReason/retail-reason-plugins
   

2. プラグインをインストールします。

   /plugin install retail-reason@retail-reason
   

   （retail-reason はプラグインとマーケットプレイスの両方の識別子です。2026 年 9 月 6 日より前にインストールした場合は walmart-advisor@walmart-advisory が使用されていました。/plugin marketplace remove walmart-advisory でそのマーケットプレイスを削除してから、上記の手順で追加し、インストールしてください。）

3. プロンプトが表示されたら、Retail Reason アカウント（https://app.retailreason.com/app/access）で作成した Retail Reason アクセスキー（wadv_live_...）を入力します。有効なアクセス権を持つ適格なアカウントが必要です。このリポジトリではキーを発行できません。サービスアドレスはプラグインに含まれているため、サーバーアドレスを入力する必要はありません。

4. Claude Code を再起動し、Walmart のサプライヤーまたはセラーに関する質問をして、動作を確認します。

再起動後にキーが使えなくなった場合： キーは OS のキーチェーンに保存されますが、まれに消えることがあります。プラグインの設定（/plugin → Retail Reason → configure）で再入力してください。問題が続く場合は、環境変数を使った代替方法を利用します。シェルのプロファイルに export WADV_LICENSE_KEY="wadv_live_..." を設定し、インストール済みプラグインの .mcp.json を編集して "Authorization": "Bearer ${WADV_LICENSE_KEY}" を読み込むようにします。Claude Code は MCP ヘッダー内の環境変数を展開します。

インストール：Claude Cowork

1. Claude で Customize → Plugins → Add → Add marketplace を開き、Add from a repository を選択します。 RetailReason/retail-reason-plugins を選択するか、 https://github.com/RetailReason/retail-reason-plugins を入力してから、マーケットプレイスを同期します。
2. Retail Reason を追加し、その Connectors タブを開きます。retail-reason の Connect を選択します。 サーバーアドレスは https://mcp.retailreason.com/mcp です。
3. Sign in now、Use Claude's published identity の順に選択します。コネクターを追加し、サインイン画面が開いていない場合は Connect を選択します。有効な Retail Reason メンバーシップを所有するものと同じ ID でサインインします。
4. 新しい Cowork タスクを開始し、Retail Reason を使ってサプライヤーまたはセラーに関する質問をします。Retail Reason のツールが回答と as_of 検証日を返すことを確認します。

Cowork ではアカウントへのサインインを使用します。Claude Code のアクセスキーをリクエストヘッダーやチャットに入力しないでください。認証に失敗した場合は、表示されたサポート参照情報を [email protected] に共有してください。 プラグインの Skills タブには setup と walmart-advisor の両方が表示されます。

インストール：Codex CLI

codex/README.md を参照してください。WADV_LICENSE_KEY をエクスポートし、 codex/config-snippet.toml を ~/.codex/config.toml に貼り付けます。 必要に応じて、Codex thin skill plugin をインストールしてください。

ホスト型クライアントとコマンドラインクライアント

ローンチ時にサポートされるのは、Claude hosted、Claude Code、Codex CLI です。Claude hosted はアカウントアプリケーションから、 Retail Reason の WorkOS ベースの OAuth フローを通じて接続します。 上記の CLI キーは使用しません。アカウント内の接続手順に従ってください。また、wadv_live_... キーを Claude hosted に貼り付けないでください。

ChatGPT は近日公開予定であり、ローンチ時にはサポートされません。引き続き無効になっており、サポート対象のローンチ方法では ChatGPT のサブスクリプションも管理者による設定も必要ありません。この リポジトリでは、ChatGPT のコネクター URL を独自に作成したり、その接続方法が利用可能であるかのように示したりすることはありません。

キーとワークスペースの管理

• 名前付きユーザーごとに個別のキーを作成してください。オーナー、アドバイザー、クライアントゲストの キーを別の人に使い回さないでください。
• ユーザーはローテーション時の重複期間として、アクティブなキーを同時に 2 つまで保持できます。新しいキーを作成し、 Claude Code／Codex を更新して動作を確認してから、古いキーを失効させてください。キーは手動でローテーションしなくても、 最長 180 日で有効期限が切れます。
• ユーザーは自身のキーを失効させることができます。アカウントのオーナー／管理者は、そのアカウント内の任意のキーを失効させられます。 キーがコピーされた、漏えいした、または紛失した場合は、まずキーを失効させてください。
• オペレーターアカウントのワークスペースは通常 1 つです。複数のクライアントワークスペースを利用できるアドバイザーユーザーは、 会話ごとにワークスペースを選択します。クライアントは、get_capabilities、質問、 落とし穴のチェックなど、ワークスペースに依存するすべての呼び出しで workspace_id を渡します。クライアントゲストが利用できるのは、 Advisor Practice または Advisor Network アカウントによって割り当てられた 1 つのワークスペースのみです。

機能マップ（capabilities/capabilities.json）

このファイルは、サービスの対象範囲をまとめた公開情報です。クライアントがこれを読み込むことはありません。 ホスト型サービスに取り込まれ、get_capabilities ツールは、アクセスが有効なアカウントに同じ 4 つの 対象領域を表示します。ワークスペースで認証済みの Scintilla ティアによって、そのワークスペースに適用されるガイダンスは変わりますが、商用の対象領域がなくなることはありません。応答は次のとおりです。

• 統合され、見出しが変更されています。 ファイル内では内部キー（supplier_academy、 scintilla_basic、scintilla_charter、marketplace、supplier_one）で分類されていますが、回答では Walmart サプライヤーの基礎知識、Scintilla／Walmart データ、 Walmart Marketplace、Supplier One の 4 つの領域にまとめられています。Scintilla の 2 つのソースセットは 1 つの Scintilla 領域に統合され、トピックと質問例は結合されたうえで重複が除かれます。

このファイルを編集しても、サービスがコーパスを再取り込みするまではユーザーに表示される内容は変わりません。 プラグインを再インストールしても何も変わりません。項目は成果を中心に記述してください。以下のリークガードでは、 内部構造をそのまま反映したトピック一覧を検出できません。

サポート

サポートは [email protected] へのメールで受け付けています。このメールボックスは監視されており、 オペレーターが直接返信します。（Retail Reason の運営主体は Startup Success Lab LLC です。）組織名と問題が発生したおおよその日時を記載してください。 アクセスキーは絶対に記載しないでください。

コントリビューション／メンテナー

コミットする前に、以下のチェックを実行してください。すべてに合格する必要があります。

./scripts/leak-check.sh
./scripts/brand-check.sh
node scripts/claude-plugin-check.mjs

クリーンクローン CI は、出荷対象のすべての JSON ファイルを検証し、ブランディングと静的リークガードのチェックをプルリクエストごとに 1 回実行します。main へのバイト単位で同一のマージでは、これらのチェックは再実行されません。この公開 CI チェックアウトからは プライベートなコーパスリポジトリを読み取れないため、リリースには、正確なコーパスソースのチェックアウトに対して leak-check.sh --strict を実行し、成功したことを別途記録する必要があります。

leak-check.sh：絶対に公開してはいけないもの

このリポジトリ内のすべてのファイルをスキャンし、公開してはいけない文字列がないか確認します。pre-commit フックとして設定してください。スクリプトはシンボリックリンクをたどって実際の場所を特定します。漏えいが見つかった場合も、チェックを実行できなかった場合も、終了コードが 0 以外であればコミットをブロックします。

ln -s ../../scripts/leak-check.sh .git/hooks/pre-commit

モードは 2 つあります。

• デフォルト：このマシンにプライベートなコーパスリポジトリがない場合、内部名の拒否リストはメッセージを表示してスキップし、静的チェックは実行します。これはコントリビューターモードです。ほとんどのマシンにコーパスリポジトリがないのは当然です。
• --strict：拒否リストがコーパスリポジトリから実際に生成されていない場合、失敗します（終了コード 2）。コーパスのチェックアウトがある環境（Matt のマシン、リリースチェック）では、次のように使用してください。 WADV_CORPUS_REPO=path/to/corpus-repo ./scripts/leak-check.sh --strict。環境変数が設定されていない場合、期待されるレイアウトの兄弟ディレクトリが自動検出されます。

このガードが検出するのは、文字列の完全一致だけです。構造的な漏えい、つまりプライベートなスキルの分類体系と一対一に対応する構成の文章は検出できません。SKILL.md とツールの説明に含まれるトリガー表現は、広く一般的な成果を示すものにする必要があります。この点は人によるレビューが必要です。

brand-check.sh：購入者に伝える、この製品が何であるか

ここにあるファイルはすべて、購入者が読むものです。Retail Reason への名称変更はサーバー（serverInfo.name、/healthz）には反映されましたが、このリポジトリには反映されていませんでした。そのため一時期、インストール手順には、顧客が請求を受けていたことのない製品名が表示されていました。brand-check.sh は、廃止された名称が再び使われた場合、購入者向けの箇所に Retail Reason の名称がなくなった場合、インストールに関する説明で本番環境のエンドポイントがローカル開発用の仮置きと説明されている場合、または顧客向けのプレースホルダーが未解決のまま残っている場合に失敗します。

このチェックでは、マシン識別子は意図的に対象外としています。マーケットプレイスとプラグイン ID（retail-reason）、スキルディレクトリ（walmart-advisor）、MCP サーバーのキー、wadv_live_ キーのプレフィックス、WADV_LICENSE_KEY は、バックエンドの test/distribution.test.ts で固定されているワイヤー値です。MCP ツール名（ask_walmart、check_walmart_pitfalls、…）はプロトコル上の契約です。これらを変更するには 2 つのリポジトリを連携して変更する必要があり、既存のインストールが壊れます。文言の編集に伴って変更してはなりません。

このチェックが定める命名ルール：製品名は Retail Reason です。Walmart という名称は、サービスの対象を説明する場合（「Walmart のサプライヤー向け」）に限って使用します。見出しやマニフェストの表示フィールドで、製品自体の名称に Walmart を含めてはなりません。

エンドポイント

プラグインには、次の MCP エンドポイントが設定されています。

https://mcp.retailreason.com/mcp

エンドポイントはアカウント／請求 API とは別のホストを使用します。引き続き、利用資格を満たし、アクセスが有効なアカウントと、Claude Code および Codex 用のユーザーに紐づいたキーが必要です。使用するクライアントとアカウントについては、上記の最新の接続ガイドを参照してください。

別のローカルバックエンドを使用する開発者は、ローカルの Claude Code または Codex の MCP 設定で URL を http://localhost:8787/mcp に変更できます。その環境用に発行された認証情報を使用してください。

ライセンス

このリポジトリ内のファイルは、MIT License のもとで公開されています。ホスト型の Retail Reason サービス、そのナレッジコーパス、および回答はこのリポジトリに含まれず、Retail Reason の利用規約（https://retailreason.com/terms/）が適用されます。