DiagramZu を理解する 6 つの考え方

どの図にも、図とともに移動する説明文が付きます — 閲覧者にも、次のエージェントにも読まれます。

図を作成・更新するとき、AI に 1〜2 文の説明を書かせてください。それは公開シェアリンクのサブ見出しになり、次のエージェントが図を取得したときに最初に読む情報になります。説明は「なぜ・何を」、コードは「どうやって」です。

どんな図も、ログイン不要で開ける推測不能な閲覧専用 URL に変えられます。

シェアリンクは、AI が作った図が DiagramZu の外へ出る手段です。22 文字のランダムな URL で、誰でも開け、表示されるのはレンダリング済みの図だけ — エディタもコードもありません。シェアメニューから取り消せば即座に無効になります。オンボーディング資料、レビュースレッド、README の「例を見る」リンクに最適です。

スナップショットは意図して取ります — 人が節目で保存するか、エージェントが意味のある変更をしたあとに。打鍵ごとには取りません。

AI は更新時に createVersion: true を渡し、人はツールバーの「バージョンを保存」を押します。自動保存のノイズを掻き分ける必要はありません。過去のバージョンを復元すると、まず現在の状態をスナップショットするので作業を失いません。「新しい図として開く」はバージョンを別の図に持ち出し、元の図には触れません。

スペースでレビューを有効にすると、既存の図へのエージェントの編集は提案として保留され、チームが承認してから反映されます。

任意の機能で、一人で使うぶんには即時のままです。レビューを有効にすると、既存の図へのエージェントの更新は上書きではなく保留中の提案になります。図を開き、公開中のものと diff を見比べ、承認するか差し戻します。承認時にはまず元の状態をバージョンとして保存します — バージョンは事後の復元、提案は事前の関門。

layout を auto にすると、決定論的な分類器がグラフの形から最適なレイアウトを選びます。

木構造はきれいなツリーへ、密な循環グラフはフォースへ、整った DAG は dagre へ — 6 つのレイアウトから保存時に一度だけ選んで固定します。だから図はいつでも再現できます。気に入らなければ、ツールバーからワンクリックで上書きできます。

1 つの iframe でどんなページにも図を埋め込み — テーマに合わせ、操作でき、常に最新です。

埋め込みはシェアリンクを指すので、常にライブの図を表示します — DiagramZu で編集すれば、すべての埋め込みが自動で更新されます。フレームにはエディタの装飾がなく、パン・ズームに対応し、ホストページのライト/ダークに合わせます。控えめなバッジがホームへリンクし、Embed タブで 7 日間の読み込み数を確認できます。iframe が使える場所ならどこでも — ドキュメントサイト、Notion、ブログ、Wiki。