---
name: career-portfolio
description: >
  한국 신입 취준생·재직자를 위한 분야별 포트폴리오 구성과 프로젝트 기술서 작성 스킬입니다.
  "포트폴리오 만들어줘", "프로젝트 정리해줘", "노션 포트폴리오 구성해줘"처럼 말하면 됩니다.
  개발(GitHub·기술 블로그)/디자인(Figma·Behance)/마케팅/기획 분야별 + 검색되는 노션
  포트폴리오 + 채용공고 맞춤형 1page 소개서와 프로젝트별 비중 조정을 지원합니다.
metadata:
  version: "1.1.5"
---

# 포트폴리오 가이드 (career-portfolio)

> 지원 직무와 채용공고에 맞춰 실제 프로젝트의 문제·본인 기여·결과를 보여줍니다. 공개 포트폴리오는 공유 범위와 제3자 정보를 확인한 뒤 게시합니다.

## 지원 영역

| 영역 | 설명 |
|------|------|
| 분야별 가이드 | 개발자, 디자이너, 마케터, 기획자 맞춤 포트폴리오 전략 |
| 프로젝트 기술서 | STAR 기반 프로젝트 설명, 기여도 정량화 |
| 플랫폼 최적화 | GitHub, Behance, Notion, 개인 블로그 포트폴리오 |
| 포트폴리오 리뷰 | 기존 포트폴리오 개선점 분석 및 피드백 |

참조 가이드: `references/portfolio-by-field.md`

## 실전 포트폴리오 패턴 (한국 채용 시장)

### 1. 내용 중심의 간결한 구성 예시

채용공고의 평가 기준에 맞춰 문제·본인 기여·검증 가능한 결과를 읽기 쉽게 정리합니다.

```
[1] 한 줄 요약 (USP)
[2] 프로젝트 5개 (각 1페이지)
[3] 각 프로젝트:
    - 배경 (1줄)
    - 본인 역할 (1줄)
    - 한 일 3~5 bullet
    - 정량 결과 (숫자·배수·증감)
[4] 전체 6~10페이지 압축
```

형식보다 내용의 근거와 가독성을 먼저 점검합니다. 제출 형식은 채용공고를 따릅니다.

### 2. 노션 포트폴리오 기본 구조

빠르게 만드는 6 섹션 구조:

```
[1] 한 줄 자기소개 + 사진
[2] About — 경력 한 단락
[3] Skills — 기술·도구 5~7개
[4] Projects — 3~5 카드 (썸네일 + 한 줄 + 링크)
[5] Experience — 회사·기간·역할
[6] Contact — 이메일·LinkedIn·GitHub
```

템플릿이나 커스텀 도메인은 필요할 때 선택합니다. 구성에 걸리는 시간은 준비된 자료와 작업 범위에 따라 다릅니다.

### 3. 채용공고 맞춤형 포트폴리오 (남들과 다른 핵심)

- **JD 키워드 빈도 분석** → 본인 프로젝트 중 매칭 3-5개 선택
- **회사 톤·스타일 분석** → 본인 포트폴리오 디자인 조정
- **회사 최근 이슈 반영** → 본인 경험과 연결되는 케이스 강조
- **JD에 없지만 도움될 것** 1-2개 추가 (차별화)

### 4. PM 포트폴리오의 차별점

PM은 결과물이 추상적 — 구체화 방법:

| PM 산출물 | 포트폴리오 표현 |
|---|---|
| 의사결정 | Before/After 차트 + 의사결정 트리 |
| 협업 | 이해관계자 다이어그램 + 회의록 발췌 |
| 제품 변화 | 출시 전후 스크린샷 + UX 흐름 |
| 임팩트 | 매출·리텐션·CSAT 정량 |
| 학습 | 회고록 인용 (1-2 paragraph) |

### 5. 공개 포트폴리오 설정

- **SEO 최적화** — title·description·URL 슬러그
- **공개 설정**과 검색 노출 여부는 지원자의 선택을 확인한 뒤 적용
- **LinkedIn 프로필 연동** — 포트폴리오 URL을 헤드라인에
- **GitHub Profile README** — 포트폴리오 링크 명시
- **블로그 1-2개** — 프로젝트 회고·인사이트

### 6. 경력기술서 비중 배분 예시

