プラグインの考え方
どのページも、結論から始まる理由
どのページも1文の結論から始まるので、最初の画面で読むのをやめても要点は伝わります。
- 結論は1文で、タイトルの真下に置きます。
- 要点は3つまで。次にそのページの図です。
- どちらも、表示前にチェッカーが確かめます。
結論はどこにあるか
同じ内容を、2通りの順番で- 結論を先に置く理由ページは長く、読む人は疲れていて、勝負は最初の画面で決まります。
- 長いページを読みやすく保つ工夫押さえる3点、前提のおさらい、章末のポイント。
- 約束を守らせる仕組み厳しい上限のあるチェッカーと、それを動かすフック。
- 試す価値があるか何が根拠のある話で、何が好みで、何が未検証か。
第1章 / 全4章、約1分
なぜ結論が先なのか
おさらい:結論はタイトルの真下にあるので、そこで読むのをやめても要点は伝わります。
エージェントは、読み切れないほど長い要約、計画、差分、状況報告を書きます。ワーキングメモリが小さい人は、スクロールするうちに流れを見失います。まず流し読みをして、読むとしてもそのあとです。
- 結論タイトルの下の1文を読みます。
- 押さえる3点黄色いカードを見ます。4つ目はありません。
- 図そのページ専用の図を見ます。たとえば状態ボードです。
- やめるか、読み進めるか章は読まなくても構いません。
つまり:どの段階でも、そこでやめられます。結論と押さえる3点だけで、要点は伝わります。
実際のページ21件を見直すと、19種類が、スマホで同じ最初の画面になっていました。1.8.0 のリリースで変わり、今は最初の画面を見ればページの種類がわかります。
この章のポイント:勝負は最初の画面で決まるので、結論と押さえる3点をそこに置きます。
第2章 / 全4章、約1分
どうすれば長いページで迷子にならないか
おさらい:最初の画面には、結論、押さえる3点、そのページ専用の図があります。
要点ボックスに、持ち帰る3点を書きます。4つ目は求めません。そのあとの各章は単独で読めるので、途中から読み始めても困りません。
- 「前述のとおり」
- 「3節を参照」
- 「まとめると」
- 「おさらい」の行で、その章が前提にする1つの事実をもう一度示します。
- 章へのリンクに、その章の要点を添えます。
- 各章のポイントを集めた「まとめ」の枠があります。
つまり:どの章から読み始めても、その章が前提にする事実が1つ書いてあります。
どの章も、覚えておく1文で終わります。最後の「まとめ」は、その文をそのまま集めたものです。新しい内容は出てきません。
ページの構成順を見る
- 結論、次に要点ボックス。
- 「ひと目でわかる」:そのページ専用の図。
- 目次、続いて3〜7章。
- まとめ。判断が必要なときだけ、最後に「お願いしたいこと」が付きます。
この章のポイント:どの章も、前提のおさらいで始まり、ポイントを1行で締めます。
第3章 / 全4章、約1分
プラグインは、どうやって約束を守るのか
おさらい:どのページも、短い結論1つ、押さえる点は3つまで、章ごとに図1つを約束します。
チェッカーがすべてのページを読み、約束が破られていれば不合格にします。上限のうち4つを挙げます。
つまり:これらの上限は厳格です。1つでも破ったページは不合格になり、ページを見る前にエージェントが直します。
Claude Code では、ページを書いたターンの終わりに、フックがチェッカーを実行します。失敗は1件ずつエージェントに返し、1ターンに最大3回まで直させます。
各上限が書かれている場所を見る
skills/glance-explainer/scripts/check.mjs:73では、結論は英語40語・日本語70文字、段落は40語・90文字、押さえる点は15語・25文字までと決めています。check.mjs:126では、要点ボックスの項目が3つを超えると不合格にします。check.mjs:184では、スマホでの最小ラベルを 9px に定めています。check.mjs:258では、コントラスト比が4.5:1未満の文字と背景の組み合わせを不合格にします。hooks/explainer-check.mjs:14では、フックが1ターンを止められる回数を最大3回にしています。
行番号は、コミット 6ffbbbc の時点のものです。
この章のポイント:上限は厳格で、ページを見る前に、チェッカーとフックが守らせています。
第4章 / 全4章、約1分
自分の仕事で試す価値はあるのか
おさらい:チェッカーとフックが、すべてのページの形を守らせています。
デザインガイドは、自らの選択を3つに分類しています。どこまでが根拠のある話か、見分けられます。
根拠がある
- 短い段落1段落に1つの話題。W3C COGA の助言に沿っています。
- 進み具合の表示完了、現在、これからの章がわかります。
設計上の判断
- 要点は3つ数が少なく、取捨選択を迫れるため残しています。
- 章の長さ経験則にもとづく既定値です。裏づけの主張は、確認で否定されました。
根拠がないので採用しない
- バイオニックリーディング視線計測では、効果が見られません。
- ディスレクシア向けフォントふつうのフォントと比べて、利点はありません。
つまり:どの選択が根拠にもとづき、どれが好みなのかを、ページ自身が示しています。
ロードマップによると、これまでのページはすべて作者が評価しました。プラグインのページが標準のページ以上に外部の読み手の役に立たなければ、ロードマップは保守作業だけに縮みます。
この章のポイント:根拠のある部分と好みの部分があり、外部の読み手による検証はまだです。
まとめ
- 勝負は最初の画面で決まるので、結論と押さえる3点をそこに置きます。
- どの章も、前提のおさらいで始まり、ポイントを1行で締めます。
- 上限は厳格で、ページを見る前に、チェッカーとフックが守らせています。
- 根拠のある部分と好みの部分があり、外部の読み手による検証はまだです。
お願いしたいこと
どこから始めますか?
何もしなければ:何も変わりません。すでにあるページは、そのままです。