要件を言葉にしよう

曖昧な依頼は、出来上がりを運任せにする

依頼の内容を言葉にしないまま進めると、出来上がりは依頼者の意図からずれます。

なぜそうなるかというと、依頼を受けた側は、書かれていない部分を自分の判断で埋めるからです。判断の基準は依頼者の頭の中にしかありません。受け手がAIであっても、この構造は変わりません。

例えば「問い合わせの記録を管理するツールを作ってほしい」という依頼だけを渡すと、受け手は入力項目や保存形式を好きに決めます。結果は依頼者の想定と違う姿になりがちです。

言葉にした分だけ、受け手が埋める余地が減ります。 余地が減れば、ずれも減ります。

自分がいま頼みたいものについて、まだ言葉にしていない部分がどこにあるか考えてみてください。

要件メモに書く4点を決める

要件メモには、目的・使う人・いまの困りごと・完成の基準の4点を書きます。

この4点が揃えば、受け手は判断に迷う場面が少なくなります。反対に1点でも抜けると、その部分は受け手の判断に任されます。

完成の基準は「見て分かる状態」で書く

完成の基準は、誰が見ても同じ判定になる形で書きます。

「使いやすくしたい」のような基準は、人によって判定が割れます。見て分かる基準なら、依頼者と受け手のどちらが見ても同じ結論になります。

基準を見て分かる形にすると、完成したかどうかを自分だけで判定できます。 受け手に確認を頼む必要がなくなります。

自分が書いた完成の基準を、この表の右側のような形に書き直してみてください。

本モジュールでは Claude Codeを使う

ここまでの考え方を、実際の仕組みに当てはめます。本モジュールでは、Claude Codeを使います。

Claude Codeは、コードを読み書きし、コマンドを実行できるエージェント型のツールです。要件を自分だけで言葉にしきれない場合、Claude Code側から質問を返してもらい、答えながら整理する使い方があります。

ツールが変わっても、4点の中身は残ります。 聞き取りの形式が変わるだけで、答えるべき内容は同じです。

次のレッスンでは、この要件メモを「画面」と「データ」の2つの形に分けます。