上流工程とAI駆動開発 1196上流工程とAI駆動開発

文字で書く図とMermaid

一覧に戻る

遷移の図をMermaidの文字で残すとClaudeが読み直して直せるが、ブラウザはそのままでは図にしないので、見るためのHTMLを別に作らせる。。97秒の動画で、効果音と画面の字幕だけで進みます。

用語 Mermaid = Mermaid

字幕の全文

  1. 同じ画面遷移の図を、画像で残した場合と文字で残した場合で見比べます
  2. 画面を1つ足すことになったら、どちらが直しやすいでしょうか
  3. 画像の図は、画面の枠と矢印を描き直さないと直せません
  4. 文字の図は、メニューから工数入力へ進む行を1行足すだけで直せます
  5. この文字での図の書き方が、Mermaidです
  6. 1行目の「flowchart LR」は、左から右へ進む流れ図だという宣言です
  7. 2行目からは、「A --> B」の形で、画面どうしの矢印を1本ずつ書きます
  8. 角かっこの中に書いた画面名が、図の枠の中に表示されます
  9. 矢印に名前を付けるときは、「A -->|保存| B」と書く決まりです
  10. 文字で残してあるので、Claudeは図を読み直して行を足せます
  11. そのため、Mermaidの書き方を覚える必要はありません
  12. 人は、画面の名前と矢印の行き先が合っているかを確かめます
  13. ところが、ブラウザはMermaidの文字をそのままでは図にできません
  14. そこで、同じ遷移をHTMLとSVGで描いた画面遷移.htmlも作らせます
  15. 人が図を見るときは、画面遷移.htmlをダブルクリックして開きましょう
  16. 画面が増えたときは、文字で書いた画面遷移.mdのほうを直します
  17. HTMLの図だけを直すと、文字の図と食い違ってしまうのです
  18. 遷移は文字で残して直し、見るための図は別に作らせましょう