デザインリサーチ：エキスパティーズループ は何をしますか？
ツール：インストール後は
ddr <command>（python tools/ddr.py install）、それ以外はpython <repo>/tools/ddr.py <command>（<repo>はこのスキルの実際の（シンボリックリンク解決後の）フォルダから2階層上のディレクトリ）。
あなたはしっかりと観察した分野ではうまくデザインでき、そうでない分野ではうまくいきません。このスキルは、デザインする前にその分野のエキスパートになる方法、そしてその専門知識を長期にわたって正しく維持する方法です。出力はムードボードではありません。それはドメインです：あなたが理解したことのドシエ、実際に確認したリファレンスのライブラリ、そしてその証拠から計算された信頼度スコアです。
決定を変えないリサーチはブラウジングです。記録しなかったリサーチは失われます。両方を適切に行うか、リサーチしたと主張しないでください。
0. 現在地の確認
ddr domain match "<ブリーフを一文で>"
これにより、セクター（ビジネスやオーディエンスの種類）とパターン（フローやサーフェス：オンボーディング、チェックアウト、予約、価格表示、ダッシュボード）が、それぞれの信頼度とともに返されます。次に ddr domain plan <スラッグ> --stakes low|medium|high を実行します：
| ステークス | いつ | 目標 |
|---|---|---|
| low | 既存システム内のコンポーネントや微調整 | 35 |
| medium | ページ、フロー、1つのサーフェスのリデザイン | 55 |
| high | 新しいサイト、ブランド、ローンチ、ビジネスが評価されるものすべて | 70 |
目標が達成された場合は、ddr domain brief <セクター> <パターン> を読み、デザインディレクターに戻ります。達成されていない場合は、目標に達するか、時間が許す限り実行し、どこまで到達したかを率直に伝えるまで、以下のループを実行します。聞かれるのを待ってはいけません。ユーザーに一行で伝えてください：「独立した宿泊施設に関する信頼度は12なので、まずカテゴリをリサーチします（約20のリファレンス）。」
新しい領域
一致するドメインがない場合は、新しく作成します。リファレンスが転用できるレベルを選択します：介護施設と歯科医院はどちらも「ヘルスケア」ですが、それらのサイトはほとんど共通点がないため、別のセクターです。最良のリファレンスが同じリストになる2つのドメインは、1つのドメインです。
ddr domain new independent-stays --kind sector --title "独立した宿泊施設" \
--summary "直接販売するセルフケータリングコテージ、ゲストハウス、小規模ホテル" \
--keywords "セルフケータリング,コテージ,ゲストハウス,B&B,ブティックホテル,バケーションレンタル" \
--aliases "短期宿泊,バケーションレンタル"
キーワードはクライアントが使用する言葉であり、デザイン用語ではありません。パターンとは、セクターをまたいで繰り返し発生し、独自のベストプラクティスを持つものです。ブリーフがそれを中心とする場合に作成します。相互に情報を与え合うドメインを関連付け（ddr domain relate independent-stays booking --how "空室状況が価格より先"）、実際には1つであることが判明した2つをマージし（ddr domain merge <from> <into>、削除されるものはありません）、2つのオーディエンスに成長したものを分割します（2つ目を作成し、それに属するリファレンスを移動します）。
使用するツール
以下の順序で最良のものを使い、どれを使ったかを明記します：
| ジョブ | 最良 | フォールバック |
|---|---|---|
| 説明から候補を探す | Exa MCP（ddr mcp --research でセットアップを表示） | 自身のウェブ検索、カタログ |
| 特定の場所や業種の最良の独立系を探す | Brave Search MCP ローカル and プレイス検索 | 「<町>の<業種> ベスト」のウェブ検索、レビューサイト、アワード候補 |
| 実際の製品スクリーンとフロー | Mobbin または Refero MCP（有料） | 公開ティアダウン、自分でフローをウォークスルー |
| リファレンスを確認し測定する | ddr teardown <url> --into <スラッグ> | Playwright または Chrome DevTools MCP、その後スクリーンショット |
| 安全にジャーニーをウォークする | ddr teardown <url> --walk "予約する>空室確認" | Playwright MCP、決して送信しない |
| デザインの古さを確認する | ddr history <url>、その後アーカイブ版をティアダウン | サイト自身のニュースやローンチ記事 |
| サイドバイサイドで比較する | ddr sheet --domain <スラッグ> --with yours.png | ddr sheet a.png b.png c.png |
| ブランドのトークンを抽出する | Firecrawl MCP branding フォーマット | ddr teardown による測定済みのタイポグラフィとパレット |
ddr teardown は、デスクトップとモバイルのファーストビュー、フルページ、スクロール停止フレームのストリップを保存し、ライブページを測定します：設定するテキスト量によるフェイスとサイズ、塗装面積によるパレット、コントロールカラー、角丸、シャドウ、セクションパディング、段落幅、モーション（トランジションタイミング、スクロールライブラリ、ビデオ、キャンバス、動きを抑えるルール）、構築スタック、ナビゲーション、コールトゥアクション（ファーストビューより上にあるかどうか）、そして生成デザインの兆候（ストックコピー、アイブロー、グラデーションテキスト、ガラス、アイコンカードのトライアド）。数値によってあなたの見解は具体的になります。それらが実際に見ることに取って代わることは決してありません：画像を開いてください。
1. 領域をマッピングする
ギャラリーを開く前に、実際に誰がベストかを書き留めます。カテゴリ内のベストとは、その業界の人々が尊敬するビジネス、評判で勝っているビジネス、そしてカテゴリがコピーするサイトを持つビジネスです。以下の3つの方法で見つけます：
- 直接（
--angle direct）：この正確なカテゴリのトップ6～12。市場のトップと、明らかにうまくやっている小規模独立系を含みます。ウェブ検索、業界紙、カテゴリ内のアワード候補、およびカタログ（ddr sources search "<カテゴリ>" -v）を使用します。 - リーダー（
--angle leader）：より要求の厳しい顧客に対して同じ問題を解決する隣接カテゴリの最良の作品（コテージ向けのブティックホテルグループ、信用組合向けのプライベートバンク）。 - 外部（
--angle outside）：まったく別の分野から少なくとも2つのリファレンス。被写体の世界に合わせて選びます（印刷されたガイドブック、建築モノグラフ、メニュー、映画タイトル、サイン）。ddr sources shuffle -n 4は抽選を提供します。
ギャラリー（Awwwards、recent.design、Land-book）は手がかりであり、決して証拠ではありません。デイリーピックよりも年間および月間アワードを優先します。
2. 適切に見る
リファレンスは、実際に見た分だけカウントされます：
--evidence | 意味 | 重み |
|---|---|---|
search | それについて読んだか、サムネイルを見た | 4分の1 |
visited | ライブサイトをロードして読んだ | 1 |
screenshot | レンダリングしてデスクトップとモバイルのピクセルを見た | より多い |
flow | 実際のジャーニーをウォークした（予約、サインアップ、チェックアウト） | 最も多い |
各本命候補をティアダウンし、画像を開きます：
ddr teardown https://a.example https://b.example --into <スラッグ>
数値だけでなく、ファーストビューとスクロールフレームを見てください。ベストな2～3件については、ddr history <url> も実行します：「新鮮な」リファレンスでも、2019年からのデザインのものは今ではテンプレートであり、アーカイブ版はどの動きが新しいかを示します。ブリーフに一致するジャーニーを、支払いや送信をせずに可能な限りウォークします。ローディングスクリーンやクッキーウォールはデザインではありません。それに注意して、その先を見てください。
サイトの利用規約で自動アクセスが禁止されている場合（カタログで agent_access = "scrape-no"）、人がするようにブラウズし、visited を記録します。ペイウォールのあるスクリーンや誰かの写真を公開リポジトリにコピーしないでください。スクリーンショットは公開されることのないドメインホームに残ります。
3. ティアダウンして記録する
場所を獲得したすべてのリファレンスについて、その teardown.md から測定値を使用してすぐに記録します：
ddr domain ref add <スラッグ> --name "名前" --url https://... --verdict exemplar \
--angle direct --evidence screenshot --score 4 --shots shots/<ホスト> \
--take "空室カレンダーがヒーローで、各日付の横に1泊あたりの価格が表示され、15pxのコンデンスドセリフで設定されている" \
--avoid "自動再生のドローンビデオが最初の有用な画面を4秒遅らせる" \
--tags layout:calendar-hero,type:serif-condensed
--take は具体的な動きであり、可能な場合は値（サイズ、色、タイミング、実際の言葉）を含めます。「クリーンでモダン」はテイクではありません。正直にスコアをつけてください：5はデザインの仕方が変わる、3は堅実で典型的、2をつけるようなものはエグザンプラーではありません。
4. スロップを狩る
カウンター例（--verdict counter --avoid "..."）を3～5つ見つけます：テンプレートサイト、生成的に見えるサイト、このカテゴリで時代遅れのサイト。これらはエグザンプラーと同じくらい価値があります。なぜなら、このカテゴリのスロップが具体的にどのように見えるかを示しており、デザインディレクターのSLOP.mdは一般的にしか説明できないからです。そのパターンをドシエの カテゴリのスロップ セクションに書き込みます。そのセクションが存在するまで、信頼度は60に制限されます。
5. ドシエを書く
$(ddr domain path <スラッグ>)/dossier.md を開き、見たものから各セクションを書き、リファレンスを名前で挙げます。具体的で意見のある内容にします：
- 誰のためのものか：誰が使い、何に不安を感じ、何と比較するか。
- ベストが行うこと：ベストが共有する動きとその値。
- 維持すべき慣習：ユーザーが依存しているもの。これらを例外的にうまく行う。
- 破るべき慣習：ここで怠惰または時代遅れなもの、そしてそれを何で置き換えるか。
- カテゴリのスロップ：このカテゴリで生成された作品やテンプレート作品がどのように見えるか。
- 言語：この世界に属するタイポグラフィ、色、イメージ、ボイス、モーション、そしてその理由。
- 未解決の質問：まだわからないことと、それを明らかにするもの。
6. キュレーション
ddr domain audit <スラッグ> --online
これにより、古くなった（1年間見られていない）、弱い（検索のみ）、矛盾している（2とスコアしたエグザンプラー）、リンク切れ、移動した、またはすべてが1つの角度や1つのソースからのものであるリファレンスがフラグ付けされます。すべての結果に対して行動します：再度見る（ddr domain ref seen）、スコアを再評価する、または理由を付けて廃棄する（`ddr domain ref retire <スラッグ> --reason "2026年にテンプレートにリデザインされた"）。廃棄されたリファレンスは墓地に残り、静かに再追加されることはありません。ライブラリは、捨てる意志があるものと同じくらい良いものです。
7. 比較し、再スコアリングする
ドメインのベストのコンタクトシートを作成し（ddr sheet --domain <スラッグ> --n 6）、セットとして見ます。すべてが似ているように見える場合、ライブラリは1つのアイデアに収束しており、次の検索ではそれらと矛盾するリファレンスを探す必要があります。
8. 再スコアリングして決定する
ddr domain status <スラッグ>
これにより、スコア、そのすべての構成要素、上限、およびそれを引き上げるものが表示されます。ステークスの目標が達成されるまで、最大のギャップに対してループを繰り返します。その後、ユーザーに到達点を一行で伝え（「独立した宿泊施設は現在58：14サイト閲覧、4つのカウンター例、スロップを記録済み」）、デザインディレクターのステップ1に戻ります。
深さ
努力をステークスに合わせて拡大縮小し、行ったことを述べます：
- 低：4～6のリファレンス、1つのカウンター例、スロップの行を記述。数分。
- 中：3つの角度すべてから8～12のリファレンス、3つのカウンター例、すべてのドシエセクション。1時間未満。
- 高：15～25のリファレンス、ベスト3でウォークしたフロー、4つ以上のカウンター例、2つの外部リファレンス、監査パス。必要なだけの時間。
プロジェクトは依然として独自の短い台帳を .design/references.md に保持します：このジョブで決定を変えた5～10のリファレンスを、それぞれ1行、変更した決定とともに。ドメインはあなたが知っていることです。プロジェクト台帳はあなたが使用したものです。
ルール
- 認識可能なロゴ、写真、有料フォント、プロプライエタリなイラストではなく、テクニックと原則を借用します。
- アクセス失敗（ペイウォール、ボットブロック、リンク切れ）を、その背後に何があったかを推測するのではなく記録します：
ddr domain log <スラッグ> note "Revolutがレンダラーとプレーンリクエストをブロックしました"。 - 見ていないリファレンスを見たとして記録しないでください。スコアは、獲得していない専門知識を主張するのを防ぐために存在します。それを水増しすることは、それが唯一の目的であるものを無効にします。
- カタログエントリがリンク切れまたは間違っている場合は、
ddr sources addで修正し、そこに素晴らしい新しいソースも追加して、次の人が先に進めるようにします。