TL;DR
- AI コーディングエージェントとの作業は、渡すプロンプトや文脈（地図）と、作業の本当の制約（土地）のずれを埋めることである。そのずれは「未知」でできている。
- Claude Fable では出力の質が主にユーザが未知をどれだけ明らかにできるかで決まるので、実装の前・中・後に、安い方法で早く未知を見つける。
内容
未知を知る
著者は未知を 4 種類に分ける。プロンプトに書くこと（既知の既知）、自覚している穴（既知の未知）、見れば分かるが書き出さない基準（未知の既知）、考えてもいないこと（未知の未知）である。エージェントを使いこなす人は未知が少ないが、それでも残った未知に備えている。未知を減らすことは身に付けられる技術である。
Claude に手伝わせる
指示を細かく書きすぎると、ほかによい方法があっても Claude は指示に従う。書かなすぎると、状況に合わない一般的なベストプラクティスに頼る。Claude はコードベースや Web を調べて未知を素早く見つけられるので、出発点、経験、考えていることを伝えると、考えを深める相手になる。
実装の前
- 盲点の洗い出し: 慣れないコードや分野では、Claude に未知の未知を挙げてもらう
- ブレインストーミングとプロトタイプ: コードをつなぐ前に、簡単なモックや複数のデザイン案で未知の既知を引き出す
- インタビュー: 曖昧な点について Claude に質問させる。アーキテクチャを変える質問を優先する
- 参考実装: 別の言語でも既存のソースコードを示すと、言葉やスクリーンショットより正確に振る舞いを伝えられる
- 実装計画: データモデル、型のインターフェース、ユーザの操作の流れなど、変わりやすい判断を先に、機械的な作業を後に書く
実装の間
計画の成果物を持って新しいセッションを始める。計画からずれた点はメモに残させ、想定外のケースでは保守的な選択をさせる。次の試行がそのメモから学べる。
実装の後
プロトタイプ、仕様、メモを、レビュアーが未知とその扱いを理解できる文書にまとめると、承認が早くなる。長いセッションの後は、Claude に変更のレポートとクイズを作らせ、著者はクイズに合格してからマージする。
実例と結論
著者は Fable の発表動画を、慣れない分野ながら Claude Code で編集した。知っていること（コードによる編集と文字起こし）から始め、プロトタイプで実現できるかを確かめた。良いカラーグレーディングが分からないときは、Claude に教わって目標を決めた。
長いタスクの結果が間違っていたら、多くの場合、未知を明らかにすることや、途中で方針を変えられる計画に時間をかければ直る。著者は説明資料、ブレインストーミング、インタビュー、プロトタイプ、参考実装を次のように呼ぶ。
a cheap way to find out what you didn’t know before it gets expensive to fix
キーワード
- 未知の未知
- Claude Code
- プロトタイプ