claat 手順書ライター

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

全体の流れ

1. 素材を読む — 何が事実として言えるかを確定する
2. 読者と到達点を決める
3. 手順に割る
4. 書く（コードと画像はここで根拠つきで置く）
5. 日本語チェック（natural-japanese）→ 直す
6. claat lint を通す → ユーザーに渡す

5 と 6 を飛ばして渡さない。日本語を直すと行がずれて画像パスや Duration の位置が壊れることがあるので、必ず 5 の後に 6 を回す。

1. 素材を読む

対象ディレクトリや資料が示されていなければ、先に聞く。示されたら README、エントリポイント、設定ファイル、既存ドキュメント、Taskfile や package.json のようなタスク定義を優先して読む。

ここで決めるのは一つだけ。この手順書に書いてよい事実は何か。