BeautifulEngine/company-brief

Company Brief

Transforme um nome ou URL de empresa em um PDF profundo, com fontes e design personalizado, que conta ao leitor tudo o que ele precisa saber para entrar em uma entrevista, conversa sobre proposta, pitch para cliente ou primeiro projeto com uma nova marca: o que a empresa é, como ela está, quem a comanda, como é trabalhar lá, como funcionam sua marca e marketing, quem são seus concorrentes e como falar com ela. O PDF usa as cores e a tipografia da própria empresa, parecendo que pertence a ela.

Uso

/company-brief <nome ou URL da empresa> [para <cargo>] [kit de marca] [compartilhável]

Exemplos: /company-brief linear.app, /company-brief Figma para Senior Brand Designer, /company-brief patagonia.com kit de marca, /company-brief Notion compartilhável. Pedidos simples também funcionam: "faça um briefing da Notion antes da minha entrevista" ou "acabamos de fechar a Oatly como cliente, preciso me atualizar sobre a marca deles."

• Empresa: uma URL resolve a identidade. Um nome sozinho pode não resolver (Passo 1).
• para : foca contratação, pessoas relevantes e preparação para entrevista naquele cargo e equipe. Sem isso, o padrão é design, marca, marketing e liderança criativa, ou o que o histórico da pessoa sugerir.
• Modo pessoal (padrão): escrito para a pessoa que pergunta. Use o que sabe sobre ela (memória, conversas passadas, esta conversa, um currículo ou portfólio anexado) para "Seu ângulo", o pitch e "Adequação para você". Se houver uma proposta em mãos, adicione "Antes de assinar". Se não souber nada sobre a pessoa, escreva essas partes de forma genérica e ofereça na resposta personalizá-las.
• Trabalho com marca ("kit de marca", ou a pessoa diz que está projetando, apresentando ou começando a trabalhar com a marca como designer, estrategista, agência ou parceiro interno): as seções Identidade da marca e Kit de marca recebem mais cuidado, e o kit inclui a lista completa de ativos e o destaque "Pergunte ao cliente" (references/brand-extraction.md, seção 4). Na parte cinco, "Preparação para entrevista" vira "Preparação para kickoff" (o que a equipe de marca esperará, o que levar, perguntas prováveis), "Perguntas a fazer" são para a equipe de marca, e Adequação para você e Antes de assinar são removidos. Mantenha Contratação em um parágrafo curto.
• Compartilhável ("compartilhável", "para um amigo", "para enviar a alguém"): nada sobre a pessoa. Sem pílula "Preparado para", sem pontuação de adequação, sem Antes de assinar. A parte cinco vira "Como falar com eles" e "Seu ângulo" vira "Ângulos que funcionam".

Não pare para fazer perguntas a menos que a identidade da empresa seja genuinamente ambígua. Comece na primeira resposta: uma frase sobre o que está fazendo, a lista de tarefas e, em seguida, a pesquisa.

Arquivos da skill

Os caminhos abaixo usam ${CLAUDE_SKILL_DIR}. Se esse texto não for substituído por um caminho real onde você está executando, encontre a pasta uma vez com find / -name brief-template.html -path '*company-brief*' 2>/dev/null | head -1 e use seu caminho absoluto em cada comando (as variáveis de shell podem não persistir entre comandos).

Arquivo	Para que serve
assets/brief.css	Folha de estilo base. Copie-a; não a edite.
assets/brief-template.html	Esqueleto de todo o briefing com {{placeholders}}
scripts/fonts.py	Instala fontes gratuitas do Fontsource e imprime tags <link>
scripts/tokens.py	Transforma as cores da marca no bloco <style> de tokens, com correções de contraste
scripts/render.cjs	Renderiza o PDF com Node Playwright e audita fontes, contraste, placeholders
scripts/render.py	O mesmo em Python, com fallback para Chrome CLI e depois WeasyPrint
scripts/audit.js	A auditoria que ambos os renderizadores executam dentro da página
scripts/contact_sheet.py	Uma imagem de cada página para verificar o layout
references/research-playbook.md	Onde procurar cada seção e a ordem eficiente
references/brand-extraction.md	Como obter cores, fontes e descrição do logotipo reais do site ativo
references/components.md	Marcação para cada componente, ordem das seções, regras de redação