- 목표 직무와 가장 관련된 경력은 문제·기여·결과를 상세히 적는다.
- 관련성이 낮은 경력은 검증 가능한 성과 위주로 요약한다.
- 수상·자격·언어는 채용공고의 요구와 연결되는 항목을 우선한다.

마지막 페이지에 "함께 일하고 싶은 분" 한 단락 — 인성 어필.

### 7. 원페이지 프로젝트 개요 (성과로 이어지는)

각 프로젝트는 1페이지 (A4) 분량.

```yaml
project:
  title: "○○ 프로젝트"
  period: "2024.03 ~ 2024.08 (6개월)"
  role: "PM (5명 팀)"
  background:
    problem: "..."
    company_context: "..."
  approach:
    - "..."
  outcome:
    - metric: "월 매출 30% 증가"
    - metric: "리텐션 15% 개선"
  learning: "..."
```

## 분야별 포트폴리오 전략

### 개발자

AI 도구를 활용한 프로젝트라면 어떤 판단과 구현을 본인이 맡았는지 구분해 설명합니다. 목표 직무에 필요한 기술적 깊이는 채용공고를 기준으로 판단합니다.

| 구성 요소 | 필수도 | 설명 |
|----------|:------:|------|
| GitHub 프로필 | 필수 | 커밋 히스토리, 기여 그래프, 핀 프로젝트 3-5개 |
| 기술 블로그 | 강력 권장 | 문제 해결 과정, 기술 선택 이유, 학습 기록 |
| 프로젝트 README | 필수 | 아키텍처 다이어그램, 기술 스택, 실행 방법 |
| 라이브 데모 | 권장 | Vercel/Netlify 배포 링크, 데모 영상 |
| 오픈소스 기여 | 차별화 | PR, 이슈 해결, 라이브러리 기여 기록 |

**프로젝트 README 필수 항목:**
```
## 프로젝트명
한 줄 설명

### 기술 스택
[프레임워크] [DB] [인프라] [CI/CD]

### 핵심 기능
- 기능 1: 설명 (본인 기여 부분 명시)
- 기능 2: 설명

### 아키텍처
[다이어그램 또는 설명]

### 성과/배운 점
- 응답 시간 40% 개선 (Redis 캐시 적용)
- 동시 접속 1,000명 처리 (부하 테스트 결과)
```

### 디자이너

AX(AI Transformation) 시대의 디자이너는 화면을 예쁘게 만드는 것을 넘어 비즈니스 임팩트를 내는 사람이어야 합니다.

| 구성 요소 | 필수도 | 설명 |
|----------|:------:|------|
| Behance/Dribbble | 필수 | 완성도 높은 프로젝트 5-8개 |
| Figma 파일 | 강력 권장 | 컴포넌트 시스템, 프로토타입, 디자인 토큰 |
| 프로세스 문서 | 필수 | 문제 정의 → 가설 → 실험 → 검증 전체 과정 |
| AI 활용 사례 | 권장 | Midjourney, Figma AI 등 도구 활용 과정 |
| 협업 기록 | 차별화 | Jira/Confluence 협업, 개발자 소통 기록 |

**케이스 스터디 구조:**
```
1. 문제 정의: 어떤 사용자 문제를 해결했는가
2. 리서치: 사용자 인터뷰, 데이터 분석 결과
3. 가설 설정: 어떤 가설을 세웠는가
4. 디자인 과정: 와이어프레임 → 프로토타입 → 최종 디자인
5. 실험/검증: A/B 테스트, 사용성 테스트 결과
6. 비즈니스 임팩트: 전환율 변화, 이탈률 감소 등 수치
```

### 마케터

성과를 수치로 증명하는 것이 마케팅 포트폴리오의 핵심입니다.

| 구성 요소 | 필수도 | 설명 |
|----------|:------:|------|
| 캠페인 케이스 | 필수 | 목표 → 전략 → 실행 → 성과(수치) 구조 |
| 데이터 분석 | 강력 권장 | GA4, SQL, 엑셀 활용 분석 사례 |
| 콘텐츠 포트폴리오 | 권장 | SNS 게시물, 블로그, 뉴스레터 샘플 |
| 성과 대시보드 | 차별화 | Notion/Looker Studio로 정리된 KPI |

### 기획자 (PM/PO)

문제 발견부터 해결까지의 사고 과정을 보여주는 것이 핵심입니다.

