hiring-sim-portfolio-review

name	hiring-sim-portfolio-review
description	포트폴리오의 프로젝트 품질, 기술적 의사결정, 실무 역량을 실전 기준으로 평가합니다. 표·대시보드·캡션의 수치 정합성 대조(Consistency & Evidence Audit)를 포함합니다.
user-invocable	true

포트폴리오 리뷰 (Hiring Portfolio Review)

포트폴리오를 실제 채용 담당자/기술 리드 관점에서 평가하고 개선 피드백을 제공합니다. 프로젝트 품질 채점(PASS/REJECT)에 더해, 주장한 수치가 첨부 근거(표·대시보드·캡션)와 실제로 일치하는지를 대조합니다.

---

판정 기준 (인라인)

[PASS]   — 프로젝트 품질 3개 영역 모두 "적합" 이상, 포지션 정렬도 충분, 정합성 감사에서 🔴 없음
[REJECT] — 핵심 영역 1개 이상 "부적합" OR 포지션과의 관련성 부족 OR 대표 성과에 🔴 정합성 결함

---

실행 절차

Step 0: 평가 프레임워크 로딩 (선택)

다음 파일을 읽는다 (프로젝트 내 또는 ~/.codex/skills/·~/.claude/skills/ 경로):

• hiring-common/evaluation-framework.md
• cartesian-doubt (있으면) — Step 2.5 정합성 감사의 회의 규율(의심 사다리 · [검증됨/가정/불명] 라벨)에 참조
• 읽을 수 없어도 위의 인라인 판정 기준으로 진행 가능

Step 1: 입력 수집

포트폴리오 (필수):

• "리뷰할 포트폴리오 파일 경로를 알려주세요. (PDF, Markdown, HTML, 또는 프로젝트 디렉토리)"
• 미제공 시: "포트폴리오는 필수입니다. 파일 경로를 알려주세요." 출력 후 대기

첨부 이미지 경로 (권장):

• 대시보드/아키텍처 스크린샷이 별도 폴더에 있으면 경로를 받는다(예: assets/crops/). Step 2.5 정합성 감사에 사용.

채용 공고 (선택):

• "채용 공고가 있으면 내용을 붙여넣어주세요. URL도 가능합니다. (없으면 '없음')"
• URL 제공 시 웹 페이지 읽기 시도. 실패하면 직접 붙여넣기 요청.

Step 2: 포트폴리오 파싱

입력 형식에 따라:

• 파일 (PDF/MD/TXT/HTML): Read 도구로 읽기
• 디렉토리: Glob으로 구조 파악 → README 및 주요 파일 Read
• 첨부 이미지: Read로 시각 판독(vision)

포트폴리오에서 식별할 항목:

• 프로젝트 목록
• 각 프로젝트의 기술 스택, 역할, 기여도
• 아키텍처/설계 관련 서술
• 핵심 성과 수치와 그 근거(표·대시보드·캡션)의 짝
• 경력 수준 추정

Step 2.5: 정합성·근거 감사 (필수)

평가 이전에 주장과 근거를 대조한다. 근거가 자기모순이면 그 위에 쌓은 평가는 무의미하다. cartesian-doubt의 원리: 액면(주장)과 검증된 사실을 분리하고, 하중을 받는 수치만 실제로 대조한다.

각 핵심 주장/수치에 [검증됨 / 가정 / 불명] 라벨을 붙이고 아래를 대조한다:

L1 · 수치 정합성 (모든 수치)

• 같은 지표가 표·대시보드·캡션·본문에서 같은 값인가?
• 백분위 혼용: "평균"이라며 실제로는 p95/p99 값을 쓰고 있지 않은가?
• 평균 vs 피크: 평균/전체 처리량이 피크보다 크게 적혀 있지 않은가(산술적 불가능)?
• 단위: ms/s, 건/초 단위가 표와 그래프에서 일치하는가?
• 분모/합계: 비율의 분모, 합계가 슬라이드 간 일치하는가?

L2 · 서사–근거 일치

• 본문이 말하는 기술 스택/아키텍처가 첨부 다이어그램·대시보드·코드와 일치하는가?
• 스택 표기에 실제로 안 쓴 기술이 들어가거나, 쓴 기술이 빠져 있지 않은가?
• 플레이스홀더·미완성("추후 삽입", TODO, 빈 그래프)이 남아 있는가?
• "개선"이라 쓴 게 실제로는 측정 대상 바꿔치기(예: 비동기 접수시간을 처리시간 개선으로)는 아닌가?

감사 결과를 🔴/🟠/🟡 심각도로 기록한다. 대표 성과(표지·요약에 올라간 수치)에 🔴가 있으면 해당 프로젝트의 영역 3(성과/임팩트)는 "우수"를 줄 수 없다.

더 깊은 적대적 감점 적발이 필요하면 hiring-sim-portfolio-redteam(면접관 레드팀 리뷰)로 넘긴다.

Step 3: 프로젝트별 평가

각 프로젝트를 3개 영역으로 평가한다.

