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