私は、新しいアプリの開発と大きな方向転換で、README・Project Poster・PRFAQを基本資料として採用しています。 AIが目的から仕事を組み立て、人は必要な判断に関わる。その進め方を支えるためです。
三資料には、「何のために育てるか」「利用者の仕事をどう変えるか」「現在どこまでできているか」を残します。AIへ仕事を渡すときも、途中で別のAIに引き継ぐときも、そこへ戻って判断します。
特に使うのが、要求が、次の一仕事を任せられるところまで固まっているかを見る中間ポイントです。資料を読み合わせれば、全てを決め終えなくても、今つくれるものと、先に確かめることを分けられます。
たとえば「担当者が替わっても、前回の続きから修理対応できるアプリにしたい」。この依頼から、共有機能の実装へ進むのか、記録の項目を見直すのか。何を根拠に選ぶのか。ここを一つの例で掘り下げます。
三資料で、判断へ戻る場所をつくる
三つとも既存の文書です。Project Posterは、問題の理解から検証、つくる範囲へ考えを進めるために使えます。Atlassianの公式ガイドも、一度完成させてしまう計画書ではなく、学んだことを反映する文書として扱っています。
PRFAQは、プレスリリースとFAQを組み合わせ、利用者の体験から実現条件を考える文書です。PRはプレスリリースの略。Amazonが掲載した解説では、PRで顧客体験を示し、FAQで詳細や実現の難しさ、費用も検討します。
これらとREADMEを組み合わせる運用を、私たちの開発標準にしています。この三点セットが業界共通の必須規格という意味ではありません。
| 資料 | AIとの開発で、まず答える問い |
|---|---|
| Project Poster | 誰のどんな問題を解くのか。根拠と仮説は何か。次に何を確かめるか |
| PRFAQ | 実現したら、利用者の仕事はどう変わるか。利用・導入・運用の難しい問いに答えられるか |
| README | 今、何が使えるか。どう起動・確認するか。制約と、詳しい資料への入口はどこか |
この役割分担で、目指す未来と現在の実装、その間にある未決を照合します。文書ごとに同じ仕様を重ねて管理せず、READMEから各正本へリンクします。
「前回の続きから対応したい」を、三資料に置いてみる
題材は、架空のアプリ「修理メモ」です。以下の依頼、資料、やり取りは説明用の合成例です。実際の利用者の発言や、AIを動かして得た結果ではありません。
現在は、一人で修理記録を入力し、一覧から開ける試作がある設定です。依頼者は、次の方向へ育てたいと考えています。
担当者が替わっても、前回の続きから修理対応できるようにしたい。共有と検索も付けたい。
共有と検索には意味があります。ただ、この段階では、どちらから実装すれば「続きから対応できる」に近づくかは決まりません。AIには、既存資料から分かることを拾い、分からないことを埋めずに初案をつくらせます。
以下は、判断に関わる部分を抜き出した記入例です。PosterやPRFAQの全項目を備えたテンプレートではありません。
Project Poster:目的と、まだ確かめていないこと
対象と目的:次に修理を受け持つ担当者が、前任者の試した対応と、その結果、未解決の点を把握し、次に確認することを選べるようにする。
仮説:記録へ辿り着ければ、前任者への聞き直しを減らせる。共有と検索は、そのための候補。
未確認:現在の記録に、判断に必要な内容が残っているか。探せないことと、見つけても内容が足りないことの、どちらが先に支障になるか。
PRFAQ:未来の場面と、答えが必要な問い
将来像・未提供:修理の連絡を受けた担当者が前回の記録を開き、症状、試した対応、結果、未解決の点を読む。そこから次の確認を選び、対応後に続きを残す。
Q. 記録が見つかれば、そのまま続きを始められる?
結果や未解決の点が残っている必要がある。何を必須にするか、未記録の情報をどう扱うかは未決。
Q. 誰が、どこまで読み書きできる?
共有する相手と権限は未決。保存先、運用担当、費用も、共有を導入する前に決める。
README:現在できることと、確かめる入口
現在できること:一人で「症状」「対応メモ」を入力し、一覧から開く。
未提供:チーム共有、過去記録の検索。
確認方法:ローカルで起動し、架空データを使って入力・再表示を確認する。起動手順とデータの場所へリンクする。
未確認:「対応メモ」の自由記述だけで、対応と結果を区別して読めるか。
実際の案件では、READMEにある起動手順が通るか、コードや画面が記述と合うかも確認します。文書に「できる」とあることと、動作を確認できたことは分けます。この合成例には実行用のプログラムは付けていません。
読み合わせると、先に埋める穴が見える
この三資料を、同じ一件に当ててみます。現在の「対応メモ」が、次の記録だったらどうでしょう。
症状:装置が起動しない。
対応メモ:ケーブルをつなぎ直した。
何を試したかは分かります。しかし、つなぎ直して起動したのか、変化がなかったのかは分かりません。検索でこの記録を見つけても、同じ対応をもう一度試すべきか判断する材料が欠けています。
ここで三資料の照合が働きます。
| 資料を照合して分かること | 次の仕事への影響 |
|---|---|
| Posterは「次の確認を選べる」を目的にしているが、READMEの現在の記録には結果が保証されていない | 共有・検索に加え、記録内容を確かめる候補が必要になる |
| PRFAQの未来には「結果を読む」があるが、結果が未記録の場合の扱いは未決 | AIが結果を推測して埋めず、未記録をどう見せるか決める |
| 共有相手と読み書きの権限が未決 | チーム共有の実装を、そのまま完成まで任せるには不足がある |
これで「検索を先につくるのは誤り」とまでは言えません。実際には、記録の内容が十分でも、件数が多くて探せないことが最大の問題かもしれない。今分かったのは、共有と検索だけで目的を満たすという前提が、まだ確かめられていないことです。
AIが立ち止まるべきなのは、この前提です。文書をきれいに埋めるより、次の判断に関わる穴を出すことに意味があります。
要求の中間ポイントで、次の一仕事を決める
ここから、AIは何でも質問に戻せばよいわけではありません。コードから確認できる現在の項目や保存方式は自分で調べる。利用者が何を優先するか、どこまで任せるかは、判断材料を添えて人に尋ねます。
たとえば、次のように相談します。
現在のメモには、対応後の結果が残らない場合があります。共有・検索を実装する前に、一件を読んで続きが分かるかを確かめる案を勧めます。
今回優先したいのは、既に十分な記録を探せることですか。それとも、引継ぎに必要な内容を揃えることですか。
内容を確かめるなら、まず架空データによる画面試作まで進めてよいですか。過去の記録で結果が抜けている場合は「未記録」と表示し、推測では埋めない案です。
この例の依頼者は、こう答える設定にします。
まず、内容が引き継げるかを見たい。「症状」「試した対応」「結果」「未解決の点」を分けた画面を、架空データでつくって。結果がないものは「未記録」でよい。共有と検索は次に検討する。
この返答によって、優先する問い、試す情報、欠けた情報の扱い、今回の範囲が決まりました。次に、確認の仕方まで具体化します。
今回任せる仕事:ローカルの画面試作。結果が記録された一件と、結果が未記録の一件を表示する。
表示する情報:症状、試した対応、結果、未解決の点。結果を「変化なし」と記録したものと、結果そのものが分からないものを区別する。
試作の確認:二件とも元の情報と照合でき、未記録の結果を補作していないこと。既存の入力・再表示を壊していないこと。
その次の確認:依頼者が二件を読み、何を試し、何が分かっていないかを説明し、次に確認する点、または判断に足りない情報を挙げられるかを見る。合成データでの読取確認であり、実際の引継ぎに足りるかは別に確かめる。
今回に含めないこと:共有・検索の実装、実データの使用、外部サービスへの接続と公開。
ここまで揃えば、この画面試作は任せられます。何をつくるか、なぜつくるか、何と照合するかが定まり、残る未決が今回の試作を妨げないからです。
一方、チームに提供する共有機能の実装は、まだ完成まで任せられません。共有相手や権限が違えば、データ設計や操作画面も変わります。こちらの次の仕事は、実装より先に、利用場面と読み書きの範囲を決めることです。
「要求が固まった」は、プロジェクト全体に一度だけ押す完了印ではありません。任せる一仕事に対して、その判断を左右する未決が残っていないかを見る。 画面試作には十分でも、チームへの提供には足りない。同じ資料から、この違いを判断します。
AIが自分で決めること、人へ戻すこと
範囲が決まったら、AIにはその中で仕事を組み立てさせます。今回なら、四項目の配置、見出し、余白、未記録の表示方法を、目的に沿って提案・実装できます。
たとえば「結果:変化なし」と「結果:未記録」を、どちらも空欄にしてはいけません。前者は確認した結果、後者は情報の不足です。次の担当者の判断が変わるので、見分けられる表示にする。この根拠は、Posterの目的とPRFAQの利用場面にあります。
反対に、未記録をなくすため、全ての過去記録にAIが結果を補う機能まで加えるのは範囲を変えます。これからの入力で結果を必須にするかどうかも、入力する人の負担や運用に関わるため、別に判断します。
自律させたいのは、目的と任された範囲に沿った工夫です。人への相談も、「どうしますか」と丸投げするのでなく、「どの未決が、どの選択を変えるのか」を示します。
三資料は、その判断の根拠を共有するものです。実行の許可は、今回の依頼と実行環境の権限で扱います。PRFAQに未来の機能を書いても、その実装や公開を任せたことにはなりません。
別のAIには、三資料と「今回の仕事」を渡す
引継ぎでも、同じ軸足を使います。実装担当へは、READMEから採用版のPosterとPRFAQを辿れるようにし、今回の仕事を添えます。
READMEで起動方法と現在の実装を確認し、Posterの目的とPRFAQの将来像を読んでください。
今回は、架空データ二件の画面試作です。「変化なし」と「未記録」を区別し、四項目を追える表示にしてください。共有・検索は今回の範囲に含みません。
完了時は、試せる画面、元データと表示を照合した結果、残った未決を返してください。必要な情報が足りず、表示の意味が変わる場合は、該当箇所と案を示して相談してください。
この依頼だけでも直近の作業は伝わります。三資料を併せるのは、実装中に新しい選択が出たとき、その理由へ戻れるようにするためです。なぜ未記録を区別するのか、検索が必要なのになぜ今回はつくらないのかを、チャットの結論だけから推測させずに済みます。
どのAIに渡しても同じ判断になる保証はありません。実際に採用版を読んだか、目的との対応を説明できるか、成果が依頼に合うかは確認します。資料へのリンクを渡したことだけで、共有できたとは扱いません。
できたものと、残った問いを資料へ戻す
試作後は、変わった箇所へ結果を戻します。
READMEには、試作で新しく表示できる内容と確認手順を書く。入力欄を変えていないなら、「結果を分けて入力できるようになった」とは書かない。画面を表示できたことと、引継ぎに使えたことも区別します。
Posterには、確かめた結果と次の問いを残します。依頼者による読取確認をまだしていなければ、「画面試作は完了、引継ぎに足りるかは未確認」。もし二件を読み分けられても、実際の引継ぎで十分かは次の検証です。
PRFAQは、目指す仕事や実現条件に変更があれば更新します。今回なら、「未記録の過去記録を読んだ人が、何を確認し直すか判断する」という扱いをFAQへ反映できます。画面試作だけで、チーム共有を提供済みに変えることはありません。
資料同士で同じ事実が食い違ったら、コード、画面、決定記録へ戻って確かめ、正本を直します。更新日が新しいという理由だけで、未来の記述を現在の実装より優先しません。
自分の開発では、今ある依頼を一つ照合する
最初から立派な三冊をつくる必要はありません。新規開発や大きな方向転換で、目的と検証、目指す利用体験、現在地を早期に置く。既に同じ役割を果たす企画書や設計資料があれば、それを使います。小さな修正は、影響する資料だけ更新します。
自分の案件に当てるなら、今AIへ任せようとしている依頼を一つ選び、まずこう頼めます。
この依頼について、目的と検証事項はPoster、目指す利用場面と実現条件はPRFAQ、現在できることはREADMEと照合してください。同等の既存資料があれば使ってください。
資料に書かれた事実と、あなたの提案を区別してください。足りない情報は、次の仕事の何を変えるのかを示し、自分で確認できることは確認してください。その上で、今任せられる一仕事と、先に人と決めることを提案してください。
提案を受けたら、「何をつくるか」と「何で確かめるか」がつながるかを見ます。つながらないなら、要求を具体化する仕事や小さな検証を先に選ぶ。今回の修理メモなら、共有・検索の完成を待たず、記録の内容を試すところまで進めます。
一つの短い依頼書で目的・現在地・判断条件を共有できる小変更なら、その一枚で足ります。三資料を分けて持つ利点が大きくなるのは、未来の構想と現在の実装が並行して変わり、複数の仕事やAIが同じ目的を参照する開発です。書類の数を増やすことを目標にしません。
私は、この運用を採用しています。確認の往復や手戻りがどれだけ減るかは、今後の開発で確かめる対象です。採用した事実と、効果を実証したかどうかは分けます。
AIへ次の一仕事を任せるとき、目的、未来、現在地を照合し、進める根拠と残る未決を共有する。この判断に三資料を使います。