claat 手順書ワークフロー

素材から manual.md を書き起こし、lint を通して HTML にするまでを担当する。読者は「その分野をまったく知らない中学生」だと想定する。読者が途中で手を止めずに最後まで到達できたら成功で、それ以外はすべて失敗と考える。

全体の流れ

素材 → 執筆(§1-4) → 日本語チェック(§5) → lint(§6) → HTML 生成(§7) → 報告(§8)
                ↑                                  │
                └───── 本文を書き足す必要が出たら ──┘

順序を入れ替えない理由がそれぞれにある。

• 日本語チェックは lint より先。 日本語を直すと行がずれ、画像の相対パスや Duration の位置が壊れることがある。逆順にすると通ったはずの lint をもう一度落とす
• lint は build より先に単独で回す。 build は lint に落ちた時点で止まるので、診断を先に全部見てまとめて直したほうが往復が減る

工程を頭から始めるとは限らない。手元にあるものを見て入口を選ぶ。