포트폴리오 전략
핵심 원칙
여러분의 GitHub는 미완성 프로젝트의 묘지가 아닙니다. 큐레이션된 전시관입니다. 고정된 모든 리포지토리는 채용 담당자가 여러분에 대해 가지는 한 가지 질문에 답해야 하며, 모든 답변이 면접 일정을 잡고 싶게 만들어야 합니다.
인상적인 것과 평범한 것을 가르는 기준
평범한 포트폴리오 인상적인 포트폴리오
───────────────── ────────────────────
30개 리포지토리, 대부분 포크 5개 리포지토리, 모두 독창적 작업
README 없음 각 README가 스토리를 전달함
라이브 데모 없음 모든 프로젝트가 배포됨
복사한 무작위 튜토리얼 명확한 테마와 발전 과정
마지막 커밋: 8개월 전 일관되고 최근의 활동
리포지토리 설명 없음 모든 리포지토리에 한 줄 설명
"my-first-react-app" "AI 기반 코드 리뷰 도구"
차이는 재능이 아닙니다. 큐레이션입니다. 가장 좋은 포트폴리오는 계획이 있는 사람처럼 보이며, 닥치는 대로 커밋하는 사람처럼 보이지 않습니다.
양보다 질
3~5개의 완성된 프로젝트가 30개의 버려진 리포지토리를 이깁니다. 매번 그렇습니다.
중요한 수치
| 리포지토리 | README | 배포 | 채용 담당자의 생각 |
|---|---|---|---|
| 30 | 2 | 0 | "시작만 하고 끝내지 않는다" |
| 15 | 5 | 1 | "이것저것 건드린다. 뭘 잘하는지 불분명하다" |
| 5 | 5 | 4 | "집중력 있다. 출시한다. 자신의 기술을 안다" |
| 3 | 3 | 3 | "손대는 모든 것이 완성도 높다" |
정리 규칙
새로운 것을 추가하기 전에, 이미 있는 것을 감사하세요:
1. 미완성이고 복구 불가능한 것은 보관 처리하거나 비공개로 전환한다.
2. 수정하지 않은 포크 리포지토리는 삭제한다.
3. 공개로 유지할 모든 것에 README를 추가한다.
4. 모든 공개 리포지토리에 설명을 설정한다.
5. 남은 것은 보여줄 가치가 있어야 한다.
이력서에 넣지 않을 것이라면, 공개 GitHub에도 있어서는 안 됩니다.
리포지토리 전체에 스토리 전달하기
고정된 리포지토리는 무작위 샘플이 아닙니다. 챕터입니다. 방문자가 이야기를 볼 수 있도록 배열하세요.
효과적인 스토리 구조
전문가 아크:
"저는 AI/ML을 깊이 파고들며, 증명할 수 있습니다."
리포지토리 1: 특정 도메인 작업을 위해 미세 조정된 LLM
리포지토리 2: 평가 프레임워크를 갖춘 RAG 파이프라인
리포지토리 3: 도구 사용이 포함된 에이전틱 워크플로
리포지토리 4: LangChain/LlamaIndex에 대한 오픈소스 기여
풀스택 빌더 아크:
"데이터베이스부터 배포까지 완전한 제품을 구축합니다."
리포지토리 1: 풀스택 SaaS 앱 (Next.js + API + DB + Auth)
리포지토리 2: AI 기반 CLI 도구 (백엔드/시스템 역량을 보여줌)
리포지토리 3: 오픈소스 라이브러리 (API 설계 사고를 보여줌)
리포지토리 4: 개인 자동화 도구 (자신을 위해 만든다는 것을 보여줌)
AI 네이티브 개발자 아크:
"AI를 사용할 뿐만 아니라 AI로 구축하고 AI를 위해 구축합니다."
리포지토리 1: 에이전틱 워크플로 / 멀티에이전트 시스템
리포지토리 2: 프로덕션 등급 앱의 LLM 통합
리포지토리 3: AI를 활용하는 개발자 도구 (린터, 리뷰어, 생성기)
리포지토리 4: AI 프레임워크 또는 툴체인에 기여
발전 신호
채용 담당자는 리포지토리가 성장을 보여줄 때 주목합니다:
| 신호 | 의미 |
|---|---|
| 초기 리포지토리: 단순 CRUD 앱 | 어딘가에서 시작했습니다 |
| 중간 리포지토리: 테스트와 CI가 포함된 API | 엔지니어링 관행을 배웠습니다 |
| 최근 리포지토리: 평가 기능이 있는 AI 에이전트 | 최전선에서 구축하고 있습니다 |
| 주요 OSS 프로젝트에 기여 | 대규모 코드베이스에서 일할 수 있습니다 |
무엇을 고정할 것인가와 그 이유
고정할 수 있는 리포지토리는 6개입니다. 전략적으로 사용하세요.
이상적인 핀 배치
| 슬롯 | 고정할 내용 | 이유 |
|---|---|---|
| 1 | 풀스택 프로젝트 | 완전한 제품을 구축할 수 있음을 증명 |
| 2 | AI/ML 프로젝트 | 최전선에서 작업함을 보여줌 |
| 3 | 오픈소스 기여 | 실제 코드베이스에서 협업함을 증명 |
| 4 | 개발자 도구 또는 CLI | 자신의 문제를 해결함을 보여줌 |
| 5 | 도메인 프로젝트 (전문 분야) | 목표 역할에 대한 깊이 신호 |
| 6 | 와일드카드 — 개인적 또는 창의적 | 개성과 진정한 호기심을 보여줌 |
고정 규칙
고정할 것:
- 라이브 데모 또는 배포 링크가 있는 프로젝트
- 철저한 README와 스크린샷이 있는 리포지토리
- 지원하는 역할과 일치하는 작업
- 가장 최근의, 가장 완성도 높은 작업
고정하지 말 것:
- 의미 있게 수정하지 않은 포크 리포지토리
- 따라하기 튜토리얼 (완료했더라도)
- README가 없는 리포지토리
- 면접에서 설명할 수 없는 모든 것
포트폴리오 피치로서의 README
고정된 모든 리포지토리에는 30초 안에 프로젝트를 판매하는 README가 필요합니다. 채용 담당자는 계속 읽을지 결정하기 전에 그보다 더 적은 시간을 소비합니다.
포트폴리오 리포지토리를 위한 README 구조
# 프로젝트 이름
무엇을 하는지와 왜 중요한지에 대한 한 줄 설명.
## 데모
[라이브 데모 링크] | [동영상 둘러보기 링크]
앱이 작동하는 모습을 보여주는 스크린샷 또는 GIF.
## 문제
이것이 해결하는 문제는 무엇인가? 누가 이 문제를 가지고 있는가?
## 작동 방식
아키텍처 개요. 주요 기술적 결정.
시스템에 여러 구성 요소가 있는 경우 다이어그램.
## 기술 스택
기술 목록 — 의미 있는 것만 나열하세요.
HTML/CSS는 나열하지 마세요. AI 통합, 데이터베이스, 배포 대상을 나열하세요.
## 주요 기능
- 기능 1 — 기술적으로 흥미로운 이유
- 기능 2 — 구축할 때 어려웠던 점
- 기능 3 — 다음에 개선할 점
## 시작하기
명확한 설정 지침. 누군가가 5분 안에 실행할 수 있어야 합니다.
## 배운 점
가장 어려웠던 기술적 과제와 해결 방법에 대한 간략한 회고.
README 안티 패턴
| 나쁜 README | 더 나은 README |
|---|---|
| "React 앱" | "녹음을 실행 항목으로 바꾸는 AI 기반 회의 요약 도구" |
| 스크린샷 없음 | 접는 선 위에 히어로 스크린샷 또는 GIF |
| 설정: "클론하고 실행" | 설정: 사전 요구 사항과 함께 단계별 안내 |
| 아키텍처 설명 없음 | 구성 요소 연결 방식을 보여주는 시스템 다이어그램 |
| 모든 npm 패키지 나열 | 중요한 3-4개 기술 강조 |
라이브 데모 및 배포 링크
코드는 가설입니다. 배포된 앱은 증거입니다.
배포가 중요한 이유
채용 담당자가 데모 없는 리포지토리를 봄:
"흥미로운 코드네... 실제로 작동할까?"
채용 담당자가 라이브 링크가 있는 리포지토리를 봄:
"한번 써보자." → 2분 후 → "이 사람은 출시하는 사람이군."
프로젝트 유형별 배포 옵션
| 프로젝트 유형 | 무료 배포 | 적합한 대상 |
|---|---|---|
| 풀스택 웹 앱 | Vercel, Railway, Fly.io | 프로덕션 느낌의 앱 |
| API / 백엔드 | Railway, Render | 백엔드 기술 보여주기 |
| 정적 사이트 / 문서 | GitHub Pages, Netlify | 문서, 랜딩 페이지 |
| AI/ML 데모 | Hugging Face Spaces, Streamlit Cloud | 모델 데모, 데이터 앱 |
| CLI 도구 | npm publish, Homebrew tap | 배포 신호 |
배포할 수 없다면, 데모를 녹화하세요
모든 것을 클라우드에서 실행할 수 있는 것은 아닙니다. 로컬 전용 도구, CLI 앱 또는 복잡한 시스템의 경우:
1. 60~90초 분량의 동영상 둘러보기를 녹화합니다.
2. YouTube에 업로드합니다 (미공개도 괜찮습니다).
3. 주요 상호 작용의 GIF를 만듭니다.
4. README에 둘 다 넣습니다.
동영상 데모는 데모가 없는 것보다 10배 더 좋습니다.
기여 그래프
일관성이 주는 신호
채용 담당자는 기여 그래프를 훑어봅니다. 다음은 그들이 실제로 읽는 내용입니다:
| 패턴 | 해석 |
|---|---|
| 대부분 날짜에 꾸준한 녹색 | "이 사람은 정기적으로 코딩한다. 좋은 습관이다." |
| 프로젝트 주변에 클러스터 | "집중된 스프린트로 작업한다. 정상이다." |
| 주중에만 녹색 | "직장이 있지만, 개인 작업도 출시한다." |
| 자신의 리포지토리와 기여 혼합 | "협력적이다. 단독 프로젝트만 하지 않는다." |
조작해 보이는 것
경험 많은 검토자는 이것들을 즉시 알아챕니다:
위험 신호:
- 완벽하게 균일한 녹색 (매일, 동일한 강도)
- README 편집이나 공백 변경만 있는 커밋
- 하루에 빈 리포지토리에 500개의 커밋
- 한 주에 생성된 수십 개의 리포지토리, 모두 단일 커밋
- 자동 생성된 커밋 봇
그래프를 조작하는 것은 구멍이 있는 것보다 더 나쁩니다. 절박함과 나쁜 판단력을 신호합니다. 진정한 일관성은 간격이 있더라도 정기적인 리듬으로 관심 있는 일을 작업하는 것을 의미합니다.
실제 그래프 만들기
가짜로 만드는 대신:
1. 프로젝트 하나를 골라 하루 30분씩 작업합니다.
2. 오픈소스에 기여합니다 — 문서, 테스트, 버그 리포트도 괜찮습니다.
3. 노트와 실험을 커밋하는 학습 리포지토리를 유지합니다.
4. 실제로 사용하는 도구를 만듭니다. 자연스럽게 계속 개선하게 됩니다.
원하는 역할에 포트폴리오 맞추기
여러분의 포트폴리오는 채용된다면 하게 될 작업의 미리보기처럼 보여야 합니다. 목표에 맞게 조정하세요.
AI 네이티브 개발 역할
이러한 역할은 AI로 구축하고 AI를 위해 구축할 수 있음을 보고 싶어합니다:
| 신호 | 예시 리포지토리 |
|---|---|
| 워크플로에서 AI 도구 사용 | .claude/ 설정, AI 지원 커밋, Claude Code 슬래시 명령어가 있는 프로젝트 |
| 에이전틱 워크플로 | 연구, 계획, 실행하는 다단계 에이전트 |
| LLM 통합 | 구조화된 출력, 프롬프트 엔지니어링, 모델 라우팅이 있는 앱 |
| RAG 및 검색 | 임베딩 검색 및 평가 지표가 있는 지식 베이스 |
| 평가 및 테스트 | LLM 출력 평가 프레임워크, 프롬프트 회귀 테스트 |
| AI 지원 개발 | AI 도구가 개발을 가속화한 방법을 문서화한 프로젝트 README |
역할별 포트폴리오 목표
| 목표 역할 | 필수 리포지토리 | 있으면 좋은 것 |
|---|---|---|
| AI/ML 엔지니어 | 미세 조정된 모델, 평가 프레임워크, 데이터 파이프라인 | 논문 구현, 모델 비교 |
| 풀스택 AI 개발자 | LLM 통합 앱, RAG 시스템, 배포된 SaaS | 오픈소스 기여, CLI 도구 |
| 플랫폼 / 인프라 엔지니어 | CI/CD 파이프라인, IaC 리포지토리, 모니터링 설정 | 성능 벤치마크, OSS 기여 |
| 개발자 도구 / DX | CLI 도구, SDK/라이브러리, VS Code 확장 프로그램 | 문서 사이트, 개발자 커뮤니티 도구 |
포트폴리오 리뷰 체크리스트
모든 구직 전에 이 감사를 실행하세요. 솔직해지세요.
첫인상 (30초)
- 프로필 사진이 전문적이거나 (또는 의도적으로 독특함)
- 소개에 하는 일과 찾는 것이 명시되어 있음
- 고정된 리포지토리의 설명이 낯선 사람에게도 이해됨
- 고정된 리포지토리 중 최소 3개에 README에 스크린샷 또는 데모 링크가 있음
- 첫 페이지에 창피한 리포지토리 이름이 보이지 않음
깊이 확인 (2분)
- 각 고정 리포지토리에 무엇, 왜, 방법을 설명하는 README가 있음
- 최소 하나의 프로젝트에 라이브 데모 또는 배포 링크가 있음
- 고정된 리포지토리의 코드 품질이 현재 기술 수준을 반영함
- 커밋 기록이 실제 개발을 보여줌 (단일 "initial commit" 덩어리가 아님)
- 최소 하나의 리포지토리가 테스트 또는 CI/CD를 보여줌
스토리 확인 (5분)
- 고정된 리포지토리가 기술에 대한 일관된 스토리를 말함
- 오래된 프로젝트에서 최신 프로젝트로의 가시적인 발전이 있음
- 포트폴리오가 목표로 하는 역할과 일치함
- 60초 엘리베이터 피치로 각 고정 리포지토리를 설명할 수 있음
- 이 GitHub를 보고 자신을 채용할 의향이 있음
궁극적인 테스트
시크릿 창에서 GitHub를 열어보세요. 여러분을 한 번도 만난 적 없는 채용 담당자라고 가정하세요. 60초를 투자하세요. 이 지원자를 다음 라운드로 보내시겠습니까?
대답이 즉각적인 '예'가 아니라면, 계속 개선하세요.
안티 패턴
| 안티 패턴 | 해를 끼치는 이유 | 수정 방법 |
|---|---|---|
| 변경 없는 포크 리포지토리 | 부풀리기처럼 보임 | 삭제하거나 비공개로 전환 |
| 튜토리얼 클론 ("todo-app", "weather-app") | 구축할 수 있다는 신호가 아니라 지시를 따랐다는 신호 | 포크한 후 튜토리얼을 훨씬 넘어 확장 |
| 빈 리포지토리 또는 README만 있는 리포지토리 | 버려진 아이디어 신호 | 보관하거나 삭제 |
| 공개 리포지토리에 README 없음 | "내 작업에 대해 소통하지 않는다" | 공개로 유지하는 모든 것에 README 추가 |
| 큐레이션 없는 50개 이상의 공개 리포지토리 | 압도적인 소음, 신호 없음 | 적극적으로 보관하고, 전략적으로 고정 |
| 오래된 고정 리포지토리 (2년 이상) | "최근에 아무것도 구축하지 않았다" | 최근 작업을 보여주도록 핀 교체 |
| 자동 생성된 통계만 있는 프로필 README | 비인격적, 노력 부족 | 초점과 목표가 포함된 실제 소개 작성 |
| "test", "temp", "asdf"라는 이름의 리포지토리 | 부주의 | 이름 바꾸거나 제거 |
강력한 활용
"[GitHub URL]에서 내 GitHub 포트폴리오를 검토해 줘. AI 네이티브 개발 역할의 채용 담당자라고 생각하고 평가해 줘. 각 고정 리포지토리를 README 품질, 기술적 깊이, 배포 상태, AI/ML 역할 관련성에 대해 점수를 매겨 줘. 그런 다음 우선순위가 매겨진 실행 계획을 알려줘: 무엇을 보관할지, 무엇을 개선할지, 무엇이 빠졌는지, 어떤 새 프로젝트 하나가 가장 큰 차이를 만들지."
에이전트가 포트폴리오 비평가가 되어 — 코드 묘지를 경력 자산으로 바꾸는 데 필요한 정직하고 구체적인 피드백을 제공합니다.
관련 스킬
| 스킬 | 사용 시기 |
|---|---|
github-profile | GitHub 플랫폼 메커니즘 구현 — 프로필 README, 리포지토리 고정, 토픽, 활동 그래프 |
career-resume | 전체 경력 주기 — 구직, 면접, 온보딩, 성과 리뷰 |