learn-visual

ビジュアルで学ぶ

1つのアイデアに、1つの図を用意します。図は装飾ではなく、学習者がそのステップを納得して受け入れられるようにするためのものです。

出力

.alvar/visuals/<slug>-<n>.svg に書き込みます（フォルダーを作成してください）。セッションファイルに埋め込むか、リンクします。

SVG を優先します。ハーネスで SVG をプレビューできない場合に限り、別の形式を使います。

手順（省略しないでください）

1. 図が示すべき主張を、1文で述べます。
2. その主張を示すために必要な最小限の図を描きます。
3. ファイルを確認します（画像／読み取りツール）。表示できない場合はその旨を伝え、テキストとして確認しやすいシンプルな SVG にします。
4. ラベル、重なり、矢印の誤り、単位の欠落、主張と一致しない図を修正します。
5. もう一度確認します。初稿で終わらせず、問題のない状態になったら終了します。

デザイン

• 主張は1つにします。コース全体のコラージュは作りません。
• ラベルは大きくし、コントラストを高くします。読み解くために別の説明が必要な小さな凡例は使いません。
• アイデアが代数的なものなら、式のスクリーンショットではなく、対象（矢印、平面、機械）を示します。
• 装飾的なグラデーション、透かし、「AIアート」の背景は追加しません。

確認時に見つけるべき問題

• 矢印の向きが説明と一致していない
• 同じ対象を表す記号が2つある
• 3D 表現によって関係が見えにくい
• テキストが切れている
• 直前に教えたものとは異なる特殊ケースの図になっている

作成後

「まず2本の矢印を見て、次に対応を示す数を見てください」のように、最初に注目する箇所を学習者に伝えます。求められない限り、ノード全体をもう一度教える必要はありません。