BeautifulEngine/company-brief

カンパニーブリーフ

企業名またはURLを、深く調査され、情報源が明示され、デザインされたPDFに変換します。このPDFは、面接、オファー交渉、クライアントへの提案、または新しいブランドとの最初のプロジェクトに臨むにあたり、知っておくべきすべての情報を提供します。つまり、企業の概要、業績、経営陣、社内の雰囲気、ブランドとマーケティングの状況、競合他社、そしてどのようにアプローチすべきかが網羅されています。PDFはその企業自身のカラーと書体を使用するため、あたかもその企業に属する資料のような印象を与えます。

使用方法

/company-brief <会社名またはURL> [for <役割>] [brand kit] [shareable]

使用例: /company-brief linear.app, /company-brief Figma for Senior Brand Designer, /company-brief patagonia.com brand kit, /company-brief Notion shareable。プレーンなリクエストも可能です：「面接前にNotionのカンパニーブリーフを作って」「Oatlyをクライアントとして契約したので、ブランドについてキャッチアップが必要」。

• Company (企業): URLが指定されていれば企業を一意に特定します。名前のみの場合は特定できない可能性があります（ステップ1）。
• for (役割指定): 採用情報、知っておくべき人物、面接対策をその役割とチームに焦点を当てます。指定がない場合、デフォルトでデザイン、ブランド、マーケティング、クリエイティブリーダーシップ、または質問者の経歴に基づいて判断します。
• Personal mode (デフォルト): 質問者個人に向けて作成されます。あなたが知っている情報（メモリ、過去のチャット、この会話、添付された履歴書やポートフォリオ）を「あなたの視点」、ピッチ、そして「あなたへの適合性」に活用します。オファーが出ている場合は「署名前に確認すべきこと」を追加します。質問者について何も知らない場合は、それらの部分は一般的に作成し、回答の中で調整可能であることを提案します。
• Brand work (ブランドワーク) (「brand kit」と指定された場合、または質問者がデザイナー、ストラテジスト、エージェンシー、社内パートナーとしてブランドのデザイン、提案、または作業を開始する場合): 「ブランドアイデンティティ」と「ブランドキット」のセクションが最も重視され、キットにはアセットの完全なリストと「クライアントに依頼するもの」のコールアウト（references/brand-extraction.md, セクション4）が含まれます。パート5では、「面接対策」が「キックオフ準備」（ブランドチームが期待すること、持ち物、想定される質問）に変わり、「質問すべきこと」はブランドチーム向けとなり、「あなたへの適合性」と「署名前に確認すべきこと」は削除されます。採用情報は短い段落に留めます。
• Shareable (共有用) (「shareable」「for a friend」「to send to someone」と指定された場合): 個人に関する情報は一切含めません。「Prepared for」バッジ、適合スコア、「署名前に確認すべきこと」はありません。パート5は「彼らと話す方法」に、「あなたの視点」は「効果的なアプローチ」に変わります。

企業の身元が本当に曖昧でない限り、質問を中断してはいけません。最初の返信で、何をしているのかを一文で述べ、タスクリストを表示し、その後リサーチを開始します。

スキルファイル

以下のパスは${CLAUDE_SKILL_DIR}を使用します。そのテキストが実行環境で実際のパスに置き換えられていない場合は、find / -name brief-template.html -path '*company-brief*' 2>/dev/null | head -1でフォルダを一度見つけ、全てのコマンドでその絶対パスを使用してください（シェル変数はコマンド間で持続しない場合があります）。

ファイル	目的
assets/brief.css	基本スタイルシート。コピーして使用し、編集しないでください。
assets/brief-template.html	{{placeholders}} を含むブリーフ全体の骨格
scripts/fonts.py	Fontsourceから無料フォントをインストールし、<link>タグを出力します
scripts/tokens.py	ブランドカラーをトークン<style>ブロックに変換し、コントラストを修正します
scripts/render.cjs	Node Playwrightを使用してPDFをレンダリングし、フォント、コントラスト、プレースホルダーを監査します
scripts/render.py	Python版。Playwright、Chrome CLI、WeasyPrintの順にフォールバックします
scripts/audit.js	両方のレンダラーがページ内で実行する監査
scripts/contact_sheet.py	レイアウト確認用に全ページを1枚の画像にします
references/research-playbook.md	各セクションの情報源と効率的な調査順序
references/brand-extraction.md	ライブサイトから実際のカラー、フォント、ロゴの説明を取得する方法
references/components.md	各コンポーネントのマークアップ、セクション順序、記述ルール

