개인 웹사이트 생성기
「이력서 하나 + 링크 묶음 + 흩어진 결과물」을 정보 구조, 시각적 스타일, 바로 배포 가능한 정적 웹사이트로 만듭니다.
산출물: 순수 정적 HTML/CSS/JS (빌드 도구 없음, 프레임워크 없음, 단일 파일 CSS), Cloudflare Pages / Vercel / GitHub Pages에 바로 배포 가능.
핵심 원칙
- 순서를 바꾸지 마세요: 내용 → 구조 → 시각 → 코드 순서로 진행하세요. 처음부터 템플릿을 적용하거나 색상이나 글꼴을 묻지 마세요.
- 네 가지 정보 유형을 구분하세요: 사용자가 확인한 사실 / 출처 원문 요약 / AI가 작성한 초안 / 확인이 필요한 추론. 경험, 숫자, 고객, 평가, 신원, 협력 관계를 지어내지 마세요.
- 기본적으로 개인정보를 보호하세요: 휴대폰 번호, 주소, 개인 이메일, 고객 자료를 공개하기 전에 반드시 개별 확인을 받으세요.
- 템플릿을 채우기 위해 빈 섹션을 만들지 마세요: 자료가 부족하면 내용 깊이를 낮추거나 누락 항목을 나열하고, 자리 채우기용 사례를 사용하지 마세요.
- 추천이 포함된 옵션을 제공하세요: 각 결정 지점마다 실질적으로 다른 2-3가지 방안과 명확한 추천을 제시하고, 선택을 전적으로 사용자에게 떠넘기지 마세요.
- 배포는 외부 공개 행위입니다: 사용자가 명시적으로 승인한 경우에만 실행하세요.
워크플로
① 범위 설정 → ② 자료 수집 → ③ 정보 계층 결정 → ④ 시각 스타일 결정 → ⑤ 생성 → ⑥ 검수 → ⑦ 승인 후 배포
① 범위 설정
먼저 신규 구축인지 기존 사이트 개선인지 판단하세요.
- 기존 프로젝트가 있는 경우: 디렉토리 구조, 기존 페이지, 콘텐츠 출처, 빌드 명령어, 배포 설정, git 상태를 먼저 읽고, 기존 기술 스택과 디자인 제약을 따르세요. 처음부터 다시 시작하지 마세요.
- 신규 구축: 기본적으로 가벼운 반응형 정적 사이트를 선택하세요. CMS, 로그인 또는 동적 데이터가 정말 필요한 경우에만 프레임워크나 백엔드를 도입하세요.
그런 다음 방향을 정하는 한 가지 질문만 하세요:
"이 웹사이트는 주로 누구를 대상으로 하나요? 그들이 보고 나서 무엇을 하길 바라나요?"
이 단계에서는 색상, 글꼴, 애니메이션을 묻지 마세요.
② 자료 수집
references/intake.md를 읽으세요 (최소 시작 자료, 점진적 질문 순서, 콘텐츠 엔터티 필드, 증거 수준, 개인정보 규칙, 수집 가능한 출처 표 포함).
핵심 사항:
- 첫 응답은 가볍게 하세요. 사용자가 이미 가진 자료를 말했으므로, 첫 응답에서는 그 자료를 보내달라고만 요청하세요. 첫 번째 자료를 읽은 후에 다음 질문을 하세요. 한 번에 다음 단계에 가장 영향을 미치는 한 가지 질문만 하세요. 열 가지 항목이 있는 양식을 던지지 마세요.
- 먼저 읽을 수 있는 것은 읽으세요. 묻지 마세요. 이력서(Read / docx / pdf skill), GitHub, 블로그, 위챗 공식 계정 (WebFetch), 로그인이 필요한 플랫폼 (claude-in-chrome). 로그인 장벽, 캡차, 크롤링 방지를 만나면 즉시 중단하고 사용자에게 내보내기 파일, 텍스트, 링크 목록 또는 스크린샷을 제공하도록 요청하세요.
- 형용사보다 숫자를 우선시하고, 검증 가능한 표현만 사용하세요. "10개 제품, 5만 사용자, 거의 200개의 Skill"이 "경험 풍부"보다 낫습니다. 검증할 수 없는 것은 추정치를 보충하지 마세요.
- 여러 플랫폼에 걸친 중복 콘텐츠는 하나의 콘텐츠 엔터티로 병합하고 여러 출처 링크를 유지하세요. 정보가 충돌하면 두 버전을 모두 유지하고 사용자에게 확인을 요청하세요.
수집이 완료되면 자료 목록 확인 (있음 / 확인 필요 / 누락 / 추가 제안)을 출력하고, 사용자가 확인한 후 다음 단계로 진행하세요.
③ 정보 계층 결정
references/architectures.md를 읽으세요. 이중 축으로 결정합니다:
축 1 · 웹사이트 목표 (하나의 주요 목표를 선택하고, 최대 하나의 보조 목표를 추가할 수 있음)
| 사용자 자료 유형 | 주요 목표 |
|---|---|
| 업무 경험, 기술, 학력, 이력서 제출 | 구직 전환 |
| 프로젝트 / 디자인 / 사진 / 비디오, 시각 자료가 많음 | 포트폴리오 전시 |
| 인생 이야기 + 관심사 + 가치관, 완성된 결과물이 거의 없음 | 개인 소개 |
| 오랫동안 써온 글 / 읽은 책 / 걸어온 길, 아카이빙 목적 | 장기 기록 |
| 컨설팅, 원고 의뢰, 멘토링, 상업 문의 수주 | 컨설팅 고객 유치 |
| 위챗 공식 계정 / X / 샤오홍슈 / 팟캐스트, 팔로워와 콘텐츠 자산 보유 | 크리에이터 홈페이지 |
| 제품 출시 경험, 오픈소스 프로젝트, 사용/구매 유도 | 독립 개발자 |
축 2 · 콘텐츠 깊이 (자료량에 의해 결정되며, 희망에 의해 결정되지 않음)
L1 명함 레벨— 단일 페이지, 신원 / 포지셔닝 / 주요 행동 / 3개의 대표 링크만 있으면 됨. 자료가 부족하거나 빠른 출시가 필요할 때.L2 증명 레벨— 홈페이지 + 프로젝트/경험 상세 페이지. 개인 기여, 과정, 결과, 미디어 자료 필요.L3 콘텐츠 시스템 레벨— 홈페이지 + 상세 페이지 + 분류 색인 + 아카이브 + 지속적 업데이트 메커니즘. 안정적인 콘텐츠 소스와 업데이트 의지 필요.
자료가 L2를 뒷받침하지 못하면 L1부터 시작하세요. 지속적인 업데이트 능력이 없으면 L3를 선택하지 마세요.
architectures.md의 템플릿에 따라 실질적으로 다른 2-3가지 방안을 출력하세요 (차이는 방문자의 작업에서 비롯되어야 하며, 단순히 섹션 이름을 바꾸는 것이 아님). 각 방안에 대해 다음을 명시하세요: 대상 사용자 / 첫 화면 약속 / 주요 행동 / 네비게이션 / 홈페이지 순서 / 사용된 기존 자료 / 추가로 필요한 자료 / 주요 트레이드오프. 명확하게 하나를 추천하고, 사용자가 확인한 후 시각 단계로 진행하세요.
④ 시각 스타일 결정
먼저 한 가지 질문을 하세요: "마음에 드는 웹사이트나 디자인이 있나요? 있다면 링크나 스크린샷을 보내주세요." 형용사 목록에서 고르게 하는 것보다 참조물이 훨씬 더 정확합니다.
사용자가 가진 것에 따라 세 가지 경로:
- 사용자가 참조 URL / 스크린샷 / 디자인 가이드를 제공한 경우 →
references/style-extraction.md를 읽으세요. 먼저 claude-in-chrome으로 참조 사이트를 열고, 그 안의 스크립트를 실행하여 실제 computed style (글꼴 스택, 색상 값, 둥근 모서리, 그림자, 컨테이너 너비)을 샘플링하고, 밝은/어두운 테마 각각 샘플링하세요. 열리지 않거나 로그인이 필요하면 스크린샷 분석으로 대체하세요. 분위기를 추출하고, 사이트 전체를 복제하지 마세요. 로고, 카피, 일러스트레이션, 독창적인 레이아웃은 가져오지 마세요. - 사용자가 브랜드 이름을 말한 경우 ("Notion 스타일로 해주세요", "Apple 느낌으로") → brand-design-md skill을 호출하여 DESIGN.md를 가져오고,
site.css의:root변수에 매핑하세요. - 사용자가 참조물이 없는 경우 →
references/visual-styles.md를 읽고, 6가지 내장 스타일에서 2-3가지 방향과 추천 이유를 제시하세요. 각 방향에는 바로 붙여넣을 수 있는 CSS 변수 값이 포함됩니다.
사용자가 여러 개의 참조 사이트를 제공한 경우, 먼저 "어느 사이트의 느낌을 가장 원하나요? 다른 사이트에서는 구체적으로 어떤 점이 마음에 드나요?"라고 물어보세요. 대부분의 사람들은 A의 레이아웃과 B의 색상 조합을 좋아하지만, 교집합을 만들면 정체불명의 결과가 나옵니다.
사용자가 WordPress / Framer / Webflow / Notion을 언급한 경우, 정보 구조와 분위기만 참고하고 해당 플랫폼의 테마나 프로젝트를 생성하는 척하지 마세요.
어떤 경로를 선택하든, 최종적으로는 :root 변수만 수정하고 site.css의 컴포넌트 부분을 다시 작성하지 마세요. 선택이 완료된 후에 코드를 작성하세요.
⑤ 사이트 생성
assets/starter/를 복사하여 시작하세요:
site.css— CSS 변수 + 타이포그래피 기준 + 카드/목록 컴포넌트, 밝은/어두운 두 테마. 스타일 변경 =:root변수 변경, 전체 파일을 다시 작성하지 마세요.nav.js— 단일 파일로 주입되는 고정 상단바 (다크 모드 전환 + 스크롤 시 숨김). 상단 설정 영역에서SITE_NAME/LINKS/THEME_KEY를 변경하세요. 인라인 CSS의760px는site.css의--max와 일치해야 합니다.index.html— 홈페이지骨架, 섹션은 방안에 따라 추가/삭제.
반드시 충족해야 할 사항:
- 첫 화면에 본인 이름 또는 일반적으로 사용하는 호칭 + 포지셔닝 + 하나의 주요 행동이 나타나야 함. 주요 행동은 하나만, 보조 행동은 최대 하나.
- 네비게이션은 확인된 정보 아키텍처를 반영해야 하며, 플랫폼 템플릿 섹션을 그대로 복사하지 않아야 함. 항목은 4-6개.
- 작품은 문제 / 본인의 역할 / 접근 방식 / 결과를 우선 설명하고, 썸네일만 배치하지 않음.
- 소셜 링크에는 이 플랫폼에서 무엇을 볼 수 있는지 설명하고, 아이콘만 나열하지 않음.
- 각 페이지는 독립적인
xxx/index.html을 사용하고,/site.css와/nav.js를 공유함. CDN, 프레임워크, 빌드 단계를 도입하지 않음. <title>,<meta name="description">, favicon, 공유 이미지가 완비되어야 함. 외부 링크는target="_blank" rel="noreferrer".- 데스크톱 + 모바일에서 원활하게 탐색 가능. 키보드로 주요 흐름 완료 가능. 시맨틱 구조와 alt 속성 완비.
prefers-reduced-motion지원. - 이미지는 실제 작품/인물/스크린샷을 사용. 이미지가 없으면 먼저 자료를 요청하고, 생성된 이미지는 생성된 자료임을 명시해야 함.
- "제 개인 웹사이트입니다", "다음은 제 작품입니다"와 같은 안내 문구를 디자인 요소로 사용하지 않음.
중국어 타이포그래피: 줄 높이 ≥ 1.7, 단락 간격 ≥ 18px, 글꼴 스택에 PingFang SC를 유지. 더 강력한 프론트엔드 디자인 능력이 필요하면 frontend-design skill을 호출.
⑥ 검수
references/delivery-checklist.md를 읽고 항목별로 확인하세요. 최소한 다음을 검증하세요:
- 홈페이지, 네비게이션, 상세 페이지, 외부 링크, 주요 행동
- 360 / 390 / 768 / 1280 / 1440 다섯 가지 너비
- 가장 긴 이름과 제목이 넘치지 않음. 빈 콘텐츠, 이미지 로드 실패, 외부 링크 실패 시의 동작
- 콘솔에 사용에 영향을 주는 오류가 없음. 의도치 않은 가로 스크롤 및 레이아웃 겹침이 없음
- 밝은/어두운 두 테마 모두 읽기 가능 (대비율 ≥ 4.5:1)
- 사이트 내에 TODO 자리 표시자, 가상의 숫자, 테스트 링크가 남아 있지 않음
- 공개된 정보가 사용자가 확인한 목록과 일치함
python3 -m http.server로 로컬 미리보기를 실행하거나, claude-in-chrome으로 스크린샷을 찍어 사용자가 게시 전에 확인하도록 하세요.
⑦ 승인 후 배포
먼저 어디에 게시할지, 공개 여부, 어떤 저장소/계정을 사용할지, 어떤 도메인이나 환경 변수를 변경할지 설명하고 명시적 승인을 받은 후에 실행하세요.
- 기존 프로젝트는 기존 배포 방식을 따름. 새 정적 사이트는 Cloudflare Pages / Vercel / GitHub Pages를 우선 사용 (빌드 명령어는 비워두고, 출력 디렉토리는 사이트 루트로 설정).
- 먼저 빌드 → 게시 → 프로덕션 URL에 접속하여 주요 콘텐츠 확인. 미리보기 성공이 사용자 정의 도메인 적용을 의미하지는 않음.
- 비밀 키, 이력서 원본, 플랫폼 내보내기 데이터를 사이트에 패키징하지 마세요.
최종 전달 사항
간결하게 나열: 선택된 목표와 콘텐츠 깊이 / 구현된 페이지 및 주요 콘텐츠 / 접속 주소 / 검증 결과 / 아직 공개되지 않았거나 추가해야 할 콘텐츠. 긴 설명으로 완료되지 않은 코드, 검수 또는 배포를 감추지 마세요.
하지 말아야 할 목록
- ❌ 홈페이지에 모든 콘텐츠를 채워 넣음 — 첫 화면 3초 안에 "당신은 누구인가 + 무엇을 할 수 있는가 + 어떻게 찾는가"를 명확히 하고, 나머지는 모두 하위로 내림
- ❌ "기술을 사랑하고, 탁월함을 추구합니다"와 같은 빈말 — 검증 가능한 사실과 숫자로 대체
- ❌ 사용자가 제공하지 않았는데도 경험, 프로젝트, 숫자, 고객 평가를 지어냄
- ❌ 한 번에十几个 질문을 던지거나, 자료 확인 및 방안 확인을 건너뛰고 바로 코드를 작성
- ❌ 자료가 부족한데 L3를 강행하고, 빈 블로그와 자리 채우기 사례로 채움
- ❌ 복잡한 애니메이션, 그라데이션 남발, 각 섹션마다 다른 글꼴 — 개인 웹사이트의 신뢰성은 절제에서 비롯됨
- ❌ 참조 사이트 전체를 복사하여 이름만 바꿈 — 추출해야 할 것은 색상/레이아웃/간격의 분위기이지, 로고, 카피, 일러스트레이션, 독창적인 레이아웃이 아님
- ❌ 승인 없이 push / 배포 / 연락처 공개