cw-onboarding

オンボーディング

書き手の声とスタイルを長く維持するためのガイドを、まずは役立つ最小限の内容で作成します。書き始められるよう支援し、執筆前に網羅的なプロフィールを完成させることは求めません。

既存のコンテキストを先に読み込む

../../references/context-contract.md を読みます。質問する前に、現在のワークスペースを調べ、維持管理されているアイデンティティ、声、好み、プロジェクトスタイルに関するファイルを確認します。

• 信頼できるコンテキストがすでにある場合は、その内容を要約し、本当に不足している点だけを尋ねます。
• 書き手に執筆用フォルダーが必要な場合は、作成先を特定し、まず cw-setup-project を実行して、VOICE.md、STYLE.md、examples/、drafts/ がそろうようにします。
• どちらかのガイドの内容が少ない場合や、従来の TASTE.md がない場合でも、自動的に開始してはいけません。
• ローカルでの上書きが必要な場合を除き、全体向けのガイダンスを執筆用フォルダーに重複して記載しないでください。
• 明示的な承認なしに、既存のプロフィールを上書きしてはいけません。

保存先を明確に分ける

それぞれのルールは、対象に応じて振り分けます。

• VOICE.md が答えるのは、文をどのように響かせるかです。構文、語彙、トーンに関する内容をここに記載します。これには、文の運び、リズム、文体の格調、句読点、口癖、文の組み立て方、使いたい表現や避けたい表現が含まれます。

• STYLE.md が答えるのは、記事に何をさせ、何を含め、何を論証させるかです。主張、根拠、記事の構成、内容に関する基準、読者への約束、書き出し、結び、形式、公開に適した状態であるかの基準をここに記載します。

• 任意の AUDIENCE.md が答えるのは、誰に向けて書くのか、何が読者の関心を引く可能性があるかです。読者の状況、既有知識、望み、関心、抵抗感、根拠となる情報をここに記載します。プロジェクトが指定する、維持管理された共通の情報源に従い、ローカルに複製を作成しないでください。

次の分類基準を使います。

• 表現、文の構成、トーンを変えるルールは、VOICE.md に記載します。
• 記事の主張、根拠、構成、公開可能な状態の基準を変えるルールは、STYLE.md に記載します。
• 読者に関する知識は、それを管理する AUDIENCE.md に記載します。読者に対して文章が果たすべき役割は、STYLE.md に記載します。複数の分類にまたがるフィードバックは分けて整理し、複数のガイドに重複して記載しないでください。

執筆用フォルダーの持ち運び可能なコンテキストとして、そこにある VOICE.md と STYLE.md を使います。全体向けの声のガイドがすでに維持管理上の正式な参照先である場合は、それを使います。保存先が明らかでない場合は、それぞれの種類のガイダンスをどこに置くか、ユーザーに伝えてください。

読者コンテキストを作成または更新する

ユーザーが読者の設定や調整を求めた場合は、コンテキスト契約に従って読者情報の参照元を特定します。名前が指定された既存の共通ガイドがあればそれを使い、なければ役立つ場合に限り、確立済みの執筆用フォルダーに AUDIENCE.md を作成します。任意で使えるスターターは、プラグインのルートから見た defaults/project-template/AUDIENCE.md です。読者コンテキストがないことだけを理由に、目の前の執筆作業を止めたり、オンボーディングを自動的に開始したりしてはいけません。

把握できている状況、知識、関心、抵抗感から始めます。重要な不足点だけを尋ねます。読者に関する根拠、ポジショニング、書き手の明示的な意図、編集上の仮説を区別し、情報源、日付、適用範囲を記録します。属性プロフィールを捏造したり、個人的な利害関係を決めつけたり、出版物が意図する読者との関係を、実測された読者の行動として扱ったりしてはいけません。課題に応じて対象読者を絞ることはできますが、共通ガイドを変更する必要はありません。

書き手とエージェントの両方にとって分かりやすいガイドにします。まず読者像を簡潔に描写し、読者が望むこと（求める成果や体験）と、読者がそこに至る助けになりうるもの（ニーズ）を区別して、文章で提供できる内容につなげます。役立つ場合は、ヒーローズジャーニーの可能性も含めます。出発点となる状況、きっかけ、障害、導き、試練、読者が持ち帰るものを示します。読者の根拠に裏付けられていない場合は、編集上のモデルであることを明記します。変化の物語を無理に当てはめたり、段階を埋めるために動機を捏造したりしてはいけません。最後に、情報源と不確実な点をすぐ確認できる形で、作品にガイドを適用する方法を簡潔に記します。

インタビュー

