normies

Normies

概要

それぞれ異なる技術的習熟度の人を演じるサブエージェントのパネルを起動し、何の予備知識もない状態でサイトを訪問させます。各エージェントは、理解できたこと、分かりにくかったこと、諦めた場所を報告します。基本となる考え方は、専門家から初心者までの習熟度の幅です。

これは技術的なレビューではありません。 review-squad:experts スキルでは、コード品質、SEO、アクセシビリティへの準拠などを扱います。このスキルが答えるのは、「実際の人々は私のサイトを理解できるか？」という問いです。

使用するタイミング

• リリース前：「訪問者はこれが何か理解できるか？」
• リデザイン後：「分かりやすくなったか、それとも分かりにくくなったか？」
• 新しいランディングページ：「このページは意図した内容を伝えられているか？」
• 定期チェック：「新規訪問者の体験を見失っていないか？」

ワークフロー

digraph normies {
  rankdir=TB;
  "User requests first-time review" -> "Present default persona panel";
  "Present default persona panel" -> "Ask: add, remove, or adjust?";
  "Ask: add, remove, or adjust?" -> "Finalize panel";
  "Finalize panel" -> "Ensure dev server is running";
  "Ensure dev server is running" -> "Dispatch agents sequentially";
  "Dispatch agents sequentially" -> "After each: report key impression";
  "After each: report key impression" -> "All done?";
  "All done?" -> "After each: report key impression" [label="no"];
  "All done?" -> "Compile confusion matrix + recommendations" [label="yes"];
}

順次ディスパッチが必須です。 ブラウザー MCP ツールは単一のブラウザーインスタンスを共有します。エージェントは並列ではなく、一度に 1 つずつ実行する必要があります。

デフォルトのパネル（6 人のペルソナ）

ディスパッチする前に、このスペクトラムをユーザーに提示します。必要に応じて調整できます。

#	ペルソナ	習熟度	辛抱強さ	諦めるまでの時間
1	シニア開発者	専門家	低い — あらゆる欠点に気づく	混乱してから 30 秒
2	プロダクトマネージャー	高い	中程度 — 目標志向で、すぐに「理解」したい	明確な説明がないまま 45 秒
3	大学生	中程度 — デジタルネイティブで、努力は最小限	非常に低い — すばやくスクロールし、見た目で判断する	退屈してから 10 秒
4	中小企業の経営者	中程度 — 日常的にウェブを使うが、技術には詳しくない	低い — 忙しく、今すぐ答えが必要	必要な情報が見つからないまま 60 秒
5	退職した教師	低い — 丁寧に読むが、専門用語に戸惑う	高い — 試してみるが、迷ったら諦める	混乱してから 2 分
6	誰かの祖父母	最小限 — アイコンの意味が分からず、専門用語にもなじみがない	非常に高い — 理解したいが、簡単に挫折する	本当に混乱した最初の瞬間

サイトの対象読者に合わせて追加を提案してください。 開発者向けのサイトなら、ジュニア開発者を追加します。レストランのサイトなら、スマートフォンを手にしたお腹を空かせた人を追加します。実際に訪問する人に合わせてペルソナを設定します。

エージェントプロンプトのテンプレート

すべてのエージェントプロンプトは、必ず次の構成に従ってください。

You are [NAME], a [AGE]-year-old [OCCUPATION/DESCRIPTION].
[2-3 sentences of personality and web behavior.]
You have NEVER seen this site before. You know NOTHING about it.

Do NOT read any source code or project files. You are a visitor, not a developer.
If browser MCP tools are available, use them to visit the site at [URL].

YOUR EXPERIENCE:
1. Navigate to [URL]. Take a screenshot.
2. In the first [TIME LIMIT] seconds, answer: What is this site about?
   If you can't tell, say so honestly.
3. Try to find [SOMETHING RELEVANT TO THIS PERSONA].
4. Navigate wherever feels natural to you. Take screenshots.
5. Note every moment you feel confused, lost, or unsure what to do.
6. Note every piece of jargon or text you don't understand.
7. When you would give up in real life, STOP. Say why.

