PWSクライアント書類生成スキル は何をしますか?
これはビルダーディレクターのオンボーディング書類作成プロセスです。スコープが決定したエンゲージメントを、署名可能でブランド化された文書に変換します。PWSマスターテンプレートを使用し、自分への指示が書かれたテンプレートではありません。このプロセスは、クライアント自身のプロジェクト(一般的なPWSプロジェクトではなく)で、実際のスコープ、価格、メモが手元にある状態で書類を作成する際に使用します。
トリガー
- 新しいクライアントがサービス契約の準備ができている(1回限りまたは定期契約のいずれかのエンゲージメント)。
- 既存のクライアントが、既に署名済みの契約とは別の、新しく明確なビルド(新しいSOW)を開始する。
- クライアントのエンゲージメントに、対応するクライアント同意・アクセス許可書(PWSがクライアントのアカウント/ファイル/システムにアクセスする必要がある場合)が必要である。
中核となる判断基準(何かを書き始める前にこれらを決定し、決して推測しないこと)
- 1つのビルドに1つの契約書。巨大な1つの契約書にはしない。 同じようなタイムラインでスコープ/納品が行われる場合のみ、複数の成果物を1つの契約書にまとめる。タイムラインや準備状況が異なる場合は、個別の契約書に分割する。1つの契約書の「完了時に80%支払い」という条件は、そのExhibit A内のすべての項目がほぼ同時期に完了する場合にのみ機能する。それぞれの独立した契約書には、契約書上部の入力可能フィールドを使用して、独自の「フェーズ」(フェーズ1、フェーズ2...)というラベルを付けることができる。理想的にはクライアント自身が指定した優先順位に従う。これは、完全で個別に価格設定された文書に対するラベルであり、1つの文書のスコープを価格設定された部分と未定の保留部分に分割する方法ではない。
- 支払い構造: 1回限りの作業は定額料金で、署名時に20%、完了時に80%が支払われる。「料金と支払い」セクションには、独自の金額は印刷されない。代わりに、Exhibit Aの「Total Initial Build Price」を唯一の情報源として参照する(「Scope of Workの総額はExhibit Aに記載されたTotal Initial Build Priceです」)。定期/リテーナー作業は、この20/80の分割に組み込まれてはならない。独自の「定期サービス、自動支払い、および解約」セクションに、自動支払いの承認と30日間の書面による解約通知(毎月請求)を含めて記載する。
- 割引計算を印刷しない。 標準料金との比較、「X%お得」、「初めてのお客様料金」などの表現を文書自体に含めない。マルコスは割引を提示する際に口頭で伝える。文書は単に料金を記載する。導入事例/再販権の要請(使用する場合)は、割引との交換条件としてではなく、独立した条項として扱う。
- 数値を捏造しない。 料金、目標日、月間包含時間、応答時間 — マルコスが実際の数値を提示していない場合は、空白のフィルラインとして残し、決して推測しない。クライアント自身のメールやメモから実際のスコープ文言を引用する。元の情報にアクセスできる場合は、記憶に基づいて言い換えない(Gmail/Notionで確認すること)。
- リテーナー契約の内容(該当する場合): 含まれるもの(監視、接続プラットフォームの変更による障害の修正、月間作業時間/調整の上限)、応答時間の約束、自動支払いの承認、および30日間の解約通知。マルコスに提案するための開始価格の目安(印刷用ではない):監視のみで月額約$150~$250、リードジェネレーションチャネル調整などのアクティブな作業が含まれる場合は月額最大$350~$500 — 常に、クライアントが既に示している価格感度のシグナルを大きく下回る価格であること。
ビルドプロセス
- 実際の入力を収集する。 クライアントの法的名称/商号、発効日(または空白)、実際のスコープ項目(クライアントのメール/メモから引用し、記憶に基づいて言い換えない)、各項目が1回限りか定期か、そしてマルコスが実際に決定した価格。まだ決定されていないものについては、推測せずに直接マルコスに確認する。
- 共有ブランドモジュールを使用する(この環境にない場合は再構築する。以下のスニペットから
brand.jsに再現し、PWSロゴのトリミングされたコピーと共に配置する):
const BRAND = {
navy: "001E47", blue: "2F8DD2", orange: "FE6701", gray: "5A6472",
bodyFont: "Times New Roman", // 汎用的なプロフェッショナル/法的文書用セリフ体
headingFont: "Poppins", // 太字の幾何学的サンセリフ体、PEAKロゴを反映
};
function docStyles() {
return { default: { document: { run: { font: BRAND.bodyFont } } } };
}
// letterhead(titleText): ロゴ画像 + 太字のネイビータイトル(フォント: BRAND.headingFont)をオレンジの罫線の下に配置
// footer(): 中央揃え「Peak Workflow Solutions, LLC | Selah, WA | pwslocal.com」、小文字、グレー、上部に青い罫線
// h1(text) / h2(text): 太字ネイビーの見出し、フォント: BRAND.headingFont
すべてのnew Document({...})呼び出しに...docStyles()を展開し、本文テキストがデフォルトでTimes New Romanになるようにする。見出しとレターヘッドは明示的にPoppins Boldにオーバーライドする。
-
テーブルヘッダーは白黒で、色を付けない。 以前のバージョンではヘッダーセルをネイビーで塗りつぶしていた。ヘッダーテキストに明示的な色が設定されていなかったため、一部の画面では黒字にネイビー背景でコントラストが低くなっていた。テーブルヘッダーは、白地に太字の黒テキストで、プレーンなグリッド線の境界線のみとする。ヘッダーセルに
shade/塗りつぶし色を再導入しない。 -
空白フィルライン:テーブルセル内では短い空白を使用する。 標準の空白フィルライン(
U = "________________"、16アンダースコア)は本文テキストと幅の広いセル用である。より狭いテーブルセル(タイムライン列、合計行の価格セル)では、2行に折り返されて見栄えが悪くなる。代わりに、そこでは短い空白(US = "__________"、10アンダースコア)を使用する。 -
標準セクションフロー(docx-jsを
docxスキル経由で使用):冒頭/当事者ブロック、次に入力可能な「フェーズ ___ — ___(エンゲージメント名)」行。「サービスとScope of Work」、「期間」、「料金と支払い」(番号付き条項:[料金 [Exhibit Aの合計を参照し、個別の金額欄は設けない]、支払いスケジュール [20/80、個別の金額欄は設けない]、追加スコープは新しい契約へ、請求書発行、遅延支払い])、[定期サービス、自動支払い、および解約 — このエンゲージメントにリテーナー要素がある場合のみ]、「クライアントの責任」、「クライアントのシステムとデータへのアクセス」、「知的財産と再販権」(クライアント固有の成果物、プロバイダーツール、導入事例、再販権)、「機密保持」、「保証と免責事項」、「責任の制限」、「独立請負業者」、「契約解除」、「準拠法」、「完全合意と修正」、改ページ、「Exhibit A」、「署名」。 -
Exhibit Aの構造 — 常にこの形式を使用する:
- 「Automation Builds」テーブル:列:Automation | Description | Timeline | Initial Build Price。このエンゲージメントの個々の自動化/成果物ごとに1行。20行のプロジェクトは20行、2行のプロジェクトは2行。マルコスが実際の明細(名前、説明、タイムライン、価格)を提供した場合は、空白のままにせず、各行を直接入力する。最後に下の行として、最初の3列を結合(
columnSpan: 3)し「Total Initial Build Price」と表示し、最後の列に金額の合計を表示する — すべての明細に実際の価格が設定されている場合は、自分で各行の価格を合計すること。1つ以上の明細の価格が未定の場合は、空白のフィルラインとして残す。 - その直下に「Monthly Retainer / Maintenance」セクション、3列のみの小さな独自テーブル:Frequency | Fee | Autopay(「Service」列はなし。マルコスは、エンゲージメントにリテーナー行が1つしかない場合に何を入れるべきか不明確だと判断した)。Frequencyには「Monthly」が事前入力され、Autopayには「☐ Authorized (Section 4.3)」チェックボックスが含まれる。このテーブルは、エンゲージメントに定期コンポーネントがある場合にのみ含める。それ以外の場合は、「No recurring maintenance or retainer service applies to this engagement.」と明記する(セクションを削除するのではなく、すべてのExhibit Aの形状を統一するため)。
- 番号付けの注意点(docx-js特有、既に2回ヒットしているので繰り返さないこと):
numbering.reference文字列は、ドキュメント全体で再利用すると、連続してカウントされる。各番号付き条項ブロック(料金、定期、IP)には、独自のreference名(例:clausesFees、clausesRecurring、clausesIP)を付け、"clauses"のような共通のreferenceを決して共有しない。- ドキュメントのセクションリストが変動する場合(例:定期セクションの有無)、「Section 4」/「Section 12」のようなテキストを手動で入力しない。セクションが追加または削除されるたびにずれる可能性がある。セクションキーの順序配列を事前に計算し、各キーに一度番号を割り当て、その番号を相互参照に使用する。パターンを参照:
sectionOrder(条件付きで"recurring"を含める)を構築し、secNum = {}; sectionOrder.forEach((k,i) => secNum[k]=i+1)とし、本文内でセクション番号が記載されている場所ではsecNum.terminationなどを参照する。 TableCellは、結合されたTotal行を構築するためにcell()ヘルパーにcolumnSpanオプションをスレッドする必要がある。古いcell()ヘルパーを再利用する場合は、width/shadeのみを処理するものであるため、追加することを忘れないこと。
-
対応する同意・アクセス許可書を作成する — 新しいシステムに触れるすべてのエンゲージメントに対して。異なるビルドのために古いエンゲージメントのアクセステーブル行を再利用しない。同じブランディング、同じ白黒の空欄入力可能なテーブルパターン(System/Account、Specific Item、Access Granted、Purpose)。
-
納品前に毎回検証する: PDFに変換し(
docxスキルのsoffice.py --headless --convert-to pdfスクリプトを使用)、JPGにレンダリングし(pdftoppm -jpeg -r 100)、実際に各ページ画像をReadして確認する:ブランディングが正しいか、セクション番号が連続しており相互参照が一致するか、割引/標準料金の表現が紛れ込んでいないか、空白が本当に空白か(以前のクライアントの古い数値が残っていないか)、短い空白で見苦しい行折り返しがないか、Automation Buildsの合計が実際に行の合計と一致しているか。再検証せずに再ビルドを納品しないこと。 -
SendUserFileで納品し、構築した内容と価格/構造に関する決定事項を、そのクライアント自身のプロジェクト/ビルドログに記録する。一般的なPWSプロジェクトには記録しない。
検証
- マルコスが明示的に指定した場合を除き、文書内に金額、日付、時間数が表示されていない
- 割引計算、割引率、「初めてのお客様料金」などの表現がどこにもない
- すべての定期サービスは、独自のセクション(自動支払い + 30日間解約通知)の下にあり、1回限りの20/80分割内には決して含まれていない
- セクション番号は、実際にレンダリングされたPDFから読み取られており、コードから推測されたものではない
- Exhibit AのTotal Initial Build Priceが、入力された明細項目の合計と一致している
- 「料金と支払い」セクションは、独自の個別の金額欄を印刷するのではなく、Exhibit Aの合計を参照している
- テーブルヘッダーは、白地に太字の黒テキスト — 色の網掛けはどこにもない
- リテーナーテーブルは正確に3列(Frequency | Fee | Autopay)であり、Service列はない
- ブランディング(ロゴ、ネイビー/ブルー/オレンジ、Times New Roman本文 / Poppins Bold見出し、フッター)がすべてのページで一致している
- クライアントが実際に署名する前に、ライセンスを持つワシントン州の弁護士がレビューする必要があることを伝えたことを確認するリマインダーが含まれている