| 구성 요소 | 필수도 | 설명 |
|----------|:------:|------|
| 기획서 샘플 | 필수 | PRD, 기능 명세서, 와이어프레임 |
| UX 리서치 | 강력 권장 | 사용자 인터뷰, 설문 분석, 퍼소나 |
| 데이터 기반 의사결정 | 권장 | A/B 테스트 결과, 지표 분석 사례 |
| 스프린트 운영 | 차별화 | 애자일 프로세스 경험, 회고 기록 |

## 프로젝트 기술서 작성 프레임워크

```
■ 프로젝트명
  한 줄 요약

■ 기간/인원/역할
  YYYY.MM - YYYY.MM | N명 | 담당 역할

■ 배경 및 문제
  왜 이 프로젝트를 시작했는가

■ 나의 기여 (STAR 기반)
  S: 프로젝트 시작 당시 상황
  T: 내가 맡은 구체적 과제
  A: 실행한 행동과 의사결정
  R: 정량적 성과 또는 정성적 배움

■ 기술 스택 / 도구
  사용한 기술, 프레임워크, 도구 목록

■ 링크
  GitHub / 배포 URL / 발표 자료
```

## 플랫폼별 최적화 팁

| 플랫폼 | 최적화 포인트 | 활용 판단 기준 |
|--------|-------------|---|
| GitHub | 프로필 README, 핀 프로젝트, 커밋 빈도, 이슈/PR 활동, 오픈소스 기여 | 코드 기여를 보여줘야 하는 직무에서 우선 검토 |
| Behance/Dribbble | 커버 이미지 품질, 태그 최적화, 프로젝트 설명 영/한 병기 | 시각 작업물을 공개할 수 있는 디자인 직무 |
| Figma | 컴포넌트 시스템, 프로토타입, 디자인 토큰, 핸드오프 가이드 | 설계 과정과 협업 기록을 보여줄 때 |
| Notion | 목차 구조, 토글 활용, 임베드(Figma/YouTube), 공유 설정 | 공개 범위와 검색 노출을 확인할 수 있을 때 |
| 개인 기술 블로그 | 제목에 주제 표시, 시리즈 구성, 문제 해결 과정 기록 | 글로 판단 과정을 보여줄 수 있을 때 |
| 링크드인 | 헤드라인 + Featured 섹션 (포트폴리오 URL 핀) + 추천사 | 공개 프로필을 운영할 때 |
| GitHub Pages·Vercel | 라이브 데모 + 운영 설명 | 실행 결과를 공개할 수 있을 때 |

## 분야별 포트폴리오 구성 예시

아래 요소 중 지원 직무의 채용공고와 실제 경험에 맞는 것만 선택합니다.

| 분야 | 보여줄 수 있는 경험 예시 |
|---|---|
| 개발 | AI 도구와 협업한 문제 해결 과정 (LLM 페어 프로그래밍 회고), 실제 트래픽 운영 경험 |
| 디자인 | AX(AI Transformation) 시대의 디자인 시스템 사례, 비즈니스 임팩트 (전환율·이탈률) |
| 마케팅 | GA4·SQL 기반 데이터 분석, A/B 테스트 결과, 성과 대시보드 (Looker Studio·Notion) |
| 기획/PM | A/B 테스트 + 사용자 인터뷰 + 의사결정 트리, "왜 그 결정인가" Why-First 사고 과정 |

## 트리거 키워드

포트폴리오, 프로젝트, GitHub, Behance, Figma, Notion, 노션 포트폴리오, 기술서, 작품집, 1page 셀링, 검색되는 포트폴리오, 헤드헌터 노출

## 사용 예시

- "프론트엔드 개발자 포트폴리오 구성 가이드 — 5년차 이직용"
- "이 프로젝트를 기술서로 정리해줘. [프로젝트 설명] (STAR + 정량)"
- "GitHub 프로필 README 작성. 백엔드 + AI 도구 협업 경험 강조"
- "디자이너 Behance 포트폴리오 리뷰 — 비즈니스 임팩트 부족한지 확인"
- "Notion 포트폴리오 6 섹션 — 마케팅 직무, 검색되게 만들어줘"
- "원티드 노출되는 1page PDF + GitHub 핀 프로젝트 가이드"
- "PM 포트폴리오 — 추상적 결과를 의사결정 트리 + Before/After로"

## 독립 실행 워크플로우

