Portfolio Maker: 독립적 디자인 & 엔지니어링 스킬
독립적 & 자급자족: 이 스킬은 완전한 자율성으로 작동합니다. 외부의 제3자 디자인 또는 애니메이션 스킬에 의존하거나 위임하거나 요구하지 않습니다. 모든 미적 직관, 타입그래피 계산, 공간 조화, 마이크로 인터랙션 동역학, 안티 슬롭(Anti-Slop) 적용, 컴포넌트 프리미티브는 이 스킬에 네이티브로 내장되어 있습니다.
🎯 주요 목적 및 사명
아마추어적이고 평범한 'AI 슬롭' 포트폴리오를 없애고, 5가지 핵심 아키타입의 모든 전문가를 위한 수상 경력에 빛나는 프로덕션급 포트폴리오를 자율적으로 제작합니다.
- 소프트웨어 엔지니어 및 시스템 아키텍트 (분산 시스템, 고처리량 API, 깔끔한 기술 벤토)
- 비디오 에디터, 모션 그래픽 및 크리에이터 (바이럴 쇼릴, 비교/대비 색보정 예시, 조회수 지표)
- 프로덕트 디자이너 및 UI/UX 리드 (디자인 시스템, 케이스 스터디, 고대비 스위스 타입그래피, 토큰 분석)
- AI/ML 연구원 및 데이터 엔지니어 (모델 아키텍처, arXiv 논문, 벤치마크 텔레메트리, 가중치 배지)
- 에이전시, 컨설턴트 및 솔로프러너 (사회적 증명, 고객 리뷰, 서비스 등급, 매끄러운 예약 전환)
🚫 반(反) AI 슬롭 명예 규약 (엄격 적용)
생성되는 모든 포트폴리오는 코드를 출력하기 전에 이 엄격한 미적 필터를 반드시 통과해야 합니다.
1. 금지된 비주얼 슬롭:
- ❌ 절대 보라색/바이올렛 네온 그라데이션 클리셰 사용 금지:
from-purple-500 via-indigo-500 to-pink-500헤드라인 텍스트 금지. 흐릿한 보라색 배경 빛 구체(bg-purple-500/10 blur-3xl) 금지. - ❌ 평평하고 지루한 회색 박스 그리드 금지: 깊이나 질감이 전혀 없는 기본 Tailwind
bg-gray-100/border-gray-300블록 사용 금지. - ❌ 과포화 레이저 테두리 금지: 강렬한 신스웨이브 네온 스트로크 사용 금지.
2. 승인된 엘리트 컬러 팔레트:
- 티타늄 모노크롬 (스위스 다크/라이트): 진한 흑요석 캔버스(
#09090b), 돌출된 카드 레이어(#121215+backdrop-blur-md), 헤어라인 테두리(border-white/[0.08]), 선명한 흰색 헤딩(#ffffff), 징크 흐릿한 텍스트(#a1a1aa), 미묘한 슬레이트/흰색 스포트라이트(rgba(255,255,255,0.06)). - 프리시전 에메랄드 & 슬레이트: 흑요석 캔버스(
#09090b), 에메랄드 라이브 상태 표시기(#10b981), 모노크롬 카드에 미묘한 민트 호버 악센트. - 인터내셔널 일렉트릭 코발트: 진한 차콜 캔버스(
#0a0a0f), 선명한 흰색 타입그래피, 고대비 일렉트릭 로열 블루(#2563eb) 상호작용 대상 및 버튼. - 웜 건축 샌드 & 에스프레소: 따뜻한 크림 캔버스(
#fafaf9), 풍부한 에스프레소 헤딩(#18181b), 미묘한 샴페인/앰버(#d97706) 악센트. - 시네마틱 로즈 & 앰버: 흑요석
#0b0c10캔버스, 고임팩트 로즈(#e11d48)와 따뜻한 앰버(#f59e0b) 악센트 (크리에이티브 및 비디오 쇼릴용).
3. 금지된 AI 플러프(Fluff) 카피:
- ❌ 금지: "아이디어를 우아한 디지털 솔루션으로 변환하는 열정적인 개발자."
- ❌ 금지: "디자인, 기술, 공감의 교차점에서 혁신을 주도합니다."
- ❌ 금지: "문제 해결 능력을 갖춘 결과 지향적인 전문가."
- ✅ 필수: 구체적이고, 메트릭 기반이며, 영향력에 초점을 맞춘 진술:
- "14ms p99 지연 시간으로 120k req/s를 처리하는 분산 Go 마이크로서비스 구축."
- "7500만 이상의 유기적 조회수를 생성한 바이럴 장편 YouTube 다큐멘터리 편집."
- "42개 엔지니어링 스쿼드에 걸쳐 채택된 멀티 브랜드 Figma 디자인 토큰 시스템 주도."
🧠 네이티브 미적 엔진 (내장된 디자인 인텔리전스)
AI는 모든 요소에 다음 수학적 디자인 법칙을 적용해야 합니다.
1. 타입그래피 계층 & 광학 리듬
- 디스플레이 헤드라인 (
text-4xl~text-6xl md:text-7xl) :- 줄 간격은 빡빡해야 함 (
leading-[1.08]~leading-[1.12]). 큰 글꼴에 느슨한 행간은 아마추어처럼 보임. - 자간은 좁혀야 함 (
tracking-tight또는tracking-tighter). - 글꼴 두께: 기술 분야는 Bold 또는 Extrabold (
font-bold/font-extrabold); 에디토리얼 세리프는 Medium 또는 Semibold (font-medium/font-semibold).
- 줄 간격은 빡빡해야 함 (
- 본문 (
text-base~text-lg) :- 줄 간격은 넉넉해야 함 (
leading-relaxed또는leading-7) (가독성 보장). - 줄 길이(Measure):
max-w-xl또는max-w-2xl을 사용하여 본문 너비 제한 (줄당 45~75자). 문단을 전체 화면 너비로 늘리지 마세요. - 텍스트 정렬: 본문 텍스트 3줄 이상을 연속으로 중앙 정렬하지 마세요. 인간의 독서 인체 공학을 위해 왼쪽 정렬.
- 줄 간격은 넉넉해야 함 (
- 큐레이티드 폰트 페어링:
- 모던 테크:
Inter또는Geist Sans+ 태그 및 코드용JetBrains Mono. - 고임팩트 크리에이티브:
Plus Jakarta Sans또는Syne+Inter. - 에디토리얼 & 럭셔리:
Cormorant Garamond(세리프 디스플레이) +Inter(산세 본문).
- 모던 테크:
2. 공간 리듬 & 8포인트 수학 그리드
- 섹션 패딩: 넉넉한 수직 여백 (
py-20 md:py-28). 좁은 섹션은 디자인을 질식시킴. - 레이아웃 스택: 주요 섹션 간의 수직 간격은
space-y-24또는space-y-28를 사용. - 카드 그리드:
gap-6또는gap-8로 표준화. - 콘텐츠 너비 컨테이너:
- 에디토리얼 / 미니멀리스트:
max-w-4xl mx-auto px-6 - 개발자 벤토:
max-w-5xl mx-auto px-4 sm:px-6 - 미디어 쇼릴:
max-w-6xl mx-auto px-4 sm:px-6
- 에디토리얼 / 미니멀리스트:
3. 표면 높이 & 헤어라인 테두리 과학
- 레이어 0 (캔버스):
#09090b(다크) /#fafaf9또는#ffffff(라이트). - 레이어 1 (카드 베이스):
#121215/bg-white dark:bg-zinc-900/60+backdrop-blur-md. - 레이어 2 (헤어라인 테두리):
border border-zinc-200/80 dark:border-zinc-800/80또는border border-white/[0.08]. 무겁고 지저분한 드롭 섀도우는 절대 사용 금지. - 레이어 3 (마이크로 호버): 커서를 따라가는 방사형 스포트라이트 (
rgba(255,255,255,0.06)), 또는 미묘한 테두리 밝기 증가hover:border-zinc-400 dark:hover:border-zinc-700, 미묘한 들림 효과hover:-translate-y-0.5 transition-all duration-300.
4. 인터랙티브 디테일 & 마감 처리
- 라이브 상태 표시기:
<div class="inline-flex items-center gap-2 px-3 py-1.5 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border border-emerald-500/20"> <span class="w-2 h-2 rounded-full bg-emerald-500 animate-pulse"></span> <span>2026년 1분기 기회에 열려 있습니다</span> </div> - 원클릭 이메일 복사 필 (시각적 피드백 포함): "복사됨!"을 확인하는 툴팁 전환과 함께 즉시 클립보드 복사 제공.
- 듀얼 모드 테마 전환기:
아이콘 모핑과
localStorage지속성을 갖춘 작동하는 테마 토글(다크/라이트)을 항상 포함.
📦 검증된 컴포넌트 무기고 (직접 접근)
이 스킬에는 검증된 프로덕션 준비 TSX 프리미티브와 전체 카탈로그가 포함되어 있습니다.
1. 시그니처 히어로 (components-library/heroes/):
ImageStreamHero.tsx: 깊이감 있는 소실점 스트리밍 레일 (크리에이터 및 비디오 에디터)PerspectiveTunnelHero.tsx: 라이브 메트릭이 있는 3D Z축 공간 원근 (엔지니어 및 아키텍트)ProductRailGallery.tsx: 스윙 물리학이 있는 인터랙티브 의류 랙 (전자상거래 및 패션)TiltedGridHero.tsx: 시청자 쪽으로 휘어지는 곡선 3D 이미지 스트림 (UI/UX 디자이너 및 사진작가)PrismHero.tsx: 크로매틱 크리스털 굴절 셰이더 미학 (아트 디렉터 및 럭셔리 포트폴리오)TigerTearRevealHero.tsx: 인터랙티브 티어 리빌 슬로건 효과 (고임팩트 크리에이티브)AgencyHero01.tsx: 소셜 아바타 및 평점 배지가 있는 높은 신뢰도의 에이전시 히어로 (프리랜서 및 에이전시)ResponsiveHeroBanner.tsx: 유리 형태(Glassmorphic) 내비게이션이 있는 시네마틱 배너 (창업자 및 리더)CenteredImageFanHero.tsx: 3-이미지 부채꼴 콜라주가 포함된 하이라이트 헤드라인 (프로덕트 디자이너)
2. 독립형 인터랙티브 프리미티브 (components-library/):
- 배경:
backgrounds/AuroraBackground.tsx(미묘한 에메랄드/시안/슬레이트 웨이브, 네온 퍼플 없음) - 인터랙티브 카드:
cards/SpotlightCard.tsx(마우스 추적 광선),cards/Card3D.tsx(원근 기울기),cards/BorderBeam.tsx(애니메이션 헤어라인 테두리 빔),cards/Meteors.tsx(유성 입자) - 섹션 & 레이아웃:
sections/BentoGrid.tsx(비대칭 반응형 그리드),sections/InfiniteMarquee.tsx(끊김 없는 기술/로고 티커),sections/BeforeAfterSlider.tsx(인터랙티브 이미지/비디오 비교),sections/VideoModal.tsx(시네마틱 비디오 팝업),sections/TerminalWidget.tsx(시뮬레이션된 인터랙티브 CLI) - UI 컨트롤:
ui/FloatingNav.tsx(떠 있는 유리 형태 필 내비게이션 바),ui/ShimmerButton.tsx(반짝이는 액션 버튼),ui/TextGenerateEffect.tsx(엇갈린 단어 드러내기),ui/CopyEmailButton.tsx(원클릭 복사 필),ui/ThemeToggle.tsx(다크/라이트 테마 전환)
3. 마스터 컴포넌트 인덱스:
- 21st.dev 마스터 카탈로그 전체는
components-library/catalog/INDEX.md에서 확인 가능하며, 22개 카테고리(버튼, 히어로, 갤러리, 기능, 가격, 푸터, FAQ 등)에 걸쳐 11,750개 이상의 분류된 컴포넌트를 포함합니다.
4. 공식 shadcn MCP 서버 (API 키 불필요):
- AI는 공식 shadcn MCP 서버 (
npx shadcn@latest mcp)를 사용하며, 이는 100% 무료 오픈소스이며 API 키가 전혀 필요하지 않습니다. - 카탈로그의 모든 컴포넌트는 다음을 통해 설치할 수 있습니다:
npx shadcn@latest add "https://21st.dev/r/<author>/<component-name>" - 유료 21st.dev MCP 또는 API 키가 필요하지 않습니다.
5. 프리미엄 템플릿 및 모션 디자인 영감:
AI는 세계에서 가장 프리미엄인 디자인 생태계의 아키텍처 패턴, 운동 역학, 높은 전환율의 레이아웃을 적극적으로 활용할 수 있습니다:
- VibeUI (
vibeui.dev): 현대적인 컴포넌트 구성, 촉각적 카드 스택, 인터랙티브 배지, 떠 있는 제어 필 및 미적 레이아웃 프리미티브. - Trical (
trical.so): 매우 깔끔하고 전환율이 높은 포트폴리오 템플릿, 매거진급 타입그래피, 미묘한 구분선, 에디토리얼 프로젝트 케이스 스터디. - Motion Site (
motion.site.ai): 유동적인 마이크로 애니메이션, 운동학적 헤드라인 드러내기, 스프링 물리학, 유기적 전환 곡선. - 21st.dev & Aceternity UI: 11,750개 이상의 shadcn 호환 컴포넌트 및 공간 3D 상호작용 프리미티브의 마스터 카탈로그.
⚡ 이중 전달 모드
AI는 사용자의 필요에 따라 두 가지 유연한 전달 형식을 지원합니다.
모드 A: 전체 React + Vite + Tailwind (TypeScript) 코드베이스 (기본값)
완전하고 모듈식이며 엔터프라이즈급 프로젝트 구조를 생성합니다:
my-portfolio/
├── package.json
├── vite.config.ts
├── tailwind.config.js
├── postcss.config.js
├── tsconfig.json
├── index.html
└── src/
├── main.tsx
├── App.tsx
├── index.css
├── components/
│ ├── ui/ (Spotlight, ThemeToggle, CopyEmailButton, FloatingNav)
│ └── sections/ (Hero, BentoGrid, Projects, Experience, Footer)
└── types/index.ts
모드 B: 즉시 사용 가능한 단일 파일 HTML/Tailwind/Lucide/JS
사용자가 별도 설정 없이 즉시 로컬 브라우저에서 미리 보거나 (예: GitHub Pages) 즉시 호스팅하기를 원할 때:
- 아름답게 포맷된 단일 자체 포함
index.html을 생성합니다. - Tailwind CSS CDN, Google Fonts, Lucide Icons CDN, 테마 전환, 복사 피드백, 모달 팝업 및 호버 상호작용을 위한 바닐라 JS를 포함합니다.
- 프로덕션 참조 구현은
templates/developer-bento/index.html,templates/creative-minimalist/index.html,templates/video-editor-showreel/index.html에서 확인할 수 있습니다.
🛠️ 단계별 실행 워크플로우
┌────────────────────────────────────────────────────────┐
│ 1단계: 정보 수집 및 이력서 추출 │
│ 지표, 역할, 프로젝트, 기술 스택 추출 │
│ (또는 3배치 대체 설문지 실행) │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 2단계: 필수 대화형 정렬 │
│ 질문: 미적 스타일, 테마 모드, 히어로 및 컴포넌트 선택 │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 3단계: 컴포넌트 선택 및 아키텍처 │
│ components-library/에서 21st.dev 프리미티브 조합 │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 4단계: 프로덕션 코드 생성 │
│ React + Vite (기본값) 또는 독립형 HTML 생성 │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 5단계: 감사 및 실행 지침 │
│ 안티 슬롭 규칙 확인, 빌드 검증, 명령어 제공 │
└────────────────────────────────────────────────────────┘
1단계: 정보 수집 프로토콜
- 사용자가 이력서 또는 LinkedIn 요약을 제공하는 경우: 실제 지표, 경력 타임라인, 상위 3~4개 프로젝트 및 기술 역량을 파싱합니다.
- 이력서가 제공되지 않은 경우: 절대 자격을 허위로 만들어서는 안 됩니다. references/questionnaire.md에서 3배치 설문지를 실행합니다:
- 배치 1: 정체성 및 목표 역할
- 배치 2: 상위 2~3개 프로젝트 및 구체적인 수치
- 배치 3: 소셜 및 연락처 링크
2단계: 필수 대화형 정렬 (건너뛰지 마세요)
사용자가 시각적 스타일과 컴포넌트를 미리 지정하지 않는 한, 일시 중지하고 대화형 정렬을 제시합니다:
*"포트폴리오를 생성하기 전에 시각적 디자인과 인터랙티브 컴포넌트를 맞춤 설정해 보겠습니다:
- 시각적 스타일 / 미학:
- 슬릭 테크 / 다크 벤토 (Linear / 21st.dev 스타일 — 흑요석 캔버스, 스포트라이트 호버 카드, 헤어라인 테두리).
- 클린 미니멀리스트 / 스위스 모던 (Dieter Rams / Apple 스타일 — 넉넉한 여백, 정제된 타입그래피, 미묘한 선).
- 고대비 에디토리얼 (세리프 헤드라인, 스튜디오 미학, 매거진 스타일 케이스 스터디).
- 시네마틱 크리에이터 / 모션 (깊고 어두운 캔버스, 풍부한 비디오 쇼릴 임베드, 조회수 배지).
- 네오-브루탈리즘
[번역이 잘렸습니다]