Regras rígidas

• Desambiguar primeiro. Muitas empresas compartilham nomes, e bancos de dados de financiamento e sites de empregos frequentemente as mesclam. Confirme se cada fato financeiro e de contratação pertence à entidade correta (mesmo domínio, fundadores, sede). Se houver uma colisão, abra o resumo com um destaque Verificação de nome.
• Cada número tem uma fonte, uma data e uma tag de confiança: Verificado (primário: arquivos, site oficial ou página de carreiras da empresa), Relatado (imprensa confiável), Alegação da empresa (marketing deles), Estimativa (terceiros ou sua inferência; diga a partir do quê), Desconhecido (pesquisou, não encontrou; diga onde).
• Escreva os achados em research-notes.md conforme avança. Os resultados de pesquisa são limpos do contexto em pesquisas longas. Qualquer coisa não escrita se perde.
• Atualidade: use a data de hoje; coloque o ano nas pesquisas de notícias; marque qualquer coisa com mais de 18 meses como desatualizada.
• Pessoas: líderes públicos e pessoas relevantes para o cargo, apenas com informações profissionais públicas. Sem dados de contato pessoais, endereços residenciais, familiares ou fotos de pessoas.
• Ativos de marca são links, nunca cópias. Descreva o logotipo em palavras e vincule aos arquivos de logotipo e diretrizes da própria marca. Não redesenhe, trace, incorpore ou baixe logotipos, mascotes, fontes ou imagens de anúncios no briefing ou na pasta de trabalho. Prefira o kit de imprensa, portal de marca ou diretrizes da marca em vez de sites de terceiros, rotule qual é qual, confirme o formato de cada arquivo abrindo-o e vincule os termos de uso que regem os arquivos. Amostras de cores, espécimes de tipo e padrões abstratos nas cores da marca são aceitáveis.
• Citações: trechos de avaliações de funcionários com 25 palavras ou menos, no máximo 4 no total, atribuídos à plataforma e data. Resuma artigos; não os cole.
• Rotule como independente: a capa diz "Briefing de pesquisa independente. Não afiliado ou endossado por ."
• Diga o que está faltando em uma linha, em vez de omitir uma seção silenciosamente.
• Nunca afirme uma verificação que você não fez ("Apenas o Glassdoor foi revisado para este briefing").
• Briefings compartilháveis não contêm nada privado sobre a pessoa que perguntou, mesmo que você saiba.

Fluxo de trabalho

Crie esta lista de tarefas e marque os itens conforme os concluir:

1. Identificar a empresa e verificar colisões de nome
2. Configurar a pasta de trabalho e o arquivo de notas
3. Ler o site próprio da empresa e as páginas de carreiras
4. Pesquisar todo o resto em lotes paralelos
5. Extrair cores e tipo da marca; construir tokens e fontes
6. Construir o kit de marca: arquivos de logotipo, diretrizes, fontes, especificações de cores
7. Sintetizar: conclusão, scorecard, como falar com eles
8. Escrever brief.html
9. Renderizar e auditar
10. Verificar fatos, links e layout
11. Entregar

1. Identificar

• URL fornecida: abra a página inicial e a página Sobre. Nome fornecido: pesquise "<nome>" empresa e "<nome>" site oficial.
• Identifique o nome da marca e o nome legal, domínio, sede, ano de fundação, fundadores, público ou privado (código), controladora.
• Pesquise "<nome>" -<domínio> por empresas com o mesmo nome.
• Se duas ou mais empresas reais corresponderem de forma plausível e nada no pedido as diferenciar, faça uma pergunta nomeando os candidatos. Caso contrário, escolha a melhor correspondência e declare-a no topo de sua resposta.
• No modo pessoal, pesquise também conversas passadas e memória (se disponível) pelo nome da empresa: uma candidatura, thread de recrutador ou oferta mudam o que importa.