既存のコンテキストで答えが得られないことだけを尋ねます。初回セットアップでは、会話形式の質問を一度に1～3問するか、執筆者に参考になるサンプルを共有してもらいます。確認するとよい点は次のとおりです。

• 構文、語彙選択、トーン、文の組み立て方、リズム、繰り返し現れる文単位の工夫；
• 執筆者が重視する論証の基準や、繰り返し用いる実質的な論の運び；
• 根拠に求める要件、記事の構成、書き出し、結び、公開可能と判断する基準；
• 執筆者が何を誰のために作り、読者にどのような価値を約束するのか；
• 避けるべき口癖、構成上のアンチパターン、AI らしさ；
• プロジェクトに実質的な影響を与えるワークフローの好み。

会話の流れに合わせて尋ね、ユーザーの熱量に応じて進めます。決まった6つの質問をすべてする必要はありません。

手短に初版を作る場合は、各ガイドに重要度の高いルールをいくつか記載し、不明な点は未確定のままにします。執筆者がすぐに取り組みたい作業を持ち込んだ場合は、別途インタビューをするために作業を中断するのではなく、可能な範囲でその作業から調整します。

サンプルから声のプロフィールを調整する

執筆者から新しいサンプル一式を受け取ったときや、VOICE.md の更新を依頼されたときは、成果物を執筆哲学ではなく、文単位の声のスコアにします。

まず、サンプルを比較し、繰り返し見られる文単位の振る舞いを確認します。サンプル一式に繰り返し現れるパターンか、執筆者が明示的に確認したパターンだけを記載します。特定の媒体、依頼、題材に限られるパターンと、幅広く使える声の指針は分けます。

通常、作成する VOICE.md には次の内容を含めます。

• 文単位の全体的な響きを、具体的な文で簡潔に説明する；
• 文のリズムと長さの変化；
• 累積、限定、訂正、展開、断片文など、構文や繰り返し現れる文の展開；
• 避けるべき語句、構文、ありきたりな言い回しを含む、語彙選択と文体の格調；
• 文の響きに影響する場合に限り、句読点、強調、段落単位の質感；
• サンプルで確認できる場合に限り、ユーモア、自己認識、口癖；
• サンプルを模倣せずに、エージェントが下書きを合わせるための実践的な改稿指示。

好奇心、知的な厳密さ、不確実性、視点、読者との関係、論証、根拠、構成、公開基準は、文の語句、構文、リズム、トーンを変える指示でない限り、このプロフィールに含めないでください。記事の基準は STYLE.md またはブリーフに、読者についての長期的な知識は、管理している場合、確定済みの AUDIENCE.md に記載します。

重要な声のルールにはそれぞれ、出典を示す短い引用か、観察された文の工夫についての簡潔な説明を添えます。サンプル全文は examples/ に置きます。公開済みの文章は方向性を示すものであり、再利用できるものではありません。「温かい」「賢い」「本物らしい」といった幅広いラベルは、観察可能な執筆上の振る舞いに置き換えない限り避けます。

プロフィールを作成する

• 具体的で、根拠のある好みだけを記載します。
• 構文、語彙選択、トーンは VOICE.md に、論証、根拠、記事の構成、実質的な基準、公開可能と判断する基準は STYLE.md に記載します。
• 指針は、性格を表す形容詞だけでなく、実行可能なルールとして記述します。
• 実例全文は examples/ に置き、ルールを明確にする場合に限り、短い引用をガイドに使用します。
• 公開済みのサンプルには、方向性を示すものであり、再利用できないことを明記します。
• サンプルに基づいて作成する場合は、文がどのように情報を積み重ね、展開し、限定し、締めくくるか、または不自然に響くかをエージェントに伝え、ルールを実践可能な形にします。
• 執筆者の言い回しをそのまま使ったり、個人的な詳細をでっち上げたりせずに、文単位の響きを保つための簡潔な改稿チェックリストを含めます。
• 適用されるルールで承認が必要な場合、権限の強いファイルや共有ファイルを変更する前に、変更内容の案を提示します。

TASTE.md を移行する

既存の TASTE.md がある場合は、そのルールを必要に応じて VOICE.md、STYLE.md、および承認済みの読者向けガイドに分類します。複数の領域にまたがるルールや矛盾するルールは、判断が必要なものとして明示します。TASTE.md に新しい指針を追加し続けないでください。また、明示的な承認なしに削除しないでください。

引き継ぎ

以下を確認します。

• 依頼時に、音声、スタイル、対象読者に関するコンテキストとして何が記録されたか；
• ガイドと補足例の保存先。共有の対象読者ソースがある場合は、その保存先も確認します；
• 意図的に未解決のまま残されているギャップ；
• 今後のCompound Writingスキルが、どのように執筆ホームを読み込むか。