Company Brief

Que fait Company Brief ?

Transformez un nom d'entreprise ou une URL en un PDF détaillé, sourcé et mis en page qui donne au lecteur tout ce dont il a besoin pour un entretien, une négociation d'offre, un pitch client ou un premier projet avec une nouvelle marque : ce qu'est l'entreprise, comment elle se porte, qui la dirige, comment y travailler, comment fonctionnent sa marque et son marketing, qui sont ses concurrents et comment lui parler. Le PDF utilise les couleurs et polices réelles de l'entreprise, pour donner l'impression qu'il lui appartient.

Utilisation

/company-brief <nom ou URL de l'entreprise> [for <rôle>] [brand kit] [shareable]

Exemples : /company-brief linear.app, /company-brief Figma for Senior Brand Designer, /company-brief patagonia.com brand kit, /company-brief Notion shareable. Les demandes simples fonctionnent aussi : "fais-moi un brief sur Notion avant mon entretien" ou "on vient de signer Oatly comme client, je dois me mettre à jour sur leur marque."

• Company : une URL règle l'identité. Un nom seul peut ne pas suffire (Étape 1).
• for <rôle> : concentre le recrutement, les personnes à connaître et la préparation d'entretien sur ce rôle et son équipe. Sans cela, par défaut sur la direction design, marque, marketing et création, ou sur ce que suggère le profil de la personne.
• Mode personnel (par défaut) : rédigé pour la personne qui demande. Utilisez ce que vous savez d'elle (mémoire, conversations passées, cette discussion, un CV ou portfolio joint) pour "Votre angle", le pitch et "Adapté à vous". S'il y a une offre en main, ajoutez "Avant de signer". Si vous ne savez rien d'elle, rédigez ces parties de manière générique et proposez dans la réponse de les personnaliser.
• Travail de marque ("brand kit", ou la personne dit qu'elle conçoit pour la marque, fait un pitch ou commence à travailler avec elle en tant que designer, stratège, agence ou partenaire interne) : les sections Identité de marque et Kit marque reçoivent le plus d'attention, et le kit inclut la liste complète des assets et l'appel "Demander au client" (references/brand-extraction.md, section 4). Dans la cinquième partie, "Préparation entretien" devient "Préparation kickoff" (ce que l'équipe marque attendra, quoi apporter, questions probables), "Questions à poser" sont pour l'équipe marque, et Adaptation à vous et Avant de signer sont supprimés. Gardez le Recrutement sur un court paragraphe.
• Partageable ("shareable", "pour un ami", "à envoyer à quelqu'un") : rien sur la personne. Pas de pastille "Préparé pour", pas de score d'adéquation, pas de Avant de signer. La cinquième partie devient "Comment leur parler" et "Votre angle" devient "Angles qui fonctionnent".

N'arrêtez pas de poser des questions sauf si l'identité de l'entreprise est vraiment ambiguë. Commencez dès la première réponse : une phrase sur ce que vous faites, la liste des tâches, puis les recherches.

Fichiers du skill

Les chemins ci-dessous utilisent ${CLAUDE_SKILL_DIR}. Si ce texte n'est pas remplacé par un chemin réel là où vous exécutez, trouvez le dossier une fois avec find / -name brief-template.html -path '*company-brief*' 2>/dev/null | head -1 et utilisez son chemin absolu dans chaque commande (les variables d'environnement peuvent ne pas persister entre les commandes).

Fichier	Utilité
assets/brief.css	Feuille de style de base. Copiez-la ; ne la modifiez pas.
assets/brief-template.html	Squelette complet du brief avec des {{placeholders}}
scripts/fonts.py	Installe les polices gratuites depuis Fontsource et imprime les balises <link>
scripts/tokens.py	Transforme les couleurs de la marque en bloc <style> de tokens, avec corrections de contraste
scripts/render.cjs	Génère le PDF avec Node Playwright et audite les polices, le contraste, les placeholders
scripts/render.py	Même chose en Python, avec fallback sur Chrome CLI, puis WeasyPrint
scripts/audit.js	L'audit que les deux générateurs exécutent dans la page
scripts/contact_sheet.py	Une image de chaque page pour vérifier la mise en page
references/research-playbook.md	Où chercher pour chaque section, et l'ordre efficace
references/brand-extraction.md	Obtenir les vraies couleurs, polices et description du logo depuis le site en ligne
references/components.md	Balisage pour chaque composant, ordre des sections, règles d'écriture

