prd

prd — 製品の戦略レイヤー

運用担当者にインタビューし、製品の戦略的な定義を作成します。ビジョン、課題、ユーザー、スコープ、競合他社、機会、未解決の質問、用語集をまとめます。これは手法への入り口です。このレイヤーから仕様が生まれます。

常に、読み込まれた製品ノードの context/ に書き込み、ボディリポジトリには書き込みません。 ノードのヘッダーにある repo: で宣言されたリポジトリがボディです。仕様、技術的な決定、実装済みの内容が含まれます。戦略レイヤーはボディではなく、ヘッダーにあります。

インタビューでは、.agents/skills/grill/SKILL.md#method の手法を使って掘り下げます。手法はこの見出しから参照し、複製することはありません。手法を変更する場合は、そこだけで一度変更します。

作成するファイル

読み込まれた製品ノードの context/ に配置します。ノードにまだ context/ がない場合は、まず README.md を作成し、インタビューの進行に合わせて残りのファイルを作成します。

ファイル	答える内容
README.md	インデックス：製品の概要、各ファイルを記入した順序、現在の状態
vision.md	完成したシステムと、目指す到達点
problem.md	解決する課題、対象者、今取り組む理由、成果をどう判断するか
users.md	販売対象と、現在その人たちが代わりに使っているもの
scope.md	対応しないこと、販売対象としない人、厳守すべき制約、初版に含めるもの
competitors.md	競合するものと、その違い
opportunities.md	価値があるかもしれないが、まだ決定していないこと
open-questions.md	決定すべきこと。運用中に決定が済むと内容は減っていき、質問は [!QUESTION] コールアウト内に記載します
glossary.md	ドメインの用語

この一覧にあるファイルをボディリポジトリに書き込むことはありません。セクションを完成させるためにボディリポジトリやリゾルバーに手を加える必要がある場合、このツールは実行しません。その旨を伝えて停止します。これは、このツールを呼び出した仕様で定められた停止条件であり、このセッションでの判断ではありません。

製品ノードがない場合、この8つの汎用ファイル名をセッション開始時のフォルダーにそのまま置くことはありません。ユーザーが既存のファイルを持っている可能性があり、それを上書きしてしまうためです。代わりに、現在のフォルダー内の product-context/ フォルダーに配置します。具体的には、product-context/vision.md、product-context/problem.md、product-context/users.md、product-context/scope.md、product-context/competitors.md、product-context/opportunities.md、product-context/open-questions.md、product-context/glossary.md です。製品ノードが読み込まれている場合は、前述のとおり保存先は変わらず context/ です。

KPI ツリーはここには含めません。別のツールが作成するメトリクスブリーフに属するものです。このスキルは、KPI ツリーがすでに存在する場合に参照しますが、作成はしません。

フェーズ 1 — 質問する前に、ブレインがすでに把握している内容を読む

最初の質問をする前に、次のことを行います。

1. 読み込まれている製品ノードと、その context/ を特定します。context/ がない場合は、このインタビューで作成します。
2. context/ にすでにあるファイルをすべて読みます。これは段階的に進めます。記入済みのセクションを上書きする場合は、必ず事前に伝えます。
3. 管理組織のコンテキストを読み、該当する日付付きの調査があれば、それも読みます。調査はノードの context/ と並ぶ research/ にあります。
4. 読んだ内容と、それをもとにすでに自分で埋められるセクションを運用担当者に伝えます。それから初めてインタビューを開始し、不足している部分だけを確認します。すでにシステムに書かれている内容を質問してはいけません。

フェーズ 2 — インタビュー

質問は .agents/skills/grill/SKILL.md#method の定義に従ってラウンドごとに行い、各質問に、そのセクションがなぜ判断を変えるのかを説明する一文を添えます。その一文がなければ、質問は事務的に聞こえてしまいます。

真実を引き出す6つの質問

ソリューションに触れる前に、機会と事業の段階について確認します。

1. 誰かがこれを求めていることを示す、最も確かな証拠は何ですか？関心ではなく、行動です。
2. 今は何を使って解決していますか？「何も使っていない」という答えなら、これがなくてもなぜ問題なく過ごせているのですか？
3. 具体的な人物を挙げてください。職種と、解決できなかった場合にその人に何が起きるかを教えてください。
4. 今週、誰かがお金を払ってくれる最小のバージョンはどんなものですか？
5. 誰かが使う様子や、解決しようとする様子を見て、何に驚きましたか？
6. 3年後、これは今より必要になりますか、それとも必要性が下がりますか？

