포트폴리오 원페이지
이 스킬이 적용되는 경우
Kene이 자신의 작업을 대표하는 공개 페이지 하나가 필요할 때 사용합니다. 지원서 링크, 콜드 아웃리치 서명, 소셜 프로필, 또는 포트폴리오를 명시적으로 요구하는 역할 지원 시에 해당합니다. 트리거: "포트폴리오 페이지가 필요해", "작업 샘플을 물을 때 무엇을 링크하지?", "[역할] 구직을 위한 원페이지를 만들어 줘."
이 스킬이 기록하는 결정 (A26/A27)
이 결정은 여러 리뷰 패스를 거치며 미결로 남아 있었으며, 이 패키지에 추가되는 유일한 새로운 사용자 대상 결과물입니다. 기존 결과물을 개선하는 것이 아니라 새로 만드는 것이라서 계속 미뤄졌는데, 이제 더 이상 미루지 않고 명확히 답을 내려야 합니다.
정답은: 만들되, 좁은 범위로 만든다.
찬성 근거: 원페이지에 필요한 모든 것은 이미 패키지에 있으며 Rule 5에 따라 확인되었습니다. STAR 은행에는 스토리가 있고, 정량화 게이트에는 숫자가 있으며, 09-risk-tactics-gate에는 클레임 검증 패스가 있고, 21-output-templates에는 구조 시스템이 있으며, 17-cold-prospecting은 이미 무언가를 링크할 대상을 원합니다. 만들지 않는다면, Kene은 이 파이프라인이 유지하는 코퍼스에서 지원서 간에 가장 재사용 가능한 단일 아티팩트를 수동으로 조립해야 합니다.
반대 근거와 그에 따른 범위 제한: 포트폴리오는 콘텐츠 문제만큼이나 디자인 문제이며, 이 파이프라인이 사이트 빌더가 될 이유는 없습니다. 테마, 갤러리, 분석, CMS를 갖춘 "포트폴리오 시스템"은 구직 파이프라인 안에 사는 또 다른 제품이 될 것입니다.
따라서 범위는 의도적으로 좁습니다: 한 페이지, 확인된 기억에서 생성, 정적 HTML로 게시, 타겟 역할별로 버전 관리. CMS 없음, 다중 페이지 사이트 없음, 테마 시스템 없음, 방문자 분석 없음. Kene이 실제 개인 사이트를 원한다면, 이 스킬은 좋은 시작 파일을 제공하고 나머지는 다른 곳에서 처리합니다. 이 스킬은 그렇게 명확히 말하고, 점점 더 커지지 않아야 합니다.
포트폴리오 대 커스터마이즈된 이력서 — 각각의 실제 용도
가장 흔한 실수는 포트폴리오를 더 예쁜 이력서로 만드는 것입니다. 둘은 서로 다른 역할을 하며, 그 차이는 표현 방식이 아닙니다.
커스터마이즈된 이력서 (05-resume-customizer) | 포트폴리오 원페이지 | |
|---|---|---|
| 독자에게 도달하는 방식 | 푸시(Push). 하나의 채용 공고에 대해 한 명의 고용주에게 전송됨. | 풀(Pull). 독자가 링크를 클릭하여 방문함. |
| 독자가 이미 알고 있는 정보 | JD를 앞에 두고 있음. 매칭 대상을 알고 있음. | 종종 아무것도 모름. 브라우징 중인 리크루터, 콜드 이메일을 받은 채용 매니저, 컨퍼런스 참석자, X에서 방금 답글을 본 사람일 수 있음. |
| 역할의 존재 여부 | 항상 있음. | 자주 없음 — 이것이 콜드 프로스펙팅의 전체 기반임. |
| 수명 | 전송 시점에 고정됨. 스냅샷. | 라이브. 변경 가능하며 영구적으로 공개됨. |
| 증거 | 주장함. "배포 시간을 40분에서 6분으로 줄임." | 보여줌. 여기 저장소, 실행 중인 것, 노트북, 글(writeup)이 있음. |
| 형식 제약 | ATS 파싱, 한 페이지, 전통적인 레이아웃, 독창적인 형식 금지. | 파서 없음. 스크린샷, 다이어그램, 긴 서사, 링크. |
| 실패 모드 | 키워드 누락; JD와 불일치. | 데드 링크, 오래된 콘텐츠, 공개되어서는 안 될 정보 유출. |
중요한 행은 '증거'입니다. 나머지는 모두 그 결과입니다. 이력서는 주장만 할 수 있습니다 — 형식에 증거를 넣을 공간이 없고, 독자가 90초 동안 확인할 방법도 없습니다. 포트폴리오는 아티팩트 레이어입니다: "배포 시간을 40분에서 6분으로 줄임"이라는 말이, 히스토리에 전후 CI 구성이 포함된 저장소가 되는 곳입니다.
그것이 포트폴리오를 만들 이유입니다. 포트폴리오 페이지에 실제 아티팩트로 가는 링크가 없다면, 그것은 ATS 호환성이 더 나쁜 이력서일 뿐이며 게시되어서는 안 됩니다. 09-risk-tactics-gate의 게시 전 검증이 이를 강제합니다 (아래 "아티팩트 링크" 참조).
각각이 필요한 경우:
- 이력서, 항상. 모든 지원서에 필수이며, 이 스킬이 그 필요성을 줄이지 않습니다.
- 포트폴리오, 독자가 맥락 없이 도착할 때. 콜드 아웃리치 (
17-cold-prospecting), 소셜 바이오의 링크, 작업 샘플을 명시적으로 요청하는 역할, 추천으로 누군가가 그의 이름을 전달하는 경우, 또는 "무엇을 만들었나요?"라는 질문이 "여기 직무 설명서가 있습니다"보다 먼저 오는 대화. - 둘 다, 서로 연결. 이력서에는 포트폴리오 URL이 포함되고, 포트폴리오는 이력서를 재현하지 않습니다. 둘 사이의 중복은 페이지의 낭비 공간이자 동기화해야 할 또 다른 항목입니다.
현재 고용주 고려사항. 이력서는 한 명의 수신자에게 전송됩니다. 포트폴리오는 현재 고용주를 포함한 누구나 찾을 수 있으며, 게시하는 것은 약간 눈에 띄는 행동입니다. 16-career-pulse의 재량 모드 처리가 적용됩니다: Kene이 조용히 구직 중이라면, 이것이 게시 여부에 대한 실제 입력값이 되며, 스킬은 첫 게시 시 한 번 이 문제를 제기하고 어느 쪽으로든 가정하지 않습니다.
아티팩트 링크 — 주요 콘텐츠이지, 바닥글이 아님
링크가 없는 포트폴리오는 이력서입니다. 링크가 포트폴리오의 존재 이유이므로, 하단의 "선별된 작업" 목록이 아닌 최우선으로 취급됩니다.
각 작업 항목은 하나 이상의 아티팩트를 포함할 수 있습니다:
| 유형 | 참고 |
|---|---|
deployed | 실제 실행 중인 것. 가장 가치 있는 링크 — 독자가 10초 안에 사용 가능함. |
repo | GitHub/GitLab. 특정 파일이 핵심이 아니라면 저장소 루트 링크; 한 파일로의 딥 링크는 체리픽으로 읽힘. |
notebook | Colab, Jupyter, Kaggle. 아래 가독성 참고를 확인하세요. |
writeup | 블로그 포스트, 디자인 문서, 사후 분석(postmortem). 코드를 공유할 수 없는 작업에 가장 강력한 아티팩트인 경우가 많음. |
demo | 공개 배포가 불가능한 경우 화면 녹화. 2분, 나레이션 불필요. |
package | npm, PyPI, crates.io — 게시된 설치 가능한 것. |
paper | arXiv 또는 발행된 학술지. |
노트북은 저장소와 다른 가독성 검사가 필요합니다. 출력이 비워진 .ipynb는 대충 훑어보는 사람에게 아무것도 증명하지 못하는 코드 벽입니다. 렌더링된 형태 — 실행 가능한 Colab 링크, 또는 출력이 커밋된 nbviewer/GitHub 자체 렌더 — 를 링크하고, 첫 번째 셀에 노트북의 용도를 명시하세요. 첫 번째로 보이는 것이 import pandas as pd인 노트북은 독자가 닫아버리는 링크입니다.
저장소는 30초를 버틸 수 있는 README가 필요합니다. 저장소의 README가 무엇인지와 존재 이유를 설명하지 않는다면, 링크하는 것이 안 하는 것보다 더 나쁩니다. 이 스킬은 이를 플래그(flag)합니다만, 고치지는 않습니다. 왜냐하면 그것은 Kene이 해야 할 실제 작업이기 때문입니다.
링크 부패(link rot)는 조용하고 완전한 실패이므로 확인됩니다. 데드 링크가 있는 포트폴리오는 링크가 없는 것보다 더 나쁩니다: 페이지가 존재하는 바로 그 차원에서 부주의해 보이기 때문입니다. 모든 아티팩트 URL은 게시 시 확인되고 분기별 갱신(shared/applications_db_schema_addendum_18.sql, portfolio_artifacts) 시 재확인됩니다. 404, 비공개로 전환된 저장소, 권한이 필요한 Colab은 모두 URL과 함께 보고되며, 페이지에서 조용히 제거되지 않습니다. 아티팩트가 조용히 제거되면 페이지가 눈에 띄지 않게 약해지고 아무도 알아차리지 못하기 때문입니다.
링크해도 안전한 것 — 엄격한 경계. Kene이 소유하거나 이미 허가를 받아 공개된 아티팩트만 가능합니다. 고용주 소유 코드, 내부 문서, NDA에 해당하는 모든 것, 타사 데이터를 포함하는 모든 것은 공개 페이지에 올릴 수 없습니다. 이는 추가 시점과 게시 시점에 모두 확인되며, 이 스킬에서 "Kene이 재정의 가능" 경로가 없는 유일한 검사입니다. 실패 모드는 그가 소유하지 않은 것을 게시하는 것이며, 이는 직업이 아닌 경력을 끝장냅니다.
기본 작업을 보여줄 수 없는 경우, writeup과 demo 유형이 정확히 그 목적으로 존재합니다: 그가 구축한 시스템을 아무것도 공개하지 않는 추상화 수준에서 설명하는 것은 합법적이며 종종 코드 자체보다 더 읽기 쉽습니다.
블록 구조 — 정확히 6개 블록
6개의 블록, 순서대로. 각각은 이미 확인된 기존 기억에서 가져옵니다. 이 스킬은 어떤 사실도 새로 만들지 않습니다 (Rule 5).
- 포지셔닝 라인 — 한 문장으로, 그가 무엇을 하며 누구를 위한 것인지 설명.
target-profile.yaml의 현재 타겟 직함과content-model-overlap.md의 프레이밍에서 파생되며, 게시 전에 Kene이 확인합니다. 페이지에서 가장 어려운 줄이며, 가장 많은 반복을 들일 가치가 있습니다. - 세 가지에서 다섯 가지 작업 항목 — STAR 은행에서 가져오며,
05-resume-customizer가 선택하는 것과 동일한 방식으로 타겟 역할에 맞게 선택됩니다. 각각 상황 → 그가 한 일 → 숫자로 구성됩니다. 모든 숫자는 이력서 항목과 동일한 정량화 기준을 따릅니다. 포트폴리오는 자체 게시물이기 때문에 증거 기준이 낮은 표면이 아닙니다. 오히려 공개 페이지에 영구적으로 있는 주장은 한 번 보내는 문서의 주장보다 더 신중하게 다뤄져야 합니다. - 역량 요약 —
domain-knowledge.md에서 증거가 첨부된 그룹화된 기술. 태그 벽이 아닌 그룹화. - 작업 항목별 아티팩트 링크 — 항목 2에 첨부되며, 하단에 별도로 나열되지 않음. 주장 옆에 있는 링크는 그 역할을 합니다. "선별된 작업" 부록에 있는 같은 링크는 독자가 건너뛰는 목록입니다. 위의 "아티팩트 링크"를 참조하세요.
- 연락처 — Kene이 이미 공개하기로 선택한 모든 것. 그가 달리 말하기 전까지는 기본값으로 아무것도 없음.
- 마지막 업데이트 — 실제 날짜. 날짜가 오래된 포트폴리오는 날짜가 없는 것보다 더 나쁘게 읽히며, 이는 아래의 갱신 프롬프트를 보여주지 않는 것보다 보여주는 근거가 됩니다.
변형(Variants) — 하나의 축이 아닌 두 개
이 스킬의 첫 번째 버전은 "타겟 직함 클러스터당 하나의 변형"이라고 했습니다. 이는 지원서에는 맞지만, 다른 상황과 다른 독자를 가진 콜드 아웃리치에는 틀렸습니다.
축 1 — 타겟 직함 클러스터 (지원서 대상). 동일한 기본 자료이지만, 역할군에 따라 선택과 순서가 다릅니다. 맞춤형 이력서와 동일한 원칙입니다. 19-career-path-planner의 현재 단계가 다단계 계획의 기본값입니다: 페이지는 그가 지금 지원하는 역할에 맞춰 현재 모습을 제시해야 하며, 두 단계 뒤의 역할이 아닙니다.
축 2 — 피치 모드 (아웃리치 대상). 17-cold-prospecting에는 세 가지 모드가 있으며, 각각 다른 페이지가 필요합니다. 독자의 질문이 다르기 때문입니다:
| 피치 모드 | 독자의 질문 | 페이지가 시작하는 내용 |
|---|---|---|
| 역할 적합(Role-fit) | "그가 우리가 이미 가진 일을 할 수 있을까?" | 지원서 변형과 동일한 형태. 종종 동일한 변형. |
| 역할 창출(Role-creation) | "이 기능을 여기서 만드는 게 가치 있을까?" | 기능이 해결하는 문제, 그가 문제를 해결한 작업으로 입증. 역할이 주장이고, 이력서가 아님. |
| 서비스(Service) | "이 사람을 특정 작업에 고용할까?" | 범위, 결과물, 비교 가능한 과거 작업. 컨설팅 페이지에 가장 가까움 — 역할 형태의 포트폴리오가 적극적으로 잘못 읽히는 경우. |
역할 적합 아웃리치는 일반적으로 별도 변형이 필요하지 않습니다. 일치하는 타겟 직함 변형을 재사용합니다. 역할 창출과 서비스 피치만 일반적으로 자체 변형이 필요하며, Kene이 그 방식으로 충분히 자주 피칭하여 유지할 가치가 있을 때만 필요합니다.
아웃리치당 별도 변형 없이 아웃리치 관련성 확보. 잠재 고객당 페이지를 만드는 대신, 게시된 페이지는 작업 항목당 안정적인 앵커(#credit-scoring-pipeline)를 가지고 있으며, 17-cold-prospecting은 관련 항목으로 딥 링크합니다. 하나의 변형이 많은 아웃리치에 서비스를 제공하며, 각각은 이메일의 동기가 된 항목에 독자를 착륙시킵니다. 이것이 변형을 늘리지 말아야 할 실제 이유입니다: 중요한 맞춤화는 그들이 먼저 보는 항목이며, 앵커가 그것을 무료로 해줍니다.
한도를 정하세요. 두 축을 합쳐 4-5개 변형이 많습니다. 각각은 독립적으로 오래될 수 있는 페이지이며, 포트폴리오의 최악의 실패는 최신이 아닌 것입니다. 여섯 번째가 요청되면, 더 나은 질문은 보통 두 개의 기존 변형이 수렴했는지 여부입니다.
변형은 shared/portfolio/{variant_slug}/에 있으며, 각각 무엇을 위해 구축되었는지, 무엇을 선택했는지, 언제인지를 기록합니다.
페이지에 무엇을 넣을지 선택 — Kene이 선택
이 스킬이 제안하고 그가 조정합니다. 여기의 모든 것과 동일한 제안-확인-저장 형태이며, 그가 사후에 발견하는 페이지가 아닙니다.
shared/portfolio-manifest.yaml 에는 세 가지가 저장됩니다:
- 적격 풀 — 이미 기억에 확인된 모든 STAR 항목, 역량 및 아티팩트. 각각 한 줄 요약과 id가 있습니다. 스캔하여 구축되며, Kene은 절대 입력하지 않습니다. 이것이 메뉴이며, "페이지에 무엇을 넣을 수 있는가"에 대한 답입니다.
- 글로벌 규칙 — 타겟과 관계없이 모든 변형에 속해야 하는 하나 또는 두 개의 플래그십 항목에 대한
always_include, 그리고 전혀 공개하고 싶지 않은 모든 것에 대한never_include.never는 변형별 선택을 포함한 모든 것을 이기며,**never가 모든 것을 이깁니다. 기술적으로 공유할 수 있지만 그가 앞세우고 싶지 않은 작업을 위한 올바른 장소입니다. - 변형별 선택 — id의 순서 있는 목록. 순서는 의미가 있으며 페이지는 주어진 그대로 렌더링합니다. 원페이지에서 첫 번째 항목이 인상의 대부분을 차지하기 때문입니다.
대화의 진행 방식. 새로운 변형에서, 이 스킬은 각 항목에 대한 이유와 함께 풀에서 선택을 제안하고, 해당 타겟에 대해 순위를 매깁니다. Kene은 평이한 언어로 추가, 삭제 및 재정렬합니다 — "두 번째는 빼고, 지불 작업을 맨 위로 옮기고, 협동조합에서 한 일을 추가해 줘." 한 번 확인되면 매니페스트에 기록됩니다.
재구축 시 조용히 다시 선택하지 않습니다. 기존 선택이 매번 시작점입니다. Kene이 큐레이팅한 페이지가 새로운 STAR 항목이 들어왔다고 조용히 재정렬되어서는 안 됩니다.
새로운 자료는 제안되며, 절대 삽입되지 않습니다. 기존 변형에 높은 순위를 매길 수 있는 항목이 은행에 들어오면, 분기별 갱신 시 한 번 제기됩니다 — "이것이 핀테크 변형에 잘 맞을 것 같습니다, 추가할까요?" 질문이지, 그를 대신해 적용된 diff가 아닙니다.
게시
정적 HTML, 단일 파일 + 에셋, 빌드 단계나 프레임워크 없음. 출력물은 읽을 수 있고 수동으로 편집 가능합니다. Kene이 수동으로 편집하고 싶어할 것이며, 그가 건드릴 수 없는 생성된 파일은 파일이 없는 것보다 더 나쁩니다.
호스팅이 요청되는 경우, 그리고 그가 신경 쓰지 않을 경우 어떻게 되는지
첫 게시 시, 한 번. 생성 시가 아닙니다. 첫 번째 게시 전에 Kene은 출력을 보고 싶어합니다. 이 스킬은 호스팅 장소를 묻습니다 — GitHub Pages, Netlify, Vercel, 자신의 도메인, 아무 데도 없음. 답변이 "상관없어"라면, 가장 쉬운 옵션을 추천하고 (GitHub Pages, 리포지토리의 docs/), "여기에 있습니다"라고 말하고 넘어갑니다. 결정을 내리기 위해 그를 절대 좌초시키지 않습니다.
그 후로는 묻지 않습니다. 호스팅 장소는 매니페스트에 기록되어 있으며, 재게시는 자동으로 같은 대상을 사용합니다. 변경하려면 그는 명시적으로 요청합니다.
게시 빈도는 "모든 것이 변할 때"가 아닌 의도적인 결정
변경 사항은 게시 큐에 쌓입니다. 페이지는 스킬 호출당 절대 게시되지 않으며, 세 가지 상황에서만 게시됩니다:
- 첫 번째 게시. 새 변형이 확인되면 저장되지 않고 게시됩니다.
- 분기별 갱신. 확인된 기억의 증분 변경 사항이 게시됩니다 (새 STAR 항목, 제거된 기존 항목, 업데이트된 역량). 모든 아티팩트 링크가 확인됩니다. 링크가 끊어지면 페이지가 게시되지 않고 리포팅됩니다.
- 수동 게시 요청. 그가 특정 변경 후 명시적으로 요청합니다.
규칙은: 포트폴리오는 항상 최신일 필요는 없으며, 항상 사실이어야 합니다. 갱신 간의 간격은 증분 개선이 게시 임계값을 넘지 못하게 합니다. 넘는다면 게시 간격이 너무 깁니다.
분기별 갱신 — 능동적이지만 방해하지 않음
4분마다 이 스킬이 매니페스트를 확인하고 변경 사항을 게시 큐에 나열합니다. 질문: "게시할 준비가 되었습니까?" 예/아니요. "아니요"는 블로킹이 아닙니다 — 다음 분기에 다시 확인합니다. "예"는 게시 전에 항상 Kene이 페이지를 최종 확인합니다.
Kene이 최종 확인을 건너뛰고 싶을 경우를 위한 단축키
명시적 확인은 건너뛸 수 없습니다:22-skill-handoff.md의 15분 규칙이 여기에 적용되며, 페이지는 그가 키보드를 떠나기 전에 본 마지막 것입니다. 이는 재량이 아니라 안전장치이며, 특히 페이지가 최신 사실이지만 게시한 사람의 의도를 더 이상 반영하지 않는 진술로 천천히 표류할 때 그렇습니다. 15분 규칙은 이 드리프트가 페치당 전체 개편으로 보이지 않도록 보장합니다.
게시되지 않은 (드래프트) 변형 — 실제 게시 전에 표시
게시된 변형과 드래프트 변형 사이에는 개념적 차이가 있습니다. 드래프트는 21-output-templates가 로컬 출력을 처리하는 것처럼 처리됩니다: Kene이 첫 번째 게시를 트리거할 때까지 파일 시스템에 생성되지만 게시되지 않습니다.
드래프트는 어떻게 작동하는가:
- 이 스킬은
shared/portfolio/variant_slug/를 생성하고 Kene이 선택을 확인합니다. - 페이지는 로컬에 조립되며 (
shared/portfolio/variant_slug/index.html), 게시되지 않습니다. - Kene이 브라우저에서 봅니다 (
open으로). - 게시 요청 시, 이 스킬이 게시합니다.
이것이 중요한 이유: 드래프트 사용자가 보기 전에 게시하면 그는 잘못된 것을 게시한 것입니다. 이 구분은 게시 단계를 지연시키지 않으며, 단지 Kene이 아니라 스킬이 언제 게시할지 결정하지 않도록 합니다.
드래프트는 리포지토리에 있으며, 게시 디렉토리 밖에 있음
shared/portfolio/의 모든 것은 버전 관리됩니다. 게시 대상은 (GitHub Pages의 docs/, Netlify의 게시 디렉토리) 별개의 출력입니다. 드래프트는 완전히 비공개이며, 소스 리포지토리에 접근할 수 있는 사람만 봅니다.
내 결정 — 이 스킬이 결정하는 것과 결정하지 않는 것
결정하기 쉬운 것 (압도적으로 단일 답변):
| 결정 | 왜 |
|---|---|
| Q: 새로운 타겟 역할에 대해 새 변형을 만들까? | A: 예. 포트폴리오가 없으면, 이력서를 반복할 때까지 더 나쁩니다. 리프레시 코드를 재사용합니다. |
| Q: 새 변형은 기존 콘텐츠를 재선택할까? | A: 아니요. Kene이 선택한 순서를 유지합니다. |
| Q: 포트폴리오에 모든 STAR 항목을 포함할까? | A: 아니요. 페이지 크기를 제한하려면 하위 집합이 필요합니다. |
| Q: 변형 간에 공유 아티팩트 링크 검증을 할까? | A: 예. 검증은 아티팩트당이며, 변형 형태에 구애받지 않습니다. |
결정하기 위한 질문을 제기하는 것 (이 스킬이 결정하지 않음):
| 질문 | 어디서 해결됨 |
|---|---|
| Kene이 이 변형에 만족하는가? | 15분 규칙, 최종 확인. |
| 어떤 워크 아이템이 이 타겟에 가장 잘 맞는가? | Kene의 선택, 스킬의 제안 후. |
| 호스팅 장소. | 게시 시 Kene의 선택. |
| 이것이 게시될 가치가 있는가 아니면 드래프트로 남을 것인가? | Kene의 게시 결정 — 자동 게시 없음. |