영역 1: 기술적 의사결정 품질

실제 채용 담당자가 가장 중시하는 부분. "왜 이 기술/방법을 선택했는가?"

• 기술 스택 선택 근거가 있는가?
• 대안을 검토한 흔적이 있는가?
• 트레이드오프를 인식하고 있는가?
• 과도한 엔지니어링 없이 적정 수준인가?

등급	기준
우수	선택 근거 + 대안 비교 + 트레이드오프 명시
적합	합리적 선택이나 대안 비교 부족
부적합	선택 근거 없음 또는 부적절한 기술 선택

감점 트리거: 용어를 오용(buzzword 인플레)하거나, 서사가 첨부 근거와 불일치(Step 2.5의 🔴/🟠)하면 "적합" 이하로 내린다.

영역 2: 문제 해결 과정

프로젝트가 해결한 문제의 정의와 접근 방식.

• 해결하려는 문제가 명확히 정의되어 있는가?
• 문제 분해와 접근 과정이 서술되어 있는가?
• 제약 조건을 올바르게 반영했는가?

등급	기준
우수	문제 정의 + 체계적 접근 + 제약 반영
적합	문제 해결은 했으나 과정 서술 부족
부적합	문제 정의 불명확 또는 접근 방식 비논리적

영역 3: 성과와 임팩트

실제 채용에서 정량적 성과가 있는 이력서는 2.5배 더 면접 기회를 얻는다.

• 정량적 성과가 있는가? (수치 + 맥락)
• 본인 기여도가 명확한가?
• 프로젝트의 실제 사용/배포 여부

등급	기준
우수	정량적 성과 + 맥락 + 본인 기여 명확 + 근거와 정합(Step 2.5 통과)
적합	성과는 있으나 정량적 근거 부족
부적합	성과 서술 없음 또는 모호함 또는 수치가 근거와 모순

감점 트리거: 대표 수치가 표·대시보드·캡션과 어긋나거나(🔴), 측정 대상 바꿔치기이거나, 검증 불가한 소프트 수치("논의 80% 감소")면 "우수" 불가. 근거와 명백히 모순되면 "부적합".

Step 4: 포트폴리오 전체 구성 평가

개별 프로젝트를 넘어:

• 기술적 범위: 다양한 기술/도메인을 커버하는가?
• 난이도 분포: 도전적인 프로젝트가 있는가?
• 포지션 정렬도 (공고 제공 시): JD와 프로젝트가 관련 있는가?
• 스토리텔링: 프로젝트 간 성장이 보이는가?
• 과장 감사: "대용량/고성능/실시간" 같은 표현이 실측 규모와 맞는가?(피크 RPS·부하 규모 대비)

Step 5: 결과 출력

# 포트폴리오 리뷰 결과

## 종합 판정: [PASS / REJECT]
경력 수준 기준: [주니어/미드/시니어]

### 정합성 감사 (Step 2.5 요약)
| 항목 | 위치 | 심각도 | 주장 vs 근거 |
|------|------|--------|--------------|
| [지표명] | [슬라이드/섹션] | 🔴/🟠/🟡 | "[표 값]" vs "[대시보드/캡션 값]" — [라벨: 검증됨/가정/불명] |
[없으면 "정합성 결함 없음"]

### 프로젝트별 평가

#### [프로젝트명]
| 영역 | 등급 | 근거 |
|------|------|------|
| 기술적 의사결정 | [우수/적합/부적합] | "[인용]" — [분석] |
| 문제 해결 과정 | [우수/적합/부적합] | "[인용]" — [분석] |
| 성과/임팩트 | [우수/적합/부적합] | "[인용]" — [분석] |

[반복...]

### 포트폴리오 구성 평가
- 기술적 범위: [평가]
- 난이도 분포: [평가]
- 포지션 정렬도: [평가]
- 과장 감사: [평가]

### 강점
- [강점]: "[근거 인용]"

### 개선 필요 사항
- [개선점]: [구체적 개선 방법]

### 포트폴리오 재구성 제안
[프로젝트 추가/제거/순서 변경/내용 보강 제안]

주의사항

• 프로젝트의 규모나 유명세로 판단하지 않는다. 의사결정 품질과 사고 과정을 본다
• 코드 리뷰가 아니다. 기술적 의사결정과 문제 해결 과정을 평가한다
• 확인 불가 성과는 "근거 불충분"으로 표기하되 부정적으로 추측하지 않는다
• 정합성 결함은 양쪽 근거를 인용할 수 있을 때만 보고한다("표엔 A, 그래프엔 B"). 근거 없이 "이상하다"고 쓰지 않는다
• 이미지를 못 봤으면 "미확인"으로 표기하고 조작으로 추측하지 않는다
• 면접관 관점의 적대적 감점 적발이 목적이면 hiring-sim-portfolio-redteam을 쓴다(이 스킬은 채점 + 정합성 감사, 그 스킬은 감점 사냥 전문)
• REJECT여도 구체적 개선 방향을 반드시 제시한다