cw-setup-project

ライティングホームをセットアップする

プラグインから独立して持ち運べる単一のフォルダーを作成します。このフォルダーには、Compound Writing に必要なコンテキストと作業領域が含まれます。

保存先を決める

• ユーザーが指定したパスまたはフォルダー名を使用します。
• 保存先が不明確で、選び方によってライティングホームの作成場所が大きく変わる場合は、パスを尋ねます。
• 書き込む前に、既存のワークスペース指示を読みます。
• インストール済みのプラグイン内やランタイムキャッシュ内には、ライティングホームのファイルを作成しないでください。

ライティングホームを作成する

次の最小構成を正確に作成します。

writing-home/
├── VOICE.md
├── STYLE.md
├── examples/
│   └── README.md
└── drafts/
    └── README.md

この SKILL.md を基準にして同梱の作成スクリプトの場所を解決して実行します。ユーザーの作業ディレクトリがプラグインのルートだとは想定しないでください。

python3 "<plugin-root>/skills/cw-setup-project/scripts/create_project.py" "/path/to/writing-home"

このスクリプトは、defaults/project-template/ にある標準テンプレートをコピーします。新しいフォルダーを作成するか、空のフォルダーに内容を追加できます。デフォルトでは空でないフォルダーの変更を拒否し、ファイルを上書きすることはありません。

既存のフォルダーの場合は、まず内容を確認します。ユーザーが Compound Writing の構成を追加することを明示的に希望している場合は、次を実行します。

python3 "<plugin-root>/skills/cw-setup-project/scripts/create_project.py" "/path/to/writing-home" --add-missing

--add-missing は存在しない項目のみを作成します。既存のファイルや慣例はすべて保持してください。

オプションのオーディエンスガイド

ライターが読者のコンテキストを設定するよう求めており、既に管理されている共有ガイドが指定されていない場合は、作成コマンドに --with-audience を追加します。既存のライティングホームの場合は、内容を確認してから --add-missing と組み合わせて実行します。これにより、既存のファイルを上書きせずに、汎用の AUDIENCE.md テンプレートが追加されます。

共有のオーディエンスガイドが既に作業を規定している場合は、重複して作成するのではなく、プロジェクト指示からそのガイドを参照します。ローカルの AUDIENCE.md は任意です。存在しないという理由だけで追加したり、執筆を中断したりしないでください。../../references/context-contract.md のオーディエンス解決ルールを使用してください。

役割分担を明確にする

• VOICE.md が答えるのは、**「文の響きをどうするか？」**です。文法、語彙、トーンをここに記載します。文の運び、リズム、文体、句読点、口癖も含めます。
• STYLE.md が答えるのは、**「記事で何を行い、何を含め、何を立証すべきか？」**です。論旨、根拠、記事の構成、内容に関する基準、読者への約束、公開可能な状態かどうかの基準をここに記載します。
• 任意の AUDIENCE.md が答えるのは、**「誰に向けて書き、何に関心を持ってもらえるか？」**です。読者の状況、知識、要望、関心、抵抗感と、それらを裏付ける根拠をここにまとめます。名前の付いた共有ガイドがある場合は、それを使用します。
• examples/ には、精選した肯定例と否定例を保存します。例は記述されたルールを裏付ける根拠であり、それ自体がルールではありません。
• drafts/ には、作品ごとに1つのフォルダーを作成します：drafts/<piece-slug>/。その作品のメモ、調査、アウトライン、草稿の各バージョン、レビューをまとめて保存します。

論旨、根拠、構成、公開可能な状態かどうかに関するルールを VOICE.md に記載しないでください。語彙の選択、文の構成、文の運び、トーンに関するルールを STYLE.md に記載しないでください。複数の内容が混在するフィードバックは、個別のルールに分けてください。

セットアップの一環として TASTE.md、context.md、published/、.status.yaml を作成しないでください。

以前のプロジェクトから移行する

TASTE.md がある場合：

1. 既存のプロジェクト指示と合わせて読みます。
2. 文法、語彙、トーンに関するルールは VOICE.md に移します。
3. 論旨、根拠、記事の構成、内容に関する基準、公開可能な状態かどうかに関するルールは STYLE.md に移します。
4. 長期的に有効な読者の知識は、依頼があった場合に管理されている AUDIENCE.md に移します。重複して作成せず、既存の共有ガイドを使用します。内容が混在する指針や矛盾する指針には印を付けます。
5. 曖昧な指針や権威性の高い指針を変更する前に、移行の概要を提示します。
6. ユーザーが削除またはアーカイブを明示的に承認するまで、TASTE.md を保持します。

ガイドを開始する

初回セットアップの後、cw-onboarding を開始してください。ライターは、短い会話、既存の文章、またはすでに進行中の作業をもとに、両方のガイドの有用な初版を作成できます。いずれかのプロフィールの完成を、ライティングホームの利用条件にしないでください。

ユーザーが追加フォルダーに対して手動で cw-setup-project を実行した場合、すぐに新しいプロフィールが必要だと決めつけず、オンボーディングを提案してください。

引き継ぎ

ライティングホームのパス、作成された各項目、任意の読者向けガイドや共有ソース、すでに存在していたためにスキップしたもの、次に役立つステップを報告してください。