portfolio-guide

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

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

2026 채용 시장은 "이력서에 나열된 스펙이 아닌, 실무에서 실제로 해낼 수 있는 능력"을 봅니다. 노션 + GitHub + Behance 같은 검색되는 포트폴리오를 누적해두면 헤드헌터·원티드·리멤버에서 본인이 지원하지 않아도 오퍼가 들어오는 구조가 형성됩니다.

지원 영역

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

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

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

1. "예쁘지 않아도 통과한 메모장 전략" (PMPO 합격)

디자인이 아니라 구조와 정량이 합격을 만든다.

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

메모장(.txt) 수준의 텍스트만으로도 합격 가능.

2. 1시간 노션 포트폴리오 (조회수 2만뷰 검증)

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

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

노션 템플릿 + 커스텀 도메인 (oopy.io, super.so) — 1시간이면 완성.

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. 877건 공유 이력서·경력기술서 노하우

• 가장 최근 경력 = 상세 (40% 비중)
• 중간 경력 = 정량 결과만 (30%)
• 초기 경력 = 한 줄 요약 (10%)
• 기타 (수상·자격·언어) = 압축 (20%)

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

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

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

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

분야별 포트폴리오 전략

개발자

2026년 채용 시장에서 바이브 코딩(Vibe Coding)의 확산으로 기업이 요구하는 기술적 깊이가 한층 높아졌습니다. 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 / 발표 자료

플랫폼별 최적화 팁

플랫폼	최적화 포인트	2026 가중치 (한국 채용 시장 체감)
GitHub	프로필 README, 핀 프로젝트, 커밋 빈도, 이슈/PR 활동, 오픈소스 기여	개발자 직군 필수 — 원티드·잡플래닛 IT 가중치 최상
Behance/Dribbble	커버 이미지 품질, 태그 최적화, 프로젝트 설명 영/한 병기	디자인 직군 필수
Figma	컴포넌트 시스템, 프로토타입, 디자인 토큰, 핸드오프 가이드	디자인 직군 — 협업 능력 증명
Notion	목차 구조, 토글 활용, 임베드(Figma/YouTube), 공유 설정, 검색엔진 인덱싱 허용	전 직군 — oopy.io·super.so로 커스텀 도메인
개인 기술 블로그	SEO 최적화, 시리즈 구성, RSS 피드, 댓글 소통, "문제 해결 과정" 위주	개발·기획 — 신입 차별화 핵심
링크드인	헤드라인 + Featured 섹션 (포트폴리오 URL 핀) + 추천사	재직자 누적 — 헤드헌터 오퍼 트리거
GitHub Pages·Vercel	자체 도메인 + 라이브 데모 + 분석 도구 (GA)	개발자 차별화 — 협업·운영 능력 증명

2026 분야별 포트폴리오 차별화 포인트

원티드·잡플래닛 IT 직군 채용 트렌드에 따르면 GitHub·노션 포트폴리오의 가중치가 학력보다 높아진 직군이 늘었습니다. 본 스킬은 분야별로 다음 차별화 요소를 자동 추천합니다.

분야	2026 차별화 요소
개발	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. --deepthink 또는 복잡한 다분야 포트폴리오 → sequential-thinking MCP가 설치돼 있으면 mcp__sequential-thinking__sequentialthinking를 활용, 없으면 ultrathink 키워드 기반 심층 추론 또는 일반 단계 추론으로 대체
4. 구조와 초안 생성 후 사용자 검토 요청

문제 해결

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

관련 스킬 / 후처리 체인

프로젝트 기술서·About 단락·케이스 스터디·README 본문 등 포트폴리오의 서술 텍스트는 모두 사람이 읽는 산출물입니다. 초안 완성 후 다음 체인을 거쳐 AI 패턴을 제거하고 자연스러운 한국어로 다듬습니다.

moai-career:portfolio-guide → moai-core:ai-slop-reviewer → moai-content:humanize-korean

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

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

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

공유 에이전트

이 플러그인에서 활용할 수 있는 다른 플러그인의 에이전트:

에이전트	소속	용도
quality-evaluator	moai-core	산출물 품질 PASS/FAIL 판정
korean-tone-reviewer	moai-hr	직급별 경어 사용 및 비즈니스 톤 적절성 검토

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

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