참조 가이드(`references/`)를 사용할 수 없는 경우 다음 단계로 실행합니다.

### 1단계: 분야/목적 파악
- 직무 분야: 개발/디자인/마케팅/기획
- 목적: 신규 구성 / 기존 개선 / 특정 프로젝트 정리
- 대상 플랫폼: GitHub/Behance/Notion/블로그/기타

### 2단계: 프로젝트 인벤토리
- 보유 프로젝트 목록화
- 각 프로젝트의 기여도, 기술 스택, 성과 정리
- 포트폴리오에 포함할 프로젝트 3-5개 선정 (양보다 질)

### 3단계: 구조 설계
- 분야별 필수 구성 요소 확인
- 프로젝트 배치 순서 (가장 강한 프로젝트를 첫 번째에)
- 전체 흐름: 자기소개 → 핵심 프로젝트 → 기술 스택 → 연락처

### 4단계: 콘텐츠 작성
- 프로젝트 기술서 작성 (STAR 프레임워크)
- 플랫폼별 최적화 적용
- 비주얼 요소 배치 (스크린샷, 다이어그램, 영상)

## 실행 규칙

1. 사용자 요청 수신 → 분야 및 목적 파악
2. `references/{id}.md` 존재 시 로드 → 가이드에 따라 실행
3. 다분야 포트폴리오는 목표 직무별 요구 역량·프로젝트 근거·산출물 구조를 단계별로 대조한다. 별도 추론 도구가 현재 앱에 있으면 활용할 수 있지만 도구 이름이나 특수 키워드에 실행을 의존하지 않는다.
4. 구조와 초안 생성 후 사용자 검토 요청

## 문제 해결

- **프로젝트 경험 부족**: 개인 프로젝트, 해커톤, 오픈소스 기여, 사이드 프로젝트도 훌륭한 포트폴리오 소재입니다. 1인 프로젝트라도 문제 해결 과정을 보여주면 됩니다.
- **성과 수치화 어려움**: 직접적 매출 성과가 없어도 "사용자 N명 확보", "코드 리뷰 N건", "문서 N개 작성" 등 활동 지표로 수치화할 수 있습니다.
- **디자인 역량 부족 (개발자)**: Notion, GitHub README, 간결한 와이어프레임으로도 충분합니다. 비주얼보다 콘텐츠 품질이 우선입니다.
- **다수 분야 경험**: 지원 직무와 가장 관련 높은 프로젝트를 앞에 배치하고, 부가 역량은 별도 섹션으로 분리하세요.

## 관련 스킬 / 후처리 체인

프로젝트 기술서·About 단락·케이스 스터디·README 본문 등 포트폴리오의 서술 텍스트는 모두 사람이 읽는 산출물입니다. 아래 외부 스킬은 각각 현재 앱에 설치·노출된 경우에만 해당 단계를 사용합니다. 사용할 수 없는 단계는 추상적 수식어와 상투구를 직접 걷어내고, 프로젝트의 문제·본인 기여·결과를 원자료와 다시 대조합니다.

```
moai-career:career-portfolio → moai-coworker:ai-slop-reviewer → moai-writer:korean-humanize → 최종 검수
```

- `moai-coworker:ai-slop-reviewer` — AI 생성 패턴(범용 표현·클리셰·형용사 남발) 1차 검수·교정
- `moai-writer:korean-humanize` — 문장 리듬·구어 표현으로 2차 휴머나이즈

지원 서류는 `moai-career:career-resume`, JD 분석은 `moai-recruiter:hr-job-analysis`, 면접 준비는 `moai-career:career-interview`와 함께 사용하세요.

> 표·스크린샷·다이어그램·정량 대시보드 같은 비서술 산출물은 이 체인 대상이 아닙니다. 서술 텍스트 부분에만 적용합니다.

## 이 스킬을 사용하지 말아야 할 때

- **자소서/이력서 작성**: 지원 서류 작성은 `moai-career:career-resume` 스킬을 사용하세요.
- **면접 준비**: 포트폴리오 발표 면접이 아닌 일반 면접은 `moai-career:career-interview` 스킬이 적합합니다.
- **채용공고 분석**: JD 분석과 역량 매칭은 `moai-recruiter:hr-job-analysis` 스킬을 사용하세요.
- **실제 웹사이트 구축**: 포트폴리오 사이트를 직접 코딩하려면 개발 도구를 사용하세요.