Write your report IN CHARACTER as [NAME]. Be honest. Structure it as:
- **First Impression** (what I saw and thought in the first 5 seconds)
- **What I Think This Site Is About** (honest interpretation)
- **Where I Got Confused** (every point of friction, in order)
- **Where I Gave Up** (what finally stopped me, or "I didn't")
- **What I Couldn't Find** (things I wanted but couldn't locate)
- **Words I Didn't Understand** (jargon list)
- **What I Liked** (be fair)

重要な要素：

• 詳細なペルソナ — 名前、年齢、性格、ウェブでの行動。「一般ユーザー」だけでは不十分です。
• コード閲覧禁止 — 「ソースコードを読んではいけません」。これが最も重要なルールです。先入観のない第一印象だけを扱います。
• 制限時間 — 各ペルソナには辛抱できる時間のしきい値があります。実際に離脱するタイミングになったら、そこで終了します。
• 役になりきった報告 — 退職した教師は、退職した教師らしい文章で書きます。これにより、異なる言葉遣いや優先事項が浮かび上がります。
• スクリーンショットを活用 — 重要な場面でスクリーンショットを撮り、ペルソナが見たものをユーザーが確認できるようにします。

ディスパッチのパターン

並列ではなく、順次実行します。 ブラウザー MCP は単一のブラウザーインスタンスを共有します。

Agent 1 (Senior Developer) → collect report
Agent 2 (Product Manager) → collect report
...
Agent 6 (Grandparent) → collect report

各エージェントの完了後、次に進む前に、第一印象を簡潔にユーザーと共有します。

結果の統合

すべてのペルソナから報告を受けた後、混乱マトリクスを作成します。

## Normies Review: [Site Name]

### Confusion Matrix

| Issue | Dev | PM | Student | Business | Retired | Grandparent |
|-------|:---:|:--:|:-------:|:--------:|:-------:|:-----------:|
| Can't tell what site is about | | | ✗ | ✗ | ✗ | ✗ |
| Can't find contact info | | | | ✗ | ✗ | ✗ |
| Jargon in hero text | | | | ✗ | ✗ | ✗ |
| Hamburger menu not recognized | | | | | | ✗ |

### Severity (by how many personas hit it)

- **6/6 or 5/6** → CRITICAL — nearly everyone is confused
- **3/6 or 4/6** → IMPORTANT — most non-technical visitors struggle
- **1/6 or 2/6** → MINOR — only edge cases

### Recommendations (prioritized)

| Priority | Issue | Who's confused | Suggested fix |
|----------|-------|---------------|---------------|
| 1 | ... | 5/6 personas | ... |
| 2 | ... | 3/6 personas | ... |

混乱マトリクスが最も重要な成果物です。 どの問題が誰にでも共通するのか、どの習熟度の人にだけ影響するのかをひと目で示します。

レポートの後

1. 混乱マトリクスと推奨事項を提示します
2. 問題を修正するかユーザーに確認します
3. 修正する場合は、影響を受けたペルソナの数に基づいて優先順位を付けます（まずは全員に共通する混乱から）

よくある間違い

• 最初にコードを読む — エージェントには、初めて訪れたユーザーとして行動してもらう必要があります。コードの知識があると、印象が損なわれます。
• 印象のテストではなく、技術的なテストをする — これはアクセシビリティ監査でも SEO チェックでもありません。それらは review-squad:experts で行います。
• 平板なペルソナ — 「気軽に使うユーザー」ではペルソナとはいえません。名前、年齢、職業、性格、具体的なウェブ上での行動パターンを設定してください。
• 我慢の限界を設定しない — 実際の人は、困惑すると離脱します。エージェントも同じようにしてください。
• 三人称で報告する — 役になりきって報告すると、言葉遣いや優先事項が変わります。Margaret は「情報アーキテクチャが分かりにくい」とは言いません。「どこに何があるのか分からない」と言います。
• 並行して実行する — Browser MCP は共有リソースです。順番に実行してください。