LaunchRepoほとんどのディレクトリのフォームは、2つの部分に分かれています。一方はプロダクトについて、もう一方はあなたについて書く部分です。メーカーの自己紹介、名前と所属、ローンチボードによっては「なぜこれを作ったのか」というコメントもあります。キットはこの2つを意図的に分けて扱います。プロダクトに関する記述はコピーワークショップで作られ、copy.mdに保存されます。個人に関する記述は、identity.jsonと、キットが「紹介文ブリーフィング（representation briefing）」と呼ぶ短いセッションから生まれます。このセッションの手順はPR-BRIEFING.mdに書かれています。このガイドでは、このセッションが何なのか、なぜ必要なのか、そして最終的にrepresentation.mdに何が残るのかを説明します。
なぜ別のセッションにするのか
product.jsonを埋め終えたばかりのエージェントは、プロダクトのことはよく知っていても、あなたがどう紹介されたいかはほとんど知りません。そのまま任せると、見つけられる情報――以前の勤務先、過去のプロジェクト、GitHubプロフィールに書かれた都市名など――から自己紹介を即興で組み立て、公開のメーカープロフィールに貼り付けてしまいます。そうなると、取り消すのは簡単ではありません。ブリーフィングは、実際に使われる文面をあなたが確認するまで、個人的な情報が一切掲載に出ないようにするためのものです。プロダクトごとに1回、最初の個人情報が公開される前に実施し、その情報が変わるたびにもう一度実施します。
3つの質問
エージェントは平易な言葉で、あなたに直接尋ねます。
- 個人として、会社として、あるいはその両方として紹介しますか？ これによって、フォームの「メーカー」欄にニックネーム、法的な氏名、組織名のどれを入れるかが決まります。
- どのニックネーム、名前、所属を表示してよいですか？
identity.jsonにある情報がすべて、どの掲載にも使ってよいものとは限りません。 - 決して書いてほしくないことは何ですか？ 過去のプロダクト、無関係な勤務先、実際の居住地など、ローンチの投稿に結び付けられたくないことなら何でも構いません。
尋ねられないことにも注目してください。エージェントが勝手に選択肢を作り、その中から選ばせることはありません。制約を集めたうえで、確認済みの事実だけをもとに文章を書きます。
3つの例を、一字一句そのまま提示する
確認済みの事実だけを使って、エージェントは3つの短い文章を下書きし、一字一句そのままの形であなたに見せます。
- ディレクトリのプロフィール用の1行のメーカー紹介文
- ローンチやフォーラムで使う1文の自己紹介。Show HN形式の投稿やローンチボードのコメントの書き出しに使うものです。
- 「なぜこれを作ったのか」を伝える1文のコメント
そのうえで、本当に重要な質問を1つだけします。間違っている点、誇張されている点、抜けている点はありませんか？ 修正はすべて例文そのものに反映され、identity.jsonにひっそりとメモされるだけで終わることはありません。この区別は意図的なものです。データファイルは直したのに古い文面の下書きを残しているエージェントは、その古い文面を使い回してしまうからです。あなたが目にしていないものは、何ひとつ公開されません。
何がどこに保存されるか
承認された例文、あなたの修正、承認日は、プライベートワークスペースのプロダクトフォルダにあるrepresentation.mdに保存されます。それ以降、紹介文や自己紹介が必要なプレイブックの手順はすべて、新しく文章を作るのではなく、このファイルを参照します。このファイルの信頼性は、2つの境界によって保たれています。
- 個人に関する記述が
copy.mdのプロダクトに関する記述に混ざることはなく、その逆もありません。プロダクトコンテキストファイルはプロダクトを、representation.mdはあなたを記述します。 - このファイルはプライベートワークスペースの一部であり、共有の配布用リポジトリに含まれることはありません。また、含まれるのはあなたが公開を承認した事実だけです。非公開のアカウント用メールアドレスや、
identity.jsonで非公開に指定したその他の情報は含まれません。
最初のセッションでの位置付け
ブリーフィングは、エージェント主導のオンボーディングの第3フェーズにあります。identity.jsonを埋めた直後、ディレクトリでのブラウザ作業を始める前です。所要時間は数分です。これを飛ばしてエージェントにその場しのぎで紹介文を書かせると、自分がどう紹介されたのかを知るのは、Product Huntのメーカーページで自分のプロダクトを検索したときになるでしょう。メーカープロフィールをローンチ当日の後ではなく前に準備しておくべき理由は、個人開発者向けのローンチチェックリストで詳しく説明しています。