프론트엔드 이력서
브라우저에서 완전히 실행되는, 의존성이 없는 애니메이션 HTML 이력서 페이지를 만듭니다. 사용자가 시각적 탐색을 통해 선호하는 미학을 발견하고, 프로덕션 품질의 인터랙티브 이력서를 생성할 수 있도록 도와줍니다.
핵심 철학
- 의존성 제로 — CSS/JS가 인라인으로 포함된 단일 HTML 파일. npm이나 빌드 도구가 필요 없습니다.
- 보여주고, 말하지 마세요 — 시각적 미리보기를 생성하고, 사용자가 마음에 드는 것을 선택하게 합니다.
- 독특한 디자인 — 일반적인 'AI 슬롭' 미학을 피합니다. 각 이력서는 맞춤 제작된 느낌을 줍니다.
- 인쇄 친화적 — 모든 이력서는 깔끔한 PDF 출력을 위해
@media print스타일을 반드시 포함해야 합니다. - 접근성 — 시맨틱 HTML, 키보드 내비게이션, 축소된 동작 지원, WCAG AA 대비.
0단계: 모드 감지
사용자가 원하는 것이 무엇인지 파악합니다:
모드 A: 파일에서 — 사용자가 이력서 파일(.pdf, .docx, .md, .txt, .json)을 제공합니다 → 1단계 모드 B: 텍스트에서 — 사용자가 이력서 내용을 텍스트로 제공합니다 → 1단계 모드 C: 개선 — 사용자가 개선할 기존 HTML 이력서를 가지고 있습니다 → 파일을 읽은 후 2단계
1단계: 콘텐츠 추출 및 구조화
1.1단계: 파일 추출 (모드 A만 해당)
사용자 이력서 파일에서 scripts/extract_resume.py를 실행합니다:
python [skill-dir]/scripts/extract_resume.py <resume_file>
지원되는 형식 및 의존성:
| 형식 | 확장자 | Python 의존성 | 참고 사항 |
|---|---|---|---|
pdfplumber(권장) 또는 PyPDF2 | pip install pdfplumber | ||
| Word | .docx | python-docx | pip install python-docx |
| 마크다운 | .md | 없음 | 제목, 목록, 굵게/기울임꼴 구문 분석 |
| 일반 텍스트 | .txt | 없음 | 대문자 라인은 제목으로 추론 |
| JSON Resume | .json | 없음 (내장 json) | jsonresume.org 스키마; 이미 구조화되어 있음 — 1.2단계를 건너뛸 수 있음 |
필요한 의존성이 없으면 스크립트가 설치 안내를 출력합니다.
추출된 콘텐츠를 사용자에게 확인을 위해 제시합니다. JSON Resume 파일의 경우 데이터가 이미 구조화되어 있으므로 — 매핑된 섹션을 직접 제시하고, 사용자가 조정을 원하지 않으면 1.3단계로 건너뜁니다.
1.2단계: 콘텐츠 구조화
원시 텍스트를 구조화된 섹션으로 구문 분석합니다:
- header: 이름, 직함/태그라인, 위치, 연락처(이메일, 전화, LinkedIn, GitHub, 포트폴리오)
- about: 전문 요약
- experience[]: 회사, 역할, 날짜, 위치, 항목
- education[]: 학교, 학위, 날짜, 영예/GPA
- skills{}: 카테고리별로 그룹화되고 선택적 숙련도 수준(0-100) 포함
- projects[]: 이름, 설명, 기술 스택, 링크
- certifications[]: 이름, 발급 기관, 날짜(선택 사항)
- languages[]: 언어, 숙련도(선택 사항)
구조화된 콘텐츠를 사용자에게 검토를 위해 제시합니다. "이 내용이 맞습니까? 추가, 제거 또는 수정할 섹션이 있습니까?"라고 물어봅니다.
1.3단계: 섹션 우선순위
AskUserQuestion을 통해 질문합니다:
- 헤더: "레이아웃"
- 질문: "어떤 섹션을 가장 눈에 띄게 할까요?"
- 옵션:
- "경험 중심" — 업무 경험이 핵심 (시니어 전문가)
- "기술 중심" — 기술 역량이 전면에 (개발자/엔지니어)
- "프로젝트 중심" — 포트폴리오/프로젝트가 주목 (디자이너/프리랜서)
- "균형 잡힌" — 모든 섹션에 동일한 가중치
2단계: 스타일 발견
2.0단계: 스타일 경로
질문: "이력서 스타일을 어떻게 선택하시겠습니까?"
- "옵션 보여주기" — 3개의 시각적 미리보기 생성 (권장) → 2.1단계
- "원하는 것을 알고 있습니다" — 사전 설정 목록에서 직접 선택 → 아래 사전 설정 선택기 표시
사용 가능한 사전 설정:
| 사전 설정 | 분위기 | 가장 적합한 대상 |
|---|---|---|
| 미드나잇 아키텍트 | 정교함, 프리미엄 | 임원, 컨설턴트 |
| 네온 터미널 | 해커-시크, 개발자 지향 | 소프트웨어 엔지니어, DevOps |
| 다크 럭스 | 우아함, 편집 스타일 | 크리에이티브 디렉터, 마케팅 |
| 코스믹 뎁스 | 대담함, 미래지향적 | 기술 창업자, AI/ML 엔지니어 |
| 클린 슬레이트 | 미니멀, 스위스 디자인 | 디자이너, 제품 관리자 |
| 페이퍼 크래프트 | 따뜻함, 촉각적 | 작가, 교육자, 학자 |
| 소프트 블루프린트 | 기술적, 친근함 | 엔지니어, 데이터 과학자 |
| 브루털리스트 모노 | 투박함, 안티-디자인 | 브랜드 전략가, 눈에 띄고 싶은 사람 |
| 세이지 가든 | 자연에서 영감, 차분함 | HR, 웰니스, 교육자 |
| 레트로 잉크 | 빈티지 편집 스타일 | 저널리스트, 개인 브랜드 |
사용자가 직접 선택하면 3단계로 건너뜁니다.
2.1단계: 가이드 발견
질문 1 — 분위기 (최대 2개 다중 선택):
- "전문적/권위적" — 확립되고 신뢰할 수 있음
- "창의적/독특함" — 독특하고 디자인 중심
- "모던/기술적" — 깔끔하고 개발자 지향
- "따뜻함/친근함" — 친근하고 호감 가는
질문 2 — 톤:
- "라이트" — 깔끔하고 인쇄 가능
- "다크" — 대담하고 화면에 최적화
- "어느 쪽이든" — 스타일이 결정하게 함
2.2단계: 미리보기 3개 생성
분위기 + 톤에 따라 사전 설정 3개를 선택합니다. 전체 사전 설정 정의는 references/STYLE_PRESETS.md를 참조하세요.
분위기-사전 설정 매핑:
| 분위기 | 다크 | 라이트 | 스페셜티 |
|---|---|---|---|
| 전문적 | 미드나잇 아키텍트, 다크 럭스 | 클린 슬레이트, 소프트 블루프린트 | — |
| 창의적 | 다크 럭스, 코스믹 뎁스 | 페이퍼 크래프트 | 브루털리스트 모노, 레트로 잉크 |
| 모던/기술적 | 네온 터미널, 코스믹 뎁스 | 소프트 블루프린트 | 브루털리스트 모노 |
| 따뜻함 | 다크 럭스 | 페이퍼 크래프트, 세이지 가든 | 레트로 잉크 |
.claude-design/resume-previews/ 디렉토리에 미니 HTML 미리보기 3개를 생성합니다:
.claude-design/resume-previews/
├── style-a.html
├── style-b.html
└── style-c.html
각 미리보기: 자체 포함됨 (~80-120줄), 히어로 섹션 + 경험 항목 하나 + 기술 막대를 보여줍니다. 미학을 전달하기에 충분합니다.
절대 사용하지 말아야 할 일반적인 패턴:
- Inter, Roboto, Arial을 디스플레이 폰트로 사용
- 흰색 바탕에 보라색 그라데이션, 진부한 남색
#6366f1 - 변형 없이 모든 것을 중앙 정렬
- 과도한 글래스모피즘
2.3단계: 선택
미리보기를 제시하고, 사용자에게 하나를 선택하거나 요소를 혼합하도록 요청합니다.
3단계: 이력서 생성
선택한 사전 설정에 대해 다음 참조 파일을 읽습니다:
references/STYLE_PRESETS.md— 전체 CSS 변수, 글꼴 URL, 색상 팔레트, 애니메이션 스타일references/RESUME_COMPONENTS.md— 인터랙티브 구성 요소 CSS/JS 패턴references/HTML_ARCHITECTURE.md— 기본 HTML 템플릿, 필수 CSS, JS 아키텍처, 인쇄 스타일, 접근성 체크리스트
출력
자체 포함된 단일 HTML 파일을 생성합니다:
- 모든 CSS는
<style>에 인라인 - 모든 JS는
<script>에 인라인 - Google Fonts / Fontshare는
<link>를 통해 (품위 있게 저하 가능) - 시맨틱 HTML5 구조
필수 기능
- 스크롤 트리거 공개 — IntersectionObserver를 통해 요소가 애니메이션으로 나타남
- 부동 탐색 — 활성 섹션 추적 기능이 있는 고정 탐색
- 애니메이션 기술 막대 — 보이는 영역으로 스크롤될 때 채워짐
- 스크롤 진행률 표시줄 — 상단의 얇은 막대
- 맨 위로 가기 버튼 — 스크롤 후 나타남
- 인쇄 스타일시트 — 흰색 배경, 애니메이션 없음, 표시되는 URL이 있는
@media print - 축소된 동작 —
@media (prefers-reduced-motion: reduce)는 애니메이션을 비활성화함 - 반응형 — 모든 크기가
clamp()를 사용하며, 모바일에서 데스크톱까지 작동
확인 체크리스트
전달하기 전에 다음을 확인합니다:
- 모든 타이포그래피가
clamp(min, preferred, max)를 사용 - 모든 간격이
clamp()또는 뷰포트 단위를 사용 - 시맨틱 HTML (
<header>,<main>,<section>,<nav>) - 인쇄 스타일이 포함되고 기능함
- 축소된 동작이 존중됨
- 탐색, 버튼, 진행률 표시줄에 ARIA 레이블
- 색상 대비가 WCAG AA를 충족
- 외부 링크에
target="_blank" rel="noopener"가 있음
4단계: 전달
- 정리 —
.claude-design/resume-previews/디렉토리가 있으면 삭제합니다. - 열기 — 브라우저에서 실행:
open [filename].html - 요약:
인터랙티브 이력서가 준비되었습니다!
파일: [filename].html
스타일: [스타일 이름]
섹션: [목록]
기능:
- 스크롤 트리거 애니메이션
- 애니메이션 기술 막대
- 인터랙티브 타임라인
- 부동 탐색
- 인쇄 친화적 (Ctrl+P)
- 모든 화면 크기에서 반응형
맞춤 설정하려면:
- 색상: 상단의 :root CSS 변수 수정
- 글꼴: 글꼴 가져오기 링크 변경
- 애니메이션: .reveal 클래스 타이밍 수정
- 콘텐츠: HTML에서 직접 텍스트 편집
조정이 필요하신가요?
문제 해결
PDF 추출 시 텍스트가 거의 없음: PDF가 이미지 기반(스캔)일 수 있습니다. 사용자에게 텍스트 콘텐츠를 직접 제공하도록 요청하세요.
DOCX 추출 시 구조 누락: 일부 DOCX 파일은 표준 제목 스타일(Heading 1/2/3)을 사용하지 않습니다. 추출기는 개별 실행의 글꼴 크기로 대체합니다. 구조가 여전히 불명확하면, 사용자에게 어떤 줄이 섹션 헤더인지 확인하도록 요청하세요.
JSON Resume 필드 누락: JSON이 선택적 섹션(프로젝트, 자격증 등)을 생략할 수 있습니다. 사용 가능한 항목을 제시하고 사용자에게 누락된 섹션을 수동으로 추가할지 물어보세요.
마크다운 프론트매터 간섭: YAML 프론트매터 구분 기호(---)는 자동으로 건너뜁니다. 이력서 콘텐츠 자체가 ---를 수평선으로 사용하는 경우에도 건너뛰며, 이는 일반적으로 무해합니다.
글꼴이 로드되지 않음: 글꼴 URL을 확인하세요. font-family 선언에 시스템 글꼴 대체가 포함되어 있는지 확인하세요.
애니메이션이 트리거되지 않음: IntersectionObserver가 초기화되었는지 확인하세요. .visible 클래스가 추가되고 있는지 확인하세요.
인쇄 출력이 잘못됨: @media print 블록이 있는지 확인하세요. 애니메이션이 비활성화되고 배경이 흰색인지 확인하세요.