2. Pasta de trabalho

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

Use o diretório de trabalho atual ou uma pasta temporária se não for gravável. Crie research-notes.md com um cabeçalho por seção do briefing e anexe os achados como - <fato> | <tag> | <título da fonte> | <URL> | <data>.

3. O site próprio da empresa primeiro

O site ativo e as páginas de carreiras respondem a um terço do briefing e são a fonte mais confiável para missão, valores, produtos, clientes, escritórios, vagas abertas, remuneração, processo de entrevista, contatos sociais e tokens de marca.

• Se você tiver uma ferramenta de navegador (Claude no Chrome, navegador no aplicativo ou navegador em nuvem), use-a para o domínio da empresa; aprove o site inteiro uma vez se for solicitado. Leia as páginas como texto, não como capturas de tela, exceto para o logotipo e o hero.
• Visite, em ordem: página inicial (posicionamento, logotipos de clientes, handles e links do rodapé) → Sobre → Carreiras (conte as vagas por departamento e localização) → 2 a 4 anúncios mais próximos do cargo alvo (remuneração, etapas da entrevista, linha de reporte, ferramentas) → Imprensa/sala de notícias (linha do tempo, kit de imprensa, arquivos de logotipo, diretrizes de marca) → Blog/changelog (últimos 3 meses) → Eventos → Clientes.
• Execute o script de extração de marca na página inicial enquanto estiver lá (references/brand-extraction.md, seção 1).
• Sem navegador: busque as mesmas páginas com a ferramenta de busca.
• A página de carreiras supera as APIs de sites de emprego, que geralmente estão desatualizadas. Use a lista de APIs de ATS no playbook apenas como fallback.

Detalhes: references/research-playbook.md, seções 1–2.

4. Todo o resto

Siga as seções 3–6 de references/research-playbook.md. Envie pesquisas independentes juntas em uma rodada (financiamento, receita, notícias, avaliações, concorrentes, campanhas, eventos, podcasts). Use a pesquisa padrão primeiro e a pesquisa estendida para notícias recentes, dados de contratação e avaliações, ou qualquer coisa escassa. Se uma ferramenta de busca recusar uma URL que você digitou, pesquise por ela e busque o link do resultado, ou abra-a no navegador. Conectores para sites de emprego (Indeed, ZipRecruiter, LinkedIn), se presentes, são bons para avaliações e vagas.

40 a 80 consultas é normal para uma empresa de médio porte. Quando uma seção permanecer escassa após duas boas pesquisas, marque-a como Desconhecido e siga em frente.

5. Tokens de marca e fontes

Da extração (references/brand-extraction.md):

python3 "${CLAUDE_SKILL_DIR}/scripts/fonts.py" "<Fonte de Título>:400,500,600" "<Fonte de Corpo>:400,600" "<Fonte de Rótulo>:400,500"
python3 "${CLAUDE_SKILL_DIR}/scripts/tokens.py" --brand "#…" --accent "#…" \
  --font-display "<Fonte de Título>" --font-body "<Fonte de Corpo>" --font-label "<Fonte de Rótulo>" \
  --display-weight 600 --tracking -0.02em --radius 8px \
  --footer "<Empresa> · Company Brief · <Mês AAAA>" [--cover-stops "#…,#…,#…"] > tokens.html

• Cole as linhas <link> de fonts.py no marcador FONT LINKS e tokens.html no marcador TOKENS em brief.html.
• Cada linha do relatório de tokens.py deve dizer ok. Um WARNING significa escolher cores diferentes (para uma cor clara de assinatura, torne a escura --brand).
• Fonte de marca proprietária: execute o teste de substituto na seção 2 de brand-extraction.md e diga no briefing qual fonte gratuita a substitui.
• Se o npm não puder instalar fontes, use uma família instalada (fc-list : family) e diga isso na seção Tipo.

