AIと開発する軸足を、README・Project Poster・PRFAQでつくる

README・Project Poster・PRFAQの三枚を、修理対応の記録と並べる。

「装置が起動しない。ケーブルをつなぎ直した」。修理を引き継いでこの記録が見つかっても、直ったかどうかは分かりません。検索を先につくるか。記録に必要な項目を先に試すか。架空の修理アプリで、次にAIへ何を任せるかを考えます。

私は、新しい開発や大きな方向転換で、README・Project Poster・PRFAQを使っています。今できること、育てる目的、利用者が得る体験。この三つを読み合わせると、いま試せる仕事と、先に人と決めることが見えてきます。

三資料で、判断へ戻る場所をつくる

三つとも既存の文書です。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には、三資料と今回の目的から、進め方を組み立てさせます。

先に照合する:READMEの現在地と実装を確かめ、四項目を表示するのに利用できる部分を探す。入力・保存の仕組みは今回の試作で変えない。

比較する材料をつくる:症状と試した対応を揃え、結果だけが「変化なし」と「未記録」で異なる架空データ二件を用意する。同じ対応をした後でも、分かっていることが違うと読み取れるかを試す。

表示して確かめる:対応と結果を分け、未記録を空欄にせず示す。まず元データと表示を照合し、次に依頼者が二件を読み比べられる画面と確認箇所を返す。

この進め方では、見た目を整える前に、目的に関わる違いを比較材料へ落としています。Posterの「次に確認することを選べる」から試す問いを選び、PRFAQの利用場面から読む情報を選び、READMEから変更の出発点を確かめる。AIが決めるのは、配置や余白に加えて、作業の順序と確認の重点です。

「結果:変化なし」は確認した結果、「結果:未記録」は情報の不足です。この違いが消える表示なら、見た目が整っていても今回の目的を満たしません。AIはここを自分で照合し、直してから返せます。

一方、調べると入力項目の変更まで必要だと分かった場合は、画面試作の範囲が変わります。必要な変更と理由、表示だけで試す代案を示して相談します。任された目的に沿って仕事を進め、範囲を変える判断を人へ返す。 この境目を共有して、自律させます。

実行の許可は、今回の依頼と実行環境の権限で扱います。PRFAQに未来の機能を書いても、その実装や公開を任せたことにはなりません。

異なる案を、三資料に戻って比べる

協働では、同じ資料を読んでも提案が分かれます。ここでは今回の表示試作を進めながら、その次に入力方法も変えるべきか検討する場面を考えます。

利用場面を考えるAIの案:今後の記録では、結果を必須入力にしたい。対応と結果を分けて残せれば、次の担当者が読み取る材料を揃えられる。

実装と運用を考えるAIの案:現在の自由記述を残したい。入力欄を増やすと手間も増える。既存の記録も、結果が揃っているとは限らない。

どちらにも検討する理由があります。両案が目的のどこに応え、何をまだ確かめていないかを、三資料と照合します。

Posterが求めているのは、次の確認を選べることです。結果の必須入力は、そのための手段の一つ。PRFAQには「対応後に続きを残す」場面がありますが、入力にかけられる手間はまだ具体化されていません。READMEを見ると、現在の出発点は自由記述です。既存の記録まで新しい項目へ移せるとは決まっていません。

この照合から、統合する担当は次の案にまとめられます。

今回の表示試作は、そのまま進めます。入力を必須にする判断は分けましょう。

次は、現在の自由記述と、結果欄を必須にした入力案を小さく比較することを提案します。「読む人が結果を把握できるか」に加え、「書く人が対応後に記録を残せるか」も確かめたい。過去の記録の一括変更は含めません。

入力する人の作業条件を確認し、PRFAQの入力場面を具体化してから、次の試作を任せる範囲を決めましょう。

一方の案を捨てず、読む人に必要な情報と、書く人の負担を同じ検討に残しています。どの案がよいかを決めるために、何が足りないかも明確になります。三資料は結論を自動で出すものではありません。異なる提案の根拠を並べ、採用するか、確かめるかを判断する共通の参照先にします。

別のAIへは、今回の仕事も渡す

実装担当が替わる時は、READMEから採用版のPosterとPRFAQを辿れるようにし、今回の仕事を添えます。

READMEで起動方法と現在の実装を確認し、Posterの目的とPRFAQの将来像を読んでください。

今回は、架空データ二件の画面試作です。「変化なし」と「未記録」を区別し、四項目を追える表示にしてください。共有・検索は今回の範囲に含みません。

完了時は、試せる画面、元データと表示を照合した結果、残った未決を返してください。必要な情報が足りず、表示の意味が変わる場合は、該当箇所と案を示して相談してください。

三資料を併せるのは、実装中に新しい選択が出たとき、その理由へ戻れるようにするためです。なぜ未記録を区別するのか、なぜ検索は今回はつくらないのか。参照した資料と判断の根拠も返させ、今回の仕事との対応を確かめます。

できたものと、残った問いを資料へ戻す

試作後は、変わった箇所へ結果を戻します。

READMEには、試作で新しく表示できる内容と確認手順を書く。入力欄を変えていないなら、「結果を分けて入力できるようになった」とは書かない。画面を表示できたことと、引継ぎに使えたことも区別します。

Posterには、確かめた結果と次の問いを残します。依頼者による読取確認をまだしていなければ、「画面試作は完了、引継ぎに足りるかは未確認」。もし二件を読み分けられても、実際の引継ぎで十分かは次の検証です。

PRFAQは、目指す仕事や実現条件に変更があれば更新します。今回なら、「未記録の過去記録を読んだ人が、何を確認し直すか判断する」という扱いをFAQへ反映できます。画面試作だけで、チーム共有を提供済みに変えることはありません。

資料同士で同じ事実が食い違ったら、コード、画面、決定記録へ戻って確かめ、正本を直します。更新日が新しいという理由だけで、未来の記述を現在の実装より優先しません。

自分の開発では、今ある依頼を一つ照合する

最初から立派な三冊をつくる必要はありません。新規開発や大きな方向転換で、目的と検証、目指す利用体験、現在地を早期に置く。既に同じ役割を果たす企画書や設計資料があれば、それを使います。小さな修正は、影響する資料だけ更新します。

自分の案件に当てるなら、今AIへ任せようとしている依頼を一つ選び、まずこう頼めます。

この依頼について、目的と検証事項はPoster、目指す利用場面と実現条件はPRFAQ、現在できることはREADMEと照合してください。同等の既存資料があれば使ってください。

資料に書かれた事実と、あなたの提案を区別してください。足りない情報は、次の仕事の何を変えるのかを示し、自分で確認できることは確認してください。その上で、今任せられる一仕事と、先に人と決めることを提案してください。

提案を受けたら、「何をつくるか」と「何で確かめるか」がつながるかを見ます。つながらないなら、要求を具体化する仕事や小さな検証を先に選ぶ。今回の修理メモなら、共有・検索の完成を待たず、記録の内容を試すところまで進めます。

一つの短い依頼書で目的・現在地・判断条件を共有できる小変更なら、その一枚で足ります。三資料を分けて持つ利点が大きくなるのは、未来の構想と現在の実装が並行して変わり、複数の仕事やAIが同じ目的を参照する開発です。書類の数を増やすことを目標にしません。

私は、この運用を採用しています。確認の往復や手戻りがどれだけ減るかは、今後の開発で確かめます。

AIへ次の一仕事を任せるとき、目的、未来、現在地を照合し、進める根拠と残る未決を共有する。この判断に三資料を使います。

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA