to-questionnaire

ユーザーが一人では答えられないことを質問票に変換します。質問票とは、ユーザーが記入を依頼する人に非同期で渡す、または会議で一緒に記入する Markdown ドキュメントです。受け取る人は、ユーザーに不足している知識を持っています。質問票は、その人から知識を引き出します。

話題ではなく、送付について質問します。 ユーザーには、必ず答えられる「送付」についてだけ尋ねます。つまり、誰に送るのか、何を返してもらう必要があるのかです。ドキュメントの質問では、受け取る人が知っていてユーザーが必要としていることのギャップを狙います。

1. 誰に送りますか？ 1回のやり取りで、受け取る人の役割、専門知識、ユーザーとの関係を尋ねます。これにより、質問票のトーンと、どの程度の背景情報を盛り込む必要があるかが決まります。受取人が誰で、その人がユーザーの知らない何を知っているかが分かったら完了です。

2. 何を返してもらう必要がありますか？ 1回のやり取りで、ユーザーが一人では解決できず、その人に尋ねる必要がある具体的な決定事項や事実を尋ねます。ユーザーが何をできるようになる、あるいは決定できるようになる必要があるのか、具体的なリストができたら完了です。

3. 質問票を作成します。 ステップ1～2で把握したギャップを狙う質問を、以下のドキュメント構成に従って草案にします。現在のディレクトリに to-questionnaire-<slug>.md として保存し、パスを報告します（slug はトピックから作成します）。ステップ2でユーザーが挙げた項目すべてが質問で網羅され、ファイルが存在したら完了です。

ドキュメント構成

ドキュメントはディスカバリー質問票として位置づけます。ユーザーには背景知識がなく、受け取る人はそれを持っています。質問は重要度の高いものから並べます。非同期では質問できる機会が1回だけかもしれないためです。質問がいくつかを超える場合は、テーマごとに ## 見出しを付けてグループ化します。以下のテンプレートを使って作成します。

<質問票のタイトル>

目的： この質問票が必要な理由と、回答に基づいて行う決定。

差出人： <ユーザー> — 宛先： <受け取る人> — 回答の用途： <回答の提出先>

背景

受け取る人に向けた段落です。ユーザーの頭の中にしかない背景を説明します。適切に回答するのに必要な範囲にとどめ、長文にはしません。

回答方法

回答期限と、おおよその所要時間を記載します。部分的な回答や「分かりません」も役に立ちます。確信が持てない点は飛ばさずに、その旨を示すよう伝えます。

<テーマの見出し>

テーマごとに ## セクションを設けます。各セクションでは、質問を重要度の高い順に並べます。質問はそれぞれ1つのアイデアに絞り、複合的な質問にしないでください。各質問の直下には回答用の記入欄を置きます。質問が誤解されるおそれがある場合や、軽く流された回答を招くおそれがある場合に限り、_この質問が重要な理由_の行を加えます。

### システムはリリース時にどれだけの負荷に対応する必要がありますか？

この質問が重要な理由：ピーク時のトラフィックに備えて今すぐリソースを確保するか、後回しにするかが決まります。

ほかに何かありますか？

締めくくりの自由記入欄です。尋ねていないことで、知っておくべきことはありますか？