Company Brief은(는) 무엇을 하나요?
회사 이름이나 URL을 입력하면 심층적이고 출처가 명시된 디자인 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를 클라이언트로 계약했는데, 그들의 브랜드에 대해 빠르게 파악해야 해."
- 회사: URL이 주어지면 회사 신원이 명확해집니다. 이름만 주어지면 불명확할 수 있습니다 (1단계).
- for <직무>: 해당 직무와 팀에 초점을 맞춘 채용, 알아야 할 사람, 면접 준비 정보를 제공합니다. 생략하면 디자인, 브랜드, 마케팅, 크리에이티브 리더십 또는 질문자의 배경에 맞춰 기본값이 설정됩니다.
- 개인 모드 (기본): 질문자를 위해 작성됩니다. 질문자에 대해 아는 정보(메모리, 과거 대화, 현재 대화, 첨부된 이력서나 포트폴리오)를 "당신의 관점", 피치, "당신에게 적합한 정도"에 사용합니다. 제안을 받은 상태라면 "서명 전 확인할 사항"을 추가합니다. 질문자에 대해 아는 것이 전혀 없으면 해당 부분을 일반적으로 작성하고, 응답에서 맞춤화를 제안합니다.
- 브랜드 작업 ("brand kit" 또는 질문자가 디자이너, 전략가, 에이전시, 인하우스 파트너로서 브랜드를 위해 디자인하거나, 피치하거나, 작업을 시작한다고 말하는 경우): 브랜드 정체성 및 브랜드 키트 섹션에 가장 많은 주의를 기울이며, 키트에는 전체 에셋 목록과 "클라이언트에게 요청할 사항" 콜아웃(참조/brand-extraction.md, 4항)이 포함됩니다. 5부에서 "면접 준비"는 "킥오프 준비"(브랜드 팀이 기대하는 사항, 준비할 것, 예상 질문), "질문할 사항"은 브랜드 팀을 위한 것으로 변경됩니다. "당신에게 적합한 정도"와 "서명 전 확인할 사항"은 삭제됩니다. 채용 정보는 짧은 단락으로 유지합니다.
- 공유 가능 ("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으로 동일하게 수행하며, Chrome CLI, WeasyPrint 순으로 대체 |
scripts/audit.js | 두 렌더러가 페이지 내에서 실행하는 감사 스크립트 |
scripts/contact_sheet.py | 레이아웃 확인을 위한 모든 페이지의 단일 이미지 |
references/research-playbook.md | 각 섹션을 어디서 찾을지와 효율적인 순서 |
references/brand-extraction.md | 라이브 사이트에서 실제 색상, 폰트, 로고 설명 추출 |
references/components.md | 모든 컴포넌트의 마크업, 섹션 순서, 작성 규칙 |
하드 룰
- 먼저 식별을 명확히 하세요. 많은 회사가 이름을 공유하며, 펀딩 데이터베이스와 구인 게시판에서 종종 병합됩니다. 각 재무 및 채용 정보가 올바른 회사(동일한 도메인, 창업자, 본사)에 속하는지 확인하세요. 충돌이 있는 경우 요약을 이름 확인 콜아웃으로 시작하세요.
- 모든 수치에는 출처, 날짜, 신뢰도 태그를 붙이세요:
Verified(1차 출처: 공시, 회사 자체 사이트 또는 채용 페이지),Reported(신뢰할 수 있는 언론),Company claim(회사의 마케팅),Estimate(제3자 또는 추론; 근거 명시),Unknown(검색했으나 찾지 못함; 검색 위치 명시). - 리서치를 진행하면서
research-notes.md에 기록하세요. 긴 리서치 중에는 검색 결과가 컨텍스트에서 지워집니다. 기록되지 않은 것은 손실됩니다. - 최신성: 오늘 날짜를 사용하세요; 뉴스 검색에는 연도를 포함하세요; 18개월 이상 된 정보는 오래된 것으로 표시하세요.
- 인물: 공개적인 리더와 직무와 관련된 사람들만 포함하며, 공개된 전문 정보만 사용합니다. 개인 연락처, 집 위치, 가족, 사진은 포함하지 마세요.
- 브랜드 에셋은 링크로만 제공하고, 절대 복사하지 마세요. 로고를 말로 설명하고 브랜드 자체 로고 파일 및 가이드라인에 링크하세요. 브리프나 작업 폴더에 로고, 마스코트, 폰트, 광고 이미지를 다시 그리거나, 추적하거나, 임베드하거나, 다운로드하지 마세요. 브랜드의 프레스 킷, 브랜드 포털 또는 가이드라인을 제3자 로고 사이트보다 선호하며, 각각을 구분하고, 각 파일의 형식을 열어서 확인하고, 파일을 관리하는 사용 약관에 링크하세요. 색상 견본, 서체 견본, 추상적인 브랜드 색상 패턴은 괜찮습니다.
- 인용구: 25단어 이하의 직원 리뷰 발췌문, 총 4개 이하, 플랫폼과 날짜를 명시합니다. 기사는 요약하고 그대로 붙여넣지 마세요.
- 독립적임을 표시: 표지에 "독립 리서치 브리프. <회사>와 제휴 또는 보증 관계가 아닙니다."라고 표시하세요.
- 누락된 내용은 섹션을 조용히 생략하지 말고 한 줄로 표시하세요.
- 실행하지 않은 확인을 절대 주장하지 마세요 ("이 브리프를 위해 Glassdoor만 검토했습니다." 등).
- 공유 가능한 브리프에는 질문자에 대한 개인 정보가 전혀 포함되어서는 안 됩니다.
워크플로우
이 작업 목록을 만들고 완료할 때마다 체크하세요:
- 회사 식별 및 이름 충돌 확인
- 작업 폴더 및 노트 파일 설정
- 회사 자체 사이트 및 채용 페이지 읽기
- 나머지 모든 정보를 병렬 배치로 리서치
- 브랜드 색상 및 서체 추출; 토큰 및 폰트 구축
- 브랜드 키트 구축: 로고 파일, 가이드라인, 폰트, 색상 사양
- 종합: 결론, 스코어카드, 소통 방법
- brief.html 작성
- 렌더링 및 감사
- 사실, 링크, 레이아웃 확인
- 전달
1. 식별
- URL이 주어짐: 홈페이지와 About 페이지를 엽니다. 이름이 주어짐:
"<name>" company와"<name>" official site를 검색합니다. - 브랜드 이름과 법인명, 도메인, 본사, 설립 연도, 창업자, 상장/비상장(티커), 모회사를 확정합니다.
"<name>" -<domain>을 검색하여 같은 이름의 다른 회사를 찾습니다.- 두 개 이상의 실제 회사가 그럴듯하게 일치하고 요청에서 구분할 수 없는 경우, 후보를 지명하는 한 가지 질문을 합니다. 그렇지 않으면 가장 적합한 것을 선택하고 답변 상단에 명시합니다.
- 개인 모드에서는 과거 채팅과 메모리(가능한 경우)에서 회사 이름도 검색합니다: 지원서, 리크루터 스레드, 제안 등은 중요도를 변경합니다.
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. 회사 자체 사이트 먼저
라이브 사이트와 채용 페이지는 브리프의 1/3을 답하며, 미션, 가치, 제품, 고객, 오피스, 공석, 급여, 면접 프로세스, 소셜 핸들, 브랜드 토큰에 대한 가장 신뢰할 수 있는 출처입니다.
- 브라우저 도구가 있는 경우 (Chrome의 Claude, 인앱 브라우저, 클라우드 브라우저), 회사의 도메인에 사용하세요; 요청 시 사이트 전체를 한 번 승인하세요. 로고와 히어로를 제외한 페이지는 스크린샷이 아닌 텍스트로 읽으세요.
- 순서대로 방문: 홈페이지(포지셔닝, 고객 로고, 푸터 핸들 및 링크) → About → Careers (부서 및 위치별 역할 수) → 타겟 역할에 가장 가까운 2-4개 공고 (급여, 면접 단계, 보고 체계, 도구) → Press/뉴스룸 (타임라인, 프레스 킷, 로고 파일, 브랜드 가이드라인) → 블로그/체인지로그 (최근 3개월) → 이벤트 → 고객.
- 방문 중에 홈페이지에서 브랜드 추출 스크립트를 실행하세요 (참조/brand-extraction.md, 1항).
- 브라우저 없음: fetch 도구로 같은 페이지를 가져오세요.
- 채용 페이지는 종종 오래된 잡보드 API보다 우선합니다. 플레이북의 ATS API 목록은 최후의 수단으로만 사용하세요.
세부사항: 참조/research-playbook.md, 1-2항.
4. 나머지 모든 것
참조/research-playbook.md 3-6항을 따르세요. 독립적인 검색을 한 번에 함께 보내세요 (펀딩, 수익, 뉴스, 리뷰, 경쟁사, 캠페인, 이벤트, 팟캐스트). 먼저 표준 검색을 사용하고, 최근 뉴스, 채용 및 리뷰 데이터, 또는 정보가 부족한 경우 확장 검색을 사용하세요. fetch 도구가 입력한 URL을 거부하면 검색하고 결과 링크를 가져오거나 브라우저에서 여세요. 잡 사이트(Indeed, ZipRecruiter, LinkedIn)용 커넥터가 있으면 평점과 역할에 유용합니다.
중간 규모 회사의 경우 40-80회 조회가 일반적입니다. 두 번의 좋은 검색 후에도 섹션이 부족하면 Unknown으로 표시하고 넘어가세요.
5. 브랜드 토큰 및 폰트
추출 결과로부터 (참조/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>라인을 FONT LINKS 마커에, tokens.html을 TOKENS 마커에 brief.html에 붙여넣으세요. - tokens.py 보고서의 모든 라인이
ok여야 합니다.WARNING은 다른 색상을 선택해야 함을 의미합니다 (밝은 시그니처 색상의 경우 어두운 색상을--brand로 만드세요). - 독점 브랜드 폰트: brand-extraction.md 2항의 대체 테스트를 실행하고 브리프에서 어떤 무료 폰트가 대체되었는지 명시하세요.
- npm이 폰트를 설치할 수 없는 경우 설치된 패밀리(
fc-list : family)를 사용하고 Type 섹션에 그렇게 명시하세요.
6. 브랜드 키트
참조/brand-extraction.md, 4항을 따르세요. 모든 모드에서 벡터 파일(SVG, EPS, AI 또는 벡터 PDF) 형태의 기본 로고와 가장 최근의 공개 브랜드 가이드라인을 찾으세요; 브랜드 작업 모드에서는 폰트, 색상 사양, 이미지, 템플릿, 기본 문구 및 사용 약관도 찾으세요. 검색을 함께 보내세요. 각 항목에 대해 링크, 열어서 확인한 형식, 출처(공식 또는 제3자), 날짜, 상태(Current, Dated, Outdated, Request access, Not found)를 기록하세요. 로고 파일이 오늘 라이브 사이트의 로고와 일치하는지 확인하세요.
7. 종합
전체 노트 파일을 읽은 후, 결론, 알아야 할 세 가지 사항, 스코어카드, 그들의 언어, 우선순위 → 핵심 포인트, 30초 피치, 관점, 면접 준비, 질문할 사항, 해야 할 것과 하지 말아야 할 것, 서명 전 확인할 사항(제안이 있는 경우에만), 아웃리치를 결정하세요. 각각에 대한 지침: 참조/research-playbook.md 7항.
8. brief.html 작성
템플릿의 모든 {{placeholder}}를 교체하고, 필요에 따라 행과 항목을 추가하며, 템플릿이 조건부로 표시하는 섹션만 삭제하세요. 마크업 및 작성 규칙: 참조/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의 모든 수치가 노트 파일과 일치하고, 태그가 있으며, 출처에 나타납니다. 날짜는 절대적입니다. 다른 같은 이름의 회사 정보가 섞여 있지 않습니다.
- 카피: 텍스트에 대해 참조/components.md 작성 규칙을 다시 한 번 읽으세요.
- 링크: 출처 링크 중 5개 이상을 열어서 작동하는지 확인하고, 모든 브랜드 키트 링크를 열어서 나열된 형식으로 확인되는지 확인하세요.
11. 전달
- PDF를 파일로 보내세요. 브랜드 작업 모드에서는
<회사>-Brand-Kit.md도 보내세요: 일반 링크로 된 키트 테이블로, 프로젝트 문서나 채널에 바로 붙여넣을 수 있습니다. 사용자가 브리프를 컴퓨터의 특정 폴더에 보관하고 있고 접근할 수 있으면 거기에도 저장하세요. - 몇 줄로 답변하세요: 결론을 두 문장으로, 가장 날카로운 2-3개의 핵심 포인트, 찾지 못한 중요한 사항, 그리고 유용한 다음 단계 하나(맞춤형 커버 레터, 아웃리치 노트, 모의 면접 질문, 킥오프 의제, 또는 공유 가능한 버전)를 제시하세요. 브랜드 작업 모드에서는 찾은 로고 및 가이드라인 파일과 팀이 요청해야 할 사항을 설명하세요.