リサーチ段階

結論をでっち上げることはありません。リサーチが行われていない場合はその旨を伝え、該当するディスカバリーツールを提示します。質問では、セグメント、明確な対象外、そして担当者が現在すでに使っている代替手段を確認します。

ソリューション段階

何を作るかを話す前に、前提を問い直します。これは適切な問題でしょうか？何もしなかったらどうなりますか？すでに作られていて、代わりに使えるものはありませんか？それを確認してから、ビジョン、スコープの切り分け、再検討の条件を含む「対応しないこと」、厳守すべき制約、無効になる条件を含む前提を扱います。

どうやって問いを深めるか

.agents/skills/grill/SKILL.md#method の手法によって、いつ反問するか、何回やり取りするか、2回目の抵抗にどう対処するかを決めます。ここでは繰り返しません。実際に適用します。

代替案のフェーズ（必須）

ソリューションを決める前に、取り組みに必要な労力、リスク、既存のものを何に再利用するかを添えて、2つまたは3つの道筋を提示します。

• 今週リリースできる最小のもの — 今週リリースできる最小のバージョン。
• 最も長く使えるもの — プロダクトが成長した場合に、最も手戻りが少なくて済むもの。
• 問題を捉え直す、別の切り口 — 「同じものを、もっと小さく」ではない解決策。

担当者が1つを選びます。このフェーズがなければ、文書に記録されるのは最初のアイデアであり、最善のアイデアではありません。

ギャップを明示するルール

ギャップを記載するのは、担当者が明確に回答しないと決めた場合に限ります。また、そのギャップを誰が埋めるのかを必ず記載します。ギャップだらけのファイルは成果物ではありません。完全に見せかけただけの失敗です。セクションについて質問していないために生じたものは、ギャップではありません。未完了の作業なので、インタビューを再開します。

書く前に見せる

ファイルに触れる前に、これから書く内容を要約ではなくそのまま担当者に見せ、承認を待ちます。書き込むのはインタビューで扱ったファイルだけです。すでに完成しているファイルは上書きしません。担当者がやり取りの中で「はい」と受け入れた用語集の項目は、正確な文面をすでに提示済みです。手法に従ってその時点で書き込み、再度は提示しません。

最終判定

最後に、次のいずれかを必ず明示します。

• 完了 — 仕様を書くのに十分な情報があります。
• 留保付きで完了 — 先に進めます。未解決の質問は以下のとおりです。
• コンテキスト不足 — 未完了のまま残ったファイルと、完了に必要なことを示します。

最低要件のゲート：glossary.md、scope.md、または本文のアーキテクチャが空のままであれば、仕様はまだ作成しません。その旨を明示し、後から気づかれるままにはしません。

保存先

このスキルは、成果物を作成する前に保存先を解決します。作成後に解決することはありません。ケースは3つ、保存先は2つです。

• プロダクトノードが読み込まれている場合：成果物は、そのノードの research/<YYYY-MM-DD>-<name>.md に保存されます。
• brain はあるものの、プロダクトノードがない場合 — まだワークスペースがないか、ワークスペースにプロダクトノードがない場合：成果物は現在のフォルダー内のファイルに書き込まれます。
• brain がまったくない場合：成果物は現在のフォルダー内のファイルに書き込まれます。

プロダクトノードがない場合は、いずれにしてもファイルは現在のフォルダーに書き込まれます。完了時のメッセージでは、書き込んだパスだけを示して終了します。これがこのスキルの通常の終了方法であり、例外として注釈を付けるものではありません。

このスキルは、どの保存先を使うか尋ねることはなく、3つ目の保存先を勝手に作ることもありません。

残りのパックは、スキルを1つずつインストールします。まず .agents/skills/、次に .claude/skills/ を確認し（両方にあるスキルは1つとして数えます）、まだないものだけを提示してください — セッションごとに1回だけです。このスキルがセッション中に初めて終了するときに限り、その後、同じ成果物や別の成果物で終了するときに再度提示することはありません。

• grill — npx skills add pedroromeroluna/ai-first-product-skills --skill grill

パック全体を一度にインストールするには：npx skills add pedroromeroluna/ai-first-product-skills。このコマンドは、パックが提供するものをインストールします。上記に記載されているものは、名前を指定してインストールします。