絶対ルール

• まず曖昧性を排除する。 多くの企業は名前を共有しており、資金調達データベースや求人サイトはそれらを混同することがよくあります。各財務情報や採用情報が正しい企業（同じドメイン、創業者、本社）に属していることを確認してください。競合が存在する場合、概要の冒頭に名前確認のコールアウトを入れてください。
• すべての数値には出典、日付、確信度タグを付ける: Verified（一次情報源：法定文書、企業自身のサイトや採用ページ）、Reported（信頼できる報道）、Company claim（企業のマーケティング資料）、Estimate（第三者情報またはあなたの推測。その根拠を明記）、Unknown（検索したが見つからなかった場合。どこを検索したか明記）。
• 調査結果は随時 research-notes.md に書き込む。 長時間の調査では検索結果がコンテキストから消えます。書き留めなかったものは失われます。
• 最新性: 今日の日付を使用します。ニュース検索には年を入れます。18ヶ月以上古い情報は古いものとしてマークします。
• 人について: 公開されているリーダーおよび役割に関連する人物のみ、公開された職業情報に限ります。個人の連絡先、自宅の場所、家族、人物の写真は含めないでください。
• ブランドアセットはリンクであり、コピーではありません。 ロゴは言葉で説明し、ブランド自身のロゴファイルとガイドラインにリンクしてください。ロゴ、マスコット、フォント、広告画像をブリーフや作業フォルダに再描画、トレース、埋め込み、ダウンロードしないでください。ブランドのプレスキット、ブランドポータル、ガイドラインを、サードパーティのロゴサイトよりも優先してください。どちらであるかを明記し、各ファイルの形式を開いて確認し、ファイルを管理する利用規約にリンクしてください。カラースウォッチ、書体見本、抽象的なブランドカラーのパターンは問題ありません。
• 引用: 従業員のレビューからは25語以内の抜粋を、全体で4つまで、プラットフォームと日付を明記して使用します。記事は要約し、貼り付けないでください。
• 独立した調査であることを明記: 表紙には「独立した調査ブリーフです。<企業名>とは提携しておらず、その承認も受けていません。」と記載します。
• 欠落している情報は、セクションを黙って削除する代わりに、1行でその旨を記載する。
• 実施していない確認を主張しない（「このブリーフではGlassdoorのみをレビューしました」など）。
• 共有用ブリーフには、たとえあなたが知っていることであっても、質問者に関する個人情報を一切含めてはなりません。

ワークフロー

以下のタスクリストを作成し、完了した項目にチェックを入れていきます。

1. 企業を特定し、名前の競合をチェックする
2. 作業フォルダとメモファイルをセットアップする
3. 企業自身のサイトと採用ページを読む
4. その他すべてを並行してバッチで調査する
5. ブランドカラーと書体を抽出し、トークンとフォントを構築する
6. ブランドキットを構築する：ロゴファイル、ガイドライン、フォント、カラー仕様
7. 統合する：結論、スコアカード、彼らと話す方法
8. brief.htmlを書く
9. レンダリングと監査
10. 事実、リンク、レイアウトを確認する
11. 納品する

1. 特定

• URLが指定された場合：ホームページとAboutページを開く。名前のみの場合："<name>" company と "<name>" official site を検索する。
• ブランド名と法人名、ドメイン、本社、設立年、創業者、公開/非公開（ティッカー）、親会社を特定する。
• "<name>" -<domain> で同名の企業を検索する。
• 2つ以上の実在する企業がもっともらしく一致し、リクエストからそれらを区別できない場合、候補を挙げて1つの質問をする。それ以外の場合は最適なものを選び、回答の冒頭でそれを明記する。
• パーソナルモードの場合、過去のチャットとメモリ（利用可能な場合）も検索し、企業名を探す：応募、リクルーターとのやり取り、オファーは重要事項を変更する。

