visualizar は何をしますか？
ビジュアルは、言葉ではうまく表現できないもの——形、構造、方向、関係、比率、空間——を示す場合にのみ授業に取り入れます。装飾的なビジュアルやテキストを繰り返すだけのビジュアルは負荷を増やし、誤っている可能性もあります。迷ったら作成しないでください：ビジュアルがないことの代償は、誤ったビジュアルがあることより小さいのです。
1. タイプを選ぶ
| アイデアの種類 | ブロック | 例 |
|---|---|---|
| 関係、依存関係、フロー、原因 → 結果 | aula.diagrama (Mermaid graph TD/LR) | セリックがパンの価格にどう影響するか |
| アクター間の一連の相互作用 | aula.diagrama (sequenceDiagram) | 訴訟手続きの段階 |
| タイムライン | aula.diagrama (timeline) | ブラジルの憲法史 |
| 階層 / 分類 | aula.diagrama (graph TD または mindmap) | 法規範の階層 |
| 数値データ、比率、幾何学、図面 | aula.figura (手描きSVG) | 月次インフレ率 |
| 実在の作品、物体、場所 | aula.imagem | アルボラーダ宮殿 |
2. アイデアだけが残るまで削る
- ビジュアル1つにつきアイデア1つ。 2つ必要なら、2つのビジュアルにする。
- 最大約7要素（ノード、棒、ラベル）。それぞれに問いかける：「これを削除してもアイデアは明確に伝わるか？」「はい」なら削除する。
- ラベルは短く：1語または句、文は避ける。
- ダイアグラム内にタイトルは不要（ブロックに
tituloがある）。
3. ビジュアルと説明を一体化する（近接性、冗長性なし）
- ブロックの
textoフィールドを使用：説明は横に（またはビジュアルが広い場合はすぐ下に）表示される。 - テキストはビジュアルの要素を一つずつ説明するのではなく、どこを見るべきかと何を結論づけるべきかを示す（「矢印が戻っていることに注目：これは循環です」）。
- ラベルをビジュアル内に配置できる場合は、別の凡例ではなくそこに配置する。
4. タイプごとのルール
Mermaid
- 特殊文字や
R$を含むテキストは引用符で囲む：A["R$ 1.000"]。 - ラベル内の改行：
<br/>。 graph TD（上から下）は基本→結果に；graph LRは時間経過のあるプロセスに。
SVG（図表とグラフ）
- 座標はスクリプトで計算する（例：
node -e "..."）、「目分量」ではダメ：誤った比率は誤解を生む。 viewBoxには余白を、font-family="Inter, sans-serif"を、テキストにはfill="currentColor"を（ライトテーマとダークテーマの両方で機能）。- データカラーは最大2色＋ニュートラル。データソースは
legendaに。
画像
- 建築、デザイン、アートの授業では、対比ペア（失敗例×成功例）を2つの連続した
aula.imagemで提示し、タイトルを「改善前：…」/「改善後：…」にする。受講者に先に見て、後で読むように促す。textoにはどこを見るべきかと画像に写っていないもの（図面、縮尺、素材、コンテキスト）を記述し、見えるものだけを説明する。 - Wikimedia Commonsを優先。ファイルページで作者とライセンスを確認し、
credito、licenca、link（ファイルページ）を記入する。 srcには画像の直接リンク（upload.wikimedia.org/...）を使用する。- クレジットなし、または転載禁止のサイトの画像は決して使用しない。
5. 確認は必ず目視で——必須
エラーなくレンダリングされたからといって、ビジュアルが正しいとは限りません。ブロックを作成した後：
- 約3秒待つ（ページは自動更新される）。
- [Claude Code] アプリのブラウザでブロックまでスクロールし、スクリーンショットを撮る（例：
javascript_toolでdocument.querySelectorAll('[data-tipo="diagrama"]')→ 最後 →scrollIntoView()、その後computer→screenshot）。 他のエージェント：受講者に見てもらい確認を依頼する。 - 批判的に確認する：
- 各矢印は正しい方向を指しているか？ 各関係は真実か？
- 数値と比率はデータと一致しているか？
- ラベルが切れたり、重なったり、読めなかったりしていないか？
- 赤い枠「ダイアグラムエラー」が表示されていないか？ → 構文を修正する。
- 画像：読み込まれているか？ (
img.naturalWidth > 0) - 一目見てアイデアが理解できるか？
- 修正して再確認する。正しく明確なビジュアルが得られない場合は、ブロックを削除してテキストで説明する。