Règles strictes

• Désambiguïser d'abord. De nombreuses entreprises partagent des noms, et les bases de données de financement et les sites d'emploi les fusionnent souvent. Confirmez que chaque fait financier et de recrutement appartient à la bonne entité (même domaine, fondateurs, siège). En cas de collision, ouvrez le résumé par un encart Vérification de nom.
• Chaque chiffre a une source, une date et une étiquette de confiance : Vérifié (primaire : documents officiels, site ou page carrières de l'entreprise), Rapporté (presse crédible), Affirmation de l'entreprise (sa communication), Estimation (tiers ou votre inférence ; dites à partir de quoi), Inconnu (recherché, non trouvé ; dites où).
• Écrivez les résultats dans research-notes.md au fur et à mesure. Les résultats de recherche sont effacés du contexte dans les longues recherches. Tout ce qui n'est pas écrit est perdu.
• Actualité : utilisez la date d'aujourd'hui ; mettez l'année dans les recherches d'actualités ; marquez tout ce qui date de plus de 18 mois comme obsolète.
• Personnes : dirigeants publics et personnes pertinentes pour le rôle, avec uniquement des informations professionnelles publiques. Pas de coordonnées personnelles, d'adresses, de famille ou de photos de personnes.
• Les assets de marque sont des liens, jamais des copies. Décrivez le logo en mots et faites un lien vers les fichiers logo et les directives de la marque. Ne redessinez pas, ne tracez pas, n'intégrez pas et ne téléchargez pas de logos, mascottes, polices ou images publicitaires dans le brief ou le dossier de travail. Préférez le kit presse de la marque, le portail de marque ou les directives aux sites de logos tiers, indiquez clairement ce qui est quoi, confirmez le format de chaque fichier en l'ouvrant, et faites un lien vers les conditions d'utilisation qui régissent les fichiers. Les échantillons de couleurs, les spécimens de polices et les motifs abstraits aux couleurs de la marque sont acceptables.
• Citations : extraits d'avis employés de 25 mots maximum, 4 au total, attribués à la plateforme et à la date. Résumez les articles ; ne les copiez pas.
• Indiquez l'indépendance : la couverture indique "Brief de recherche indépendant. Non affilié à ou approuvé par ."
• Dites ce qui manque en une ligne au lieu de supprimer une section en silence.
• Ne prétendez jamais avoir fait une vérification que vous n'avez pas faite ("Seul Glassdoor a été consulté pour ce brief").
• Les briefs partageables ne contiennent rien de privé sur la personne qui demande, même si vous le savez.

Workflow

Créez cette liste de tâches et cochez les éléments au fur et à mesure :

1. Identifier l'entreprise et vérifier les collisions de noms
2. Configurer le dossier de travail et le fichier de notes
3. Lire le site de l'entreprise et les pages carrières
4. Rechercher tout le reste par lots parallèles
5. Extraire les couleurs et polices de la marque ; construire les tokens et polices
6. Construire le kit marque : fichiers logo, directives, polices, spécifications couleur
7. Synthétiser : conclusion, tableau de bord, comment leur parler
8. Rédiger brief.html
9. Générer et auditer
10. Vérifier les faits, liens et mise en page
11. Livrer

1. Identifier

• URL fournie : ouvrez la page d'accueil et la page À propos. Nom fourni : recherchez "<nom>" entreprise et "<nom>" site officiel.
• Déterminez le nom de marque et le nom légal, le domaine, le siège, l'année de création, les fondateurs, statut public ou privé (ticker), la maison mère.
• Recherchez "<nom>" -<domaine> pour les entreprises homonymes.
• Si deux entreprises réelles ou plus correspondent plausiblement et rien dans la demande ne les distingue, posez une question en nommant les candidates. Sinon, choisissez la meilleure correspondance et indiquez-la en haut de votre réponse.
• En mode personnel, recherchez également dans les conversations passées et la mémoire (si disponible) le nom de l'entreprise : une candidature, un fil de discussion avec un recruteur ou une offre change ce qui est important.

2. Dossier de travail

mkdir -p briefs/<slug-entreprise> && cd briefs/<slug-entreprise>
cp "${CLAUDE_SKILL_DIR}/assets/brief.css" . && cp "${CLAUDE_SKILL_DIR}/assets/brief-template.html" brief.html

Utilisez le répertoire de travail actuel, ou un dossier temporaire s'il n'est pas accessible en écriture. Créez research-notes.md avec un titre par section du brief, et ajoutez les résultats sous forme - <fait> | <étiquette> | <titre source> | <URL> | <date>.

3. Le site de l'entreprise en premier

Le site en ligne et les pages carrières répondent à un tiers du brief et sont la source la plus fiable pour la mission, les valeurs, les produits, les clients, les bureaux, les postes ouverts, les salaires, le processus d'entretien, les réseaux sociaux et les tokens de marque.

• Si vous avez un outil de navigation (Claude dans Chrome, un navigateur intégré à l'application ou un navigateur cloud), utilisez-le pour le domaine de l'entreprise ; approuvez l'ensemble du site une fois si demandé. Lisez les pages sous forme de texte, pas de captures d'écran, sauf pour le logo et le hero.
• Visitez, dans l'ordre : page d'accueil (positionnement, logos clients, liens en pied de page) → À propos → Carrières (comptez les postes par département et lieu) → 2 à 4 annonces les plus proches du rôle cible (salaire, étapes d'entretien, ligne hiérarchique, outils) → Presse/salle de presse (chronologie, kit presse, fichiers logo, directives de marque) → Blog/journal (3 derniers mois) → Événements → Clients.
• Exécutez le script d'extraction de marque sur la page d'accueil pendant que vous y êtes (references/brand-extraction.md, section 1).
• Pas de navigateur : récupérez les mêmes pages avec l'outil de récupération.
• La page carrières est plus fiable que les API des sites d'emploi, qui sont souvent obsolètes. Utilisez la liste des API ATS dans le playbook uniquement en dernier recours.

Détails : references/research-playbook.md, sections 1–2.

4. Tout le reste

Suivez references/research-playbook.md sections 3–6. Envoyez les recherches indépendantes ensemble en un seul tour (financement, revenus, actualités, avis, concurrents, campagnes, événements, podcasts). Utilisez d'abord la recherche standard et la recherche étendue pour les actualités récentes, les données de recrutement et d'avis, ou tout ce qui est limité. Si un outil de récupération refuse une URL que vous avez tapée, recherchez-la et récupérez le lien du résultat, ou ouvrez-la dans le navigateur. Les connecteurs pour les sites d'emploi (Indeed, ZipRecruiter, LinkedIn), s'ils sont présents, sont utiles pour les évaluations et les postes.

40 à 80 recherches sont normales pour une entreprise de taille moyenne. Lorsqu'une section reste limitée après deux bonnes recherches, marquez-la Inconnu et passez à autre chose.

5. Tokens de marque et polices

À partir de l'extraction (references/brand-extraction.md) :

python3 "${CLAUDE_SKILL_DIR}/scripts/fonts.py" "<Police Affichage>:400,500,600" "<Police Corps>:400,600" "<Police Étiquette>:400,500"
python3 "${CLAUDE_SKILL_DIR}/scripts/tokens.py" --brand "#…" --accent "#…" \
  --font-display "<Police Affichage>" --font-body "<Police Corps>" --font-label "<Police Étiquette>" \
  --display-weight 600 --tracking -0.02em --radius 8px \
  --footer "<Entreprise> · Company Brief · <Mon AAAA>" [--cover-stops "#…,#…,#…"] > tokens.html

• Collez les lignes <link> de fonts.py au marqueur LIENS POLICES et tokens.html au marqueur TOKENS dans brief.html.
• Chaque ligne du rapport de tokens.py doit indiquer ok. Un AVERTISSEMENT signifie choisir des couleurs différentes (pour une couleur signature claire, utilisez la foncée comme --brand).
• Police de marque propriétaire : exécutez le test de remplacement dans brand-extraction.md section 2 et dites dans le brief quelle police libre fait office de remplacement.
• Si npm ne peut pas installer les polices, utilisez une famille installée (fc-list : family) et mentionnez-le dans la section Polices.

6. Kit marque

Suivez references/brand-extraction.md, section 4. Dans tous les modes, trouvez le logo principal sous forme de fichier vectoriel (SVG, EPS, AI ou PDF vectoriel) et les directives de marque publiques les plus récentes ; en mode travail de marque, trouvez également les polices, spécifications couleur, imagerie, modèles, textes types et conditions d'utilisation. Envoyez les recherches ensemble. Pour chaque élément, enregistrez le lien, le format que vous avez confirmé en l'ouvrant, la source (officielle ou tierce), sa date et un statut : Actuel, Obsolète, Périmé, Demander accès ou Non trouvé. Vérifiez que le fichier logo correspond au logo sur le site en ligne aujourd'hui.

7. Synthétiser

Lisez l'intégralité du fichier de notes, puis décidez de la conclusion, des trois points à retenir, du tableau de bord, de leur langage, priorités → points de discussion, du pitch en 30 secondes, de l'angle, de la préparation d'entretien, des questions à poser, des à faire et à ne pas faire, avant de signer (offre uniquement), et de la prise de contact. Conseils pour chacun : references/research-playbook.md section 7.

8. Rédiger brief.html

Remplacez chaque {{placeholder}} dans le modèle, ajoutez des lignes et des éléments si nécessaire, et supprimez uniquement les sections que le modèle marque comme conditionnelles. Règles de balisage et d'écriture : references/components.md. Gardez le CSS spécifique au brief petit et dans le bloc de remplacement du modèle. Visez 14 à 20 pages.

9. Générer et auditer

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

• Le générateur Node se termine avec le code 2 si Playwright est manquant, ce qui déclenche le générateur Python. render.py essaie Playwright, puis un binaire Chrome, puis WeasyPrint (pip install weasyprint).
• Corrigez chaque ligne ÉCHEC (police non chargée, texte avec un contraste inférieur à 4.5:1, placeholder restant) et générez à nouveau.
• Si vous êtes sur l'ordinateur personnel de quelqu'un et que rien ne se génère, demandez avant d'installer un générateur (pip install playwright && python -m playwright install chromium).

10. Vérifier

• Mise en page : python3 "${CLAUDE_SKILL_DIR}/scripts/contact_sheet.py" <pdf> sheet.png, puis regardez l'image. La couverture est en fond perdu sans pied de page ; le résumé tient sur la page 2 ; chaque partie commence sur une nouvelle page ; rien n'est coupé ; aucun tableau ne déborde ; pas de pages presque vides ; aucun titre n'est isolé en bas de page. Générez une page douteuse en plus grand avec pdftoppm -r 150 -f N -l N -png <pdf> page et regardez à nouveau.
• Faits : chaque chiffre dans le PDF correspond au fichier de notes, porte une étiquette et apparaît dans Sources. Les dates sont absolues. L'autre entreprise homonyme n'est pas mélangée.
• Copie : relisez les règles d'écriture de references/components.md une fois de plus par rapport au texte.
• Liens : ouvrez 5 liens Sources ou plus pour confirmer qu'ils fonctionnent, et ouvrez chaque lien du kit marque pour confirmer qu'il pointe vers le format indiqué.

11. Livrer

• Envoyez le PDF sous forme de fichier. En mode travail de marque, envoyez également <Entreprise>-Brand-Kit.md : la table du kit sous forme de liens bruts, prêts à être collés dans un document de projet ou un canal. Si la personne conserve les briefs dans un dossier sur son ordinateur et que vous pouvez y accéder, enregistrez-le également là-bas.
• Répondez en quelques lignes : la conclusion en deux phrases, les 2 à 3 points de discussion les plus pertinents, tout élément important que vous n'avez pas pu trouver, et une prochaine étape utile (une lettre de motivation personnalisée, une note de prise de contact, des questions d'entretien simulées, un ordre du jour de kickoff, ou une version partageable). En mode travail de marque, dites quels fichiers logo et directives vous avez trouvés et ce que l'équipe devra demander.