2. 作業フォルダ

mkdir -p briefs/<企業スラッグ> && cd briefs/<企業スラッグ>
cp "${CLAUDE_SKILL_DIR}/assets/brief.css" . && cp "${CLAUDE_SKILL_DIR}/assets/brief-template.html" brief.html

カレントディレクトリ、または書き込み可能でない場合はスクラッチフォルダを使用します。ブリーフのセクションごとに見出しを付けた research-notes.md を作成し、調査結果を - <事実> | <タグ> | <ソースタイトル> | <URL> | <日付> の形式で追加していきます。

3. まず企業自身のサイトを見る

ライブサイトと採用ページはブリーフの3分の1を満たし、ミッション、バリュー、製品、顧客、オフィス、募集職種、給与、面接プロセス、ソーシャルハンドル、ブランドトークンにとって最も信頼できる情報源です。

• ブラウザツールが使える場合（Chrome内のClaude、アプリ内ブラウザ、クラウドブラウザ）、企業のドメインにそれを使用します。一度だけサイト全体の承認を求められた場合は承認します。ロゴとヒーロー画像を除き、ページはスクリーンショットではなくテキストとして読みます。
• 以下の順に訪問する：ホームページ（ポジショニング、顧客ロゴ、フッターのハンドルとリンク）→ About → Careers（部署と場所ごとの役割数をカウント）→ 対象の役割に最も近い2～4つの求人情報（給与、面接ステップ、報告ライン、使用ツール）→ Press/ニュースルーム（タイムライン、プレスキット、ロゴファイル、ブランドガイドライン）→ Blog/チェンジログ（過去3ヶ月）→ Events → Customers。
• 訪問中にホームページでブランド抽出スクリプトを実行します（references/brand-extraction.md, セクション1）。
• ブラウザがない場合：同じページをfetchツールで取得します。
• 採用ページは、しばしば古い求人ボードAPIよりも優先されます。プレイブックのATS APIリストはフォールバックとしてのみ使用します。

詳細：references/research-playbook.md、セクション1～2。

4. その他すべて

references/research-playbook.mdのセクション3～6に従います。独立した検索を1ターンでまとめて送信します（資金調達、収益、ニュース、レビュー、競合他社、キャンペーン、イベント、ポッドキャスト）。最初に標準検索を使用し、最近のニュース、採用・レビューデータ、または情報が薄いものには拡張検索を使用します。入力したURLをfetchツールが拒否した場合、それを検索して結果リンクを取得するか、ブラウザで開きます。求人サイト（Indeed、ZipRecruiter、LinkedIn）へのコネクタが存在する場合、評価や職種の確認に有効です。

中規模企業の場合、40～80回のルックアップが標準です。2回の良い検索後もセクションの情報が薄い場合は、Unknown とマークして次に進みます。

5. ブランドトークンとフォント

抽出結果（references/brand-extraction.md）から：

python3 "${CLAUDE_SKILL_DIR}/scripts/fonts.py" "<表示フォント>:400,500,600" "<本文フォント>:400,600" "<ラベルフォント>:400,500"
python3 "${CLAUDE_SKILL_DIR}/scripts/tokens.py" --brand "#…" --accent "#…" \
  --font-display "<表示フォント>" --font-body "<本文フォント>" --font-label "<ラベルフォント>" \
  --display-weight 600 --tracking -0.02em --radius 8px \
  --footer "<企業名> · Company Brief · <Mon YYYY>" [--cover-stops "#…,#…,#…"] > tokens.html

• fonts.py からの <link> 行を brief.html の FONT LINKS マーカーに、tokens.html を TOKENS マーカーに貼り付けます。
• tokens.py レポートのすべての行が ok と言っていることを確認します。WARNING は異なる色を選択する必要があることを意味します（薄い署名色の場合、濃い色を --brand にします）。
• プロプライエタリなブランドフォントの場合：brand-extraction.md セクション2の代替テストを実行し、どの無料フォントが代用されているかをブリーフに記載します。
• npm がフォントをインストールできない場合、インストール済みのファミリー（fc-list : family）を使用し、その旨を書体セクションに記載します。