6. Kit de marca

Siga references/brand-extraction.md, seção 4. Em todos os modos, encontre o logotipo principal como arquivo vetorial (SVG, EPS, AI ou PDF vetorial) e as diretrizes de marca públicas mais recentes; no modo de trabalho com marca, também fontes, especificações de cores, imagens, modelos, texto padrão e termos de uso. Envie as pesquisas juntas. Para cada item, registre o link, o formato confirmado ao abri-lo, a fonte (oficial ou terceiros), sua data e um status: Atual, Desatualizado, Obsoleto, Solicitar acesso ou Não encontrado. Verifique se o arquivo de logotipo corresponde ao logotipo no site ativo hoje.

7. Sintetizar

Leia todo o arquivo de notas e, em seguida, decida a conclusão, as três coisas a saber, o scorecard, a linguagem deles, prioridades → pontos de discussão, o pitch de 30 segundos, o ângulo, preparação para entrevista, perguntas a fazer, o que fazer e o que não fazer, antes de assinar (apenas oferta) e abordagem. Orientações para cada um: references/research-playbook.md seção 7.

8. Escrever brief.html

Substitua cada {{placeholder}} no modelo, adicione linhas e itens conforme necessário e exclua apenas as seções que o modelo marca como condicionais. Regras de marcação e redação: references/components.md. Mantenha o CSS específico do briefing pequeno e no bloco de substituição do modelo. Busque 14 a 20 páginas.

9. Renderizar e auditar

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

• O renderizador Node sai com código 2 se o Playwright estiver ausente, o que aciona o Python. render.py tenta Playwright, depois um binário do Chrome e depois WeasyPrint (pip install weasyprint).
• Corrija cada linha FAIL (fonte não carregada, texto com contraste abaixo de 4.5:1, placeholder restante) e renderize novamente.
• Se você estiver no computador de outra pessoa e nada renderizar, pergunte antes de instalar um renderizador (pip install playwright && python -m playwright install chromium).

10. Verificar

• Layout: python3 "${CLAUDE_SKILL_DIR}/scripts/contact_sheet.py" <pdf> sheet.png, depois olhe a imagem. A capa é full bleed sem rodapé; o resumo cabe na página 2; cada parte começa em uma nova página; nada está cortado; nenhuma tabela transborda; nenhuma página quase vazia; nenhum cabeçalho está isolado no final de uma página. Renderize uma página duvidosa maior com pdftoppm -r 150 -f N -l N -png <pdf> page e veja novamente.
• Fatos: cada número no PDF corresponde ao arquivo de notas, carrega uma tag e aparece em Fontes. As datas são absolutas. A outra empresa de mesmo nome não está misturada.
• Cópia: leia as regras de redação de references/components.md mais uma vez em relação ao texto.
• Links: abra 5 ou mais links de Fontes para confirmar que resolvem, e abra cada link do Kit de marca para confirmar que resolve para o formato listado.

11. Entregar

• Envie o PDF como arquivo. No modo de trabalho com marca, envie também <Empresa>-Brand-Kit.md: a tabela do kit como links simples, pronta para colar em um documento de projeto ou canal. Se a pessoa mantiver briefings em uma pasta em seu computador e você puder acessá-la, salve lá também.
• Responda em poucas linhas: a conclusão em duas frases, os 2 a 3 pontos de discussão mais relevantes, qualquer coisa importante que você não conseguiu encontrar e um próximo passo útil (uma carta de apresentação personalizada, uma nota de abordagem, perguntas simuladas de entrevista, uma pauta de kickoff ou uma versão compartilhável). No modo de trabalho com marca, diga quais arquivos de logotipo e diretrizes você encontrou e o que a equipe precisará solicitar.