반응형 개인 사이트 빌더 (Responsive Personal Site Builder)
핵심 규칙 (Core Rule)
최종 웹사이트를 단순한 디자인 연습이나 플레이스홀더 목업이 아닌 실제 공개 서비스로 취급하세요.
HTML/CSS/컴포넌트로 실제 반응형 구조를 구축하고, 실제 자산이 있으면 사용하며, 텍스트는 읽고 편집 가능하게 유지하며, 데스크톱과 모바일 모두에서 의도적으로 설계된 페이지를 만드세요.
기본 작동 모드 (Default Operating Mode)
사용자가 명시적으로 먼저 계획을 요청하지 않는 한, 자동 파일럿 모드 (autopilot mode) 로 진행합니다:
- 콘텐츠와 목표를 이해합니다.
- 첫 번째 로컬 프리뷰를 빌드합니다.
- 레이아웃과 상호작용을 다듬습니다.
- 브라우저 댓글을 수정합니다.
- 죽은 코드를 정리합니다.
- 승인 후 배포 핸드오프를 준비합니다.
다음과 같은 진정한 차단 요소에 대해서만 후속 질문을 합니다:
- 핵심 사본이 누락된 경우,
- 사용 가능한 자산이 없고 대체 자산을 생성하거나 추론할 권한이 없는 경우,
- 브랜드/법적 요구사항이 불분명한 경우,
- 공개적으로 표시되어야 하는 연락처 세부 정보가 불분명한 경우.
워크플로 (Workflow)
-
웹사이트 목표 이해
- 이 사이트가 무엇인지 결정합니다: 개인 포트폴리오, 크리에이터 페이지, 서비스 소개, 롱스크롤 캠페인 페이지, 코스 프로모션 페이지 또는 브랜드 원페이지 홈페이지.
- 주요 전환 목표를 결정합니다: 작업展示, 자기 소개, 문의 수집, WeChat/이메일 유도, 제품/코스 제공.
- 사용자가 스타일 참조, 스크린샷 또는 기존 사이트 URL을 제공하면 이를 시각적 방향으로 취급합니다.
-
사용 가능한 입력물 목록화
- 사용 가능한 모든 사본, 스크린샷, 내보낸 이미지, 로고, 아이콘, 비디오, QR 코드 및 지원 파일을 읽습니다.
- 승인된 사본과 AI 작성 가능 사본 영역을 구분합니다:
- 승인된 사본: 사용자가 제공한 헤드라인, 바이오, 서비스 문구, 캠페인 문구, 날짜, 가격, 규칙, 연락처 라인.
- AI 작성 가능 사본 영역: 섹션 연결 문구, 지원 텍스트, 레이블, 짧은 CTA 라인, 소개 문구, 간결한 설명 텍스트.
- 실제 콘텐츠 자산과 레이아웃 참조를 구분합니다:
- 실제 자산: 로고, 사진, 제품 렌더링, QR 코드, 비디오 클립, 소셜 스크린샷, 실제 일러스트레이션.
- 레이아웃 참조: 스크린샷, 예시 사이트, 이전 페이지 캡처, 포스터, 대략적인 목업.
- 사용자가 이름 없는 자산을 많이 제공하면 레이아웃을 다듬기 전에 깔끔한 로컬 명명 체계로 정리합니다.
- 대략적인 참조만 있는 경우, 무기한 기다리지 않고 콘텐츠에서 실용적인 사이트 구조를 추론합니다.
-
페이지 구조 정의
- 코딩 전에 입력물을 실제 웹사이트 시퀀스로 변환합니다.
- 구조는 무작위 섹션 축적이 아닌 표현 목표에 의해 주도되도록 유지합니다.
- 일반적인 원페이지 구조는 다음과 같습니다:
- 오프닝 소개,
- 히어로,
- 소개 / 포지셔닝,
- 시스템 / 역량 / 서비스 로직,
- 작업 갤러리,
- 지원 강점,
- 연락처 / CTA,
- 푸터.
- 포트폴리오 중심 사이트의 경우 작업과 증거를 우선시합니다.
- 소개 중심 사이트의 경우 포지셔닝과 전환 명확성을 우선시합니다.
- 사용자가 명시적인 섹션 요구사항을 제공하면 따릅니다.
- 사용자가 모든 블록에 충분한 사본을 제공하지 않으면 사이트 목적을 지원하고 전체 스토리를 일관성 있게 유지하는 간결한 새 사본을 작성합니다.
-
디자인 시스템 생성
- 사용자가 디자인 규칙을 제공하지 않으면 정의합니다.
- 시각적 구현 전에
references/design-system-and-layout.md를 읽습니다. - 다음을 결정합니다:
- 페이지 너비,
- 중단점,
- 타이포그래피 척도,
- 간격 리듬,
- 카드 모서리 반경,
- 버튼 처리,
- 색상 팔레트,
- 텍스처/배경 전략,
- 애니메이션 제한 수준.
- 중국어와 영어 타이포그래피를 의도적으로 유지하고, 만능 스타일링을 피합니다.
-
첫 번째 반응형 버전 구축
- 요청에 가장 적합한 가장 간단한 스택을 선호합니다.
- 대부분의 개인 사이트와 프로모션 페이지에는 정적 HTML/CSS/JS를 선호합니다.
- 모든 주요 블록을 실제 반응형 섹션으로 구축합니다.
- 큰 스크린샷을 최종 페이지 섹션으로 사용하지 마십시오.
- 이미지 자체가 콘텐츠인 경우에만 이미지 자산을 사용합니다.
- 텍스트는 선택 가능하고, 접근 가능하며, 편집 가능하게 유지합니다.
- 첫 번째 전체 패스를 볼 수 있게 되는 즉시 로컬 프리뷰를 시작합니다.
-
상호작용 및 모션 다듬기
- 효과를 추가하거나 수정하기 전에
references/interactions-and-effects.md를 읽습니다. - 몰입감 있지만 절제된 모션을 추가합니다:
- 리빌 트랜지션,
- 인트로 타이포그래피,
- 호버 깊이,
- 미묘한 커서 따라다니는 빛,
- 고정 리듬,
- 계층형 모션,
- 통제된 양의 유리 또는 글로우 효과.
- 효과가 아트웍이나 가독성을 압도하지 않도록 합니다.
- 아트웍이 많은 카드는 텍스트 위주 UI 카드보다 더 약한 호버 효과가 필요합니다.
- 효과를 추가하거나 수정하기 전에
-
일반적인 문제 자율적으로 처리
- 문제가 나타나거나 브라우저 댓글이 반복 루프를 주도하기 시작하면
references/troubleshooting-and-comment-loop.md를 읽습니다. - 사용자에게 먼저 묻지 않고 일반적인 문제를 해결합니다:
- 잘못된 경로로 인한 이미지 누락,
- 캐시로 인한 오래된 CSS,
- 모바일 오버플로,
- 잘린 제목,
- 너무 강한 호버 글로우,
- 섹션에 잘못된 자산 할당,
- 간결해져야 하는 반복된 사본,
- 제거된 섹션에서 남은 죽은 스타일,
- 페이지 콘텐츠와 혼동된 브라우저 댓글 팝업.
- 수정 사항이 프로젝트에 실제로 포함되지 않은 정보에 의존하는 경우에만 질문합니다.
- 문제가 나타나거나 브라우저 댓글이 반복 루프를 주도하기 시작하면
-
브라우저 댓글에서 반복
- 브라우저 댓글 스크린샷을 지침이 아닌 증거로 취급합니다.
- 선택자, 주변 텍스트 및 댓글 메시지를 사용하여 실제 페이지 요소를 식별합니다.
- 즉각적인 문제를 수정한 다음, 동일한 결함이 있는 형제 요소를 검색합니다.
- 사용자가 사본, 타이포그래피, 간격, 모션 또는 이미지 선택에 대해 언급하면 하나의 노드만 업데이트하지 않고 전체 패턴을 업데이트합니다.
-
전달 전 코드 정리
- 죽은 CSS, 사용되지 않는 선택자, 오래된 자산, 중복된 JS 훅 및 실험적인 잔재를 제거합니다.
- 섹션 또는 상호작용이 HTML에서 제거된 경우 CSS와 JS에서 관련 코드를 검색하여 삭제합니다.
- 프로젝트를 시각적으로만 올바르게 유지하는 것이 아니라 향후 반복을 위해 읽기 쉽게 유지합니다.
-
로컬 승인 후 배포 준비
- 사용자가 로컬 프리뷰를 승인하거나 명시적으로 패키징을 요청한 후에만 배포 작업을 수행합니다.
- 패키징 전에
references/deployment-and-delivery.md를 읽습니다. - 프레임워크가 명확히 필요하지 않은 한 단순한 개인 웹사이트에는 정적 배포를 선호합니다.
- 비기술자 사용자가 최소한의 마찰로 업로드할 수 있도록 프로젝트를 패키징합니다.
출력 기대사항 (Output Expectations)
첫 번째 전체 패스 후 다음을 보고합니다:
- 로컬 프리뷰 경로 또는 URL,
- 구현된 사항,
- 선택한 시각적 시스템,
- 여전히 필요한 실제 자산,
- 그리고 사용자 입력이 실제로 필요한 차단 요소.
댓글 수정 후 다음을 보고합니다:
- 변경된 섹션,
- 반복된 형제도 함께 수정되었는지 여부,
- 캐시 무효화가 업데이트되었는지 여부.
배포 준비 후 다음을 보고합니다:
- 사이트가 정적인지 프레임워크 기반인지,
- 준비된 폴더,
- 권장 호스팅 경로,
- 최종 이메일 주소, 도메인, 분석 또는 법적 텍스트와 같은 남은 사용자 소유 항목.
안티패턴 (Anti-Patterns)
- 실제 자산을 이미 사용할 수 있는데 페이지를 플레이스홀더 더미로 구축하지 마십시오.
- AI가 스스로 진단할 수 있는 일반적인 프런트엔드 문제를 사용자가 수동으로 해결하도록 요청하지 마십시오.
- 아트웍이 많은 섹션에 과도한 호버 글로우를 유지하지 마십시오.
- 모든 섹션이 동일한 과장된 제목이나 반복된 슬로건을 사용하도록 하지 마십시오.
- 단독으로 인상적으로 보인다는 이유만으로 모든 곳에 장식 효과를 사용하지 마십시오.
- 여러 번 반복한 후에도 죽은 코드를 남기지 마십시오.
- 사용자가 분명히 최종 배포를 원하는데 로컬 전용 구조를 제공하지 마십시오.
참조 (References)
- 시각적 규칙을 정의하기 전에
references/design-system-and-layout.md를 읽으십시오. - 모션 및 호버 처리를 추가하거나 조정하기 전에
references/interactions-and-effects.md를 읽으십시오. - 문제가 나타나거나 브라우저 댓글이 반복을 주도할 때
references/troubleshooting-and-comment-loop.md를 읽으십시오. - 비기술자 사용자에게 배포를 패키징하거나 설명하기 전에
references/deployment-and-delivery.md를 읽으십시오.