6. ブランドキット

references/brand-extraction.md、セクション4に従います。すべてのモードで、プライマリロゴをベクターファイル（SVG、EPS、AI、またはベクターPDF）として、そして最新の公開ブランドガイドラインを見つけます。ブランドワークモードでは、さらにフォント、カラー仕様、イメージ、テンプレート、定型文、利用規約も見つけます。検索はまとめて送信します。各アイテムについて、リンク、開いて確認した形式、ソース（公式またはサードパーティ）、その日付、ステータス（Current、Dated、Outdated、Request access、Not found）を記録します。ロゴファイルが現在のライブサイトのロゴと一致することを確認します。

7. 統合

メモファイル全体を読み、結論、知っておくべき3つのこと、スコアカード、彼らの言語、優先事項→トーキングポイント、30秒ピッチ、視点、面接対策、質問すべきこと、すべきこと/すべきでないこと、署名前に確認すべきこと（オファーのみ）、アウトリーチを決定します。各項目のガイダンス：references/research-playbook.md セクション7。

8. brief.htmlを書く

テンプレート内のすべての {{placeholder}} を置き換え、必要に応じて行や項目を追加し、テンプレートが条件付きとしてマークしているセクションのみを削除します。マークアップと記述ルール：references/components.md。ブリーフごとのCSSは最小限に抑え、テンプレートのオーバーライドブロックに記述します。目標は14～20ページです。

9. レンダリングと監査

node "${CLAUDE_SKILL_DIR}/scripts/render.cjs" brief.html "<企業名>-Company-Brief-<YYYY-MM>.pdf" \
  || python3 "${CLAUDE_SKILL_DIR}/scripts/render.py" brief.html "<企業名>-Company-Brief-<YYYY-MM>.pdf"

• NodeレンダラーはPlaywrightがない場合に終了コード2で終了し、Python版が起動します。render.pyはPlaywright、Chromeバイナリ、WeasyPrint（pip install weasyprint）の順に試行します。
• すべての FAIL 行（フォントが読み込まれていない、テキストのコントラストが4.5:1未満、残りのプレースホルダー）を修正し、再度レンダリングします。
• 個人のコンピュータで作業しており、何もレンダリングされない場合、レンダラーのインストールを確認してから行ってください（pip install playwright && python -m playwright install chromium）。

10. チェック

• レイアウト：python3 "${CLAUDE_SKILL_DIR}/scripts/contact_sheet.py" <pdf> sheet.png を実行し、画像を確認します。表紙はフルブリードでフッターなし、概要は2ページ目に収まる、各パートは新しいページから始まる、クリップされている部分がない、テーブルがあふれていない、ほぼ空のページがない、見出しがページの下端に取り残されていないことを確認します。疑わしいページは pdftoppm -r 150 -f N -l N -png <pdf> page で拡大して再度確認します。
• 事実：PDF内のすべての数値がメモファイルと一致し、タグが付いており、ソースに表示されていることを確認します。日付は絶対日付です。同名の他企業の情報が混在していないことを確認します。
• コピー：references/components.mdの記述ルールをもう一度テキストと照らし合わせて読みます。
• リンク：5つ以上のソースリンクを開いて解決することを確認し、ブランドキットのすべてのリンクを開いてリストされた形式で解決することを確認します。

11. 納品

• PDFをファイルとして送信します。ブランドワークモードの場合は、<企業名>-Brand-Kit.md も送信します。これはプレーンリンクとしてのキットテーブルで、プロジェクトドキュメントやチャンネルに貼り付ける準備ができています。相手が自分のコンピュータのフォルダにブリーフを保存しており、アクセスできる場合は、そこにも保存します。
• 回答は数行で行います：結論を2文で、最も鋭いトーキングポイントを2～3つ、見つけられなかった重要な情報、そして役立つ次のステップ（カスタマイズされたカバーレター、アウトリーチメモ、模擬面接の質問、キックオフ議事録、または共有可能バージョン）を1つ。ブランドワークモードでは、見つけたロゴとガイドラインファイル、およびチームがリクエストする必要があるものを記載します。