Communitygithub.com

Williampannn/build-your-website-with-claude-code

Claude Code 스킬로 처음부터 끝까지 나만의 웹사이트(포트폴리오, 랜딩 페이지, 블로그)를 구축하는 프로세스입니다. 템플릿이 아닌, 실제 작업 과정입니다.

build-your-website-with-claude-code란 무엇인가요?

이 AI 스킬은 사용자가 Claude Code를 활용하여 처음부터 완전한 웹사이트를 구축할 수 있도록 안내합니다. 단순한 템플릿 제공이 아닌, **'사람은 감독, 클로드는 제작진'**이라는 철학 아래 사용자의 취향과 비전을 실현하는 프로세스에 중점을 둡니다. Next.js, Astro, Vite, 순수 HTML 등 다양한 기술 스택과 Vercel, Netlify, Cloudflare Pages 같은 무료 호스팅 서비스를 지원하며, 초기 배포를 최우선으로 하고 지속적인 개선을 통해 사이트를 완성해 나가는 방법을 제시합니다. 이 스킬은 총 6단계로 구성되어 있으며, 각 단계마다 구체적인 목표, 실행 방법, Claude에게 전달할 프롬프트, 그리고 흔한 실수를 피하는 팁을 제공합니다. 특히, 사용자가 기술적 배경 지식이 없어도 Claude에게 '이해가 안 돼요, 하나씩 알려주세요'라고 말하는 것만으로 모든 설정을 진행할 수 있도록 설계되어 있어, 개발 비개발자 모두에게 매우 접근성이 높습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add Williampannn/build-your-website-with-claude-code

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Claude Code로 웹사이트 구축하기

이것은 템플릿이 아닌 프로세스입니다. 누군가가 자신이 자랑스러워할 웹사이트를 — 자신의 취향, 자신의 콘텐츠, 자신에게 맞는 스택으로 — Claude Code를 빌더로 사용하여 구축하는 방법을 가르칩니다. 당신은 프레임워크와 동작을 제공하고, 그들은 비전을 제공합니다.

모든 것은 하나의 전환에 달려 있습니다: 사람은 감독이고, Claude는 제작진입니다. 그들은 사이트가 어떻게 느껴져야 하고 무엇이 충분히 좋은지 결정합니다. Claude는 뼈대를 만들고, 글을 쓰고, 스타일을 입히고, 검증하고, 배포합니다. 이 스킬을 실행할 때 당신의 임무는 그들로부터 취향을 끌어내고, Claude가 실행할 수 있는 지침으로 바꾸고, 빠르게 라이브로 만든 다음, 반복하는 것입니다.

모든 것을 지배하는 하나의 규칙: 진짜지만, 못생긴 라이브 사이트를 먼저 만들고, 그런 다음 볼 수 있는 작은 단계로 개선하세요. 1일차에 라이브가 되어 50번 반복된 사이트는 결코 출시되지 않는 걸작을 이깁니다.


마인드셋 (초반에 큰 소리로 말하세요)

  • 당신이 감독하고, Claude가 만듭니다. 그 사람은 코드를 한 줄도 쓸 필요가 없습니다 — 또는 단어조차 알 필요가 없습니다. 그들은 느낌("더 따뜻하게", "이건 좀 좁아", "너무 기업 스타일이야")을 설명하고 가리키면, Claude가 픽셀로 번역합니다.
  • 먼저 라이브, 나중에 예쁘게. 스타일링 전에 빈 껍데기를 배포하세요. 그래야 고장낼 것이 없을 때 파이프라인을 한 번에 디버깅할 수 있습니다.
  • 취향을 파일로 코드화하세요. 그들이 마음에 드는 디자인을 찾으면, 그들과 그리고 Claude가 모든 세션에서 읽을 디자인 시스템으로 기록하세요. 그래야 사이트가 표류하는 것을 막을 수 있습니다.
  • 작고, 눈에 보이는 단계. 한 번에 하나의 일관된 변경; 보고, 커밋하세요. 크고 보이지 않는 변경은 사이트가 망하는 지름길입니다.
  • 루프를 닫으세요. 일찍 배포하고, 실제 사람들 앞에 내놓고, 그들의 말을 다음 할 일 목록으로 바로 Claude에게 전달하세요.
  • 막히면 Claude에게 물어보세요. 아래의 모든 단계 — 계정 생성, 빨간 터미널 오류 수정, 헷갈리는 호스트 화면 — 는 혼자 해결하는 것이 아니라 다시 Claude에게 넘길 일입니다. "해본 적이 없어요, 저를 처음부터 안내해 주세요"와 "제가 보는 화면의 스크린샷입니다"는 그 사람이 말할 수 있는 가장 유용한 두 가지 문장입니다.

이 스킬 사용 방법

대략적인 순서대로 단계를 진행하되, 엄격한 폭포수 방식은 아닙니다 — 4단계(반복 루프)는 다른 단계 아래에서 계속 실행되는 엔진입니다:

0단계 → 1단계 프레이밍하고 라이브로 만들기 · 2단계 → 3단계 당신의 것으로 만들고 채우기 · 5단계 → 6단계 기억에 남게 만들고 듣기 · 4단계는 항상 실행됩니다.

각 단계는 목표, 실행 방법, 그 사람이 Claude에게 건네줄 복사-붙여넣기 프롬프트, 그리고 가장 자주 망치는 하나의 함정을 제공합니다. 더 깊은 내용은 참조 파일에 있습니다 — 단계가 실제로 진행될 때 가져와서 사용하세요.

중단 허가. 차분한 한 페이지 사이트 — 이름, 자신에 대한 한 줄, 링크 하나 — 는 진짜 완성된 웹사이트입니다. 4단계 후에 끝났다면 끝난 것입니다. 5-6단계는 더 원할 때를 위한 것이지, 반드시 넘어야 하는 기준이 아닙니다.


시작하기 전에 (Claude가 이 모든 것을 도울 수 있습니다)

그 사람은 1단계 전에 네 가지 무료 항목을 준비해야 합니다. 이 모든 것은 Claude에게 처음부터 안내해 달라고 요청하여 설정할 수 있습니다 — 그들이 이미 해두었다고 가정하지 마세요:

  • Claude Code, 프로젝트 폴더에 설치되어 열려 있어야 합니다.
  • Node.js + npm (대부분의 최신 스택용) — Claude는 node -v로 확인하고 설치할 수 있습니다.
  • GitHub 계정 (무료) — 코드가 저장되고 호스트가 감시하는 곳입니다.
  • 호스팅 계정 — Vercel, Netlify 또는 Cloudflare Pages (무료 티어는 관대합니다. 일부는 무료임에도 카드를 요구하지만 — 일반 개인 사이트에는 요금이 청구되지 않습니다).

이 중 어떤 것이 낯설다면, 가장 첫 번째 프롬프트는 다음과 같아야 합니다:

저는 코딩 프로젝트를 설정해 본 적이 없습니다. 제 컴퓨터에 Node, npm, git이 설치되어 있는지 확인하고, 설치되지 않은 모든 것을 설치하고 무료 GitHub 및 [Vercel/Netlify] 계정을 만드는 과정을 한 단계씩 안내해 주세요. 무엇을 클릭해야 하는지 정확히 알려주고, 각 단계에서 저를 기다려 주세요.

빠른 시작 (오후에 라이브 사이트 만들기)

그 사람이 지금 모멘텀을 원한다면:

  1. 취향 브리핑을 이끌어 내세요. 0단계의 다섯 가지 질문을 하고, 답변을 짧은 BRIEF.md에 기록하세요. (~15분)
  2. 빈 껍데기를 뼈대 만들고 배포하세요. 스택 + 푸시-투-디플로이 호스트를 선택하고(확실하지 않으면 Next.js + Vercel이라고 말하고 넘어가세요), 공식 CLI로 스타터를 생성하고, GitHub에 푸시하고, 호스트를 연결하고, 빈 사이트가 실제 URL에서 라이브인지 확인하세요. (~30분, 처음에는 더 걸림 — 계정 가입 및 GitHub 호스트 연결에 ~20-30분 추가)
  3. 가드레일 파일을 추가하세요. AGENTS.md를 만들어 Claude가 코드를 작성하기 전에 설치된 프레임워크 문서를 읽도록 지시하세요(1단계). (~2분)
  4. 히어로 섹션만 만드세요. 한 화면: 이름, 자신에 대한 한 줄, 행동 촉구 하나, 브리핑의 색상. 브라우저에서 확인하세요. (~20분)
  5. 조정하고 커밋하세요. "제목을 더 크게", "배경을 더 따뜻하게", 커밋, 푸시 — 라이브가 됩니다. (~15분)

이제 그들은 실제 URL에 실제 웹사이트를 갖게 되었습니다. 이후의 모든 것은 개선일 뿐입니다 — 쉬운 부분입니다. (위 계정이 이미 있다고 가정한 시간입니다. 첫 설정은 시간이 더 걸리며, 그것은 정상이지 실패가 아닙니다.)


0단계 — 프레이밍: 취향과 범위

목표: 단일 컴포넌트가 구축되기 전에, 사이트가 어떻게 느껴져야 하고 어떤 페이지가 필요한지 평범한 말 그리고 그림으로 설명할 수 있어야 합니다.

실행 방법

  • 그 사람을 인터뷰하세요. 아직 디자인하지 마세요; 추출하세요. 다음 다섯 가지를 물어보세요:
    1. 누구를 위한 사이트이며, 그들에게 무엇을 느끼게 하거나 하게 하고 싶나요? (당신을 고용하게, 이것을 사게, 당신의 글을 읽게, "나를 진지하게 봐", "내가 재미있다는 걸 알게")
    2. 분위기를 2-3단어로 말해보세요. ("따뜻하고 에디토리얼한", "깔끔하고 기술적인", "시끄럽고 장난기 있는", "조용하고 고급스러운", "어둡고 브루탈리스트"). 기능보다는 느낌을 강조하세요.
    3. 당신이 좋아하는 것을 보여주세요. 2-3개 사이트의 URL, 그리고 그 느낌을 포착한 스크린샷, 무드보드, 또는 모든 이미지 — 대부분 사람의 취향은 시각적이지 언어적이지 않으므로, 그림을 붙여넣게 하세요. 그리고 싫어하는 사이트 하나. 구조와 분위기는 훔치고, 콘텐츠는 절대 훔치지 마세요.
    4. 이 사이트가 반드시 완벽하게 해야 할 한 가지는 무엇인가요? (글쓰기, 비주얼, 작업 샘플, 빠른 속도)
    5. 실제로 필요한 페이지/섹션은 무엇인가요? 범위 확장을 거부하세요 — 대부분의 개인 사이트는 홈 + 하나 또는 두 개 더입니다.
  • 답변을 리포지토리 루트의 BRIEF.md에 기록하세요 — 당신과 Claude가 확인하는 북극성입니다. 이미지를 제공했다면 각각에서 무엇을 가져올지 기록하세요.

Claude에게 건넬 프롬프트

무엇이든 만들기 전에, 제가 원하는 웹사이트에 대해 인터뷰해 주세요. 한 번에 하나씩 물어보세요: 누구를 위한 사이트이며 방문자들이 무엇을 느끼거나 하길 바라는지; 분위기를 2-3단어로; 제가 좋아하는 사이트들 (링크와 스크린샷/무드보드 이미지를 붙여넣을게요 — 이미지에도 반응해 주세요)과 싫어하는 사이트 하나; 이 사이트가 반드시 완벽하게 해야 할 한 가지; 그리고 실제로 필요한 페이지. 그런 다음 제 답변을 BRIEF.md에 북극성으로 기록하세요. 아직 사이트 코드는 작성하지 마세요.

함정: 누군가 느낌을 설명할 수 있기 전에 구축을 시작하는 것입니다. 분위기를 말하거나 그림을 보여줄 수 없다면, Claude는 기본값인 일반-SaaS-템플릿으로 돌아가고 모든 이후의 수정은 그 중력과 싸워야 합니다. 먼저 느낌을 — 말이나 이미지로 — 얻으세요.


1단계 — 기초: 빈 사이트를 라이브로 만들고 가드레일 추가하기

목표: 빈지만 실제 사이트, 이미 실제 URL에 배포되고 자동 배포가 연결되어 있어 모든 이후 변경이 무료로 배포되며, Claude를 실제 정보에 고정시키는 가드레일이 있는 상태.

이것을 어떻게 해야 하는지 알 필요가 없습니다. Claude는 정확한 클릭과 명령을 알려주고 당신이 할 때까지 기다립니다. 화면이 혼란스러우면 스크린샷을 찍어 다시 붙여넣으세요 — 그것이 전체 워크플로우이지 실패가 아닙니다.

실행 방법

  • 스택과 호스트를 미리 선택하세요 (아래 표). 프레임워크와 같은 회사의 호스트를 선호하면 기본값이 잘 작동합니다. 어떤 길이든 괜찮습니다. 최악의 선택은 선택하는 데 하루를 보내는 것입니다.
  • 프레임워크의 공식 CLI로 뼈대를 만드세요. 직접 하지 마세요.
  • 빈 템플릿을 먼저 배포하세요. GitHub에 푸시하고, 호스트를 연결하고, 코드를 건드리기 전에 빈 사이트가 라이브인지 확인하세요. 그래야 다른 것이 고장날 수 없을 때 파이프라인을 디버깅할 수 있습니다.
  • 커스텀 도메인이 있다면 일찍 연결하세요 (그것이 실제 주소입니다. 무료 *.host.app URL은 임시입니다). DNS — 도메인 이름을 사이트로 연결하는 설정 — 적용되는 데 몇 시간이 걸릴 수 있으므로 일찍 시작하세요. 아직 도메인이 없나요? 호스트 URL로 시작해도 좋습니다. 나중에 구매하세요.
  • 실체 진실 가드레일을 추가하세요. 모든 AI 에이전트에게 설치된 프레임워크가 학습 데이터보다 최신일 수 있으므로, 코드를 작성하기 전에 node_modules/<framework>/dist/docs에서 실제 문서를 읽으라고 지시하는 AGENTS.md(그리고 단순히 @AGENTS.md라고만 적힌 한 줄짜리 CLAUDE.md)를 작성하세요. 이 하나의 파일로 환각된 API 버그의 전체 클래스를 방지할 수 있습니다.
  • 처음부터 비밀을 git에서 제외하세요. .gitignore는 env 파일과 빌드 출력물을 제외해야 합니다. API 키나 개인 주소를 절대 커밋하지 말고 호스트의 환경 설정에 보관하세요. Claude에게 리포지토리와 함께 이것을 설정하도록 요청하세요.
  • Claude가 추론할 수 없는 배포 사실을 기록하세요: 프로덕션 URL, 호스트, 자동 배포되는 브랜치, 정확한 리포 슬러그, 모든 주의사항. 노트/메모리 파일에 저장하세요 — 라이브 도메인은 일반적으로 코드에서 찾을 수 없습니다.
  • 로컬 미리보기 + 상태 확인 설정: 실행 구성(또는 문서화된 dev 명령어 + 포트)과 로컬 URL이 HTTP 200을 반환하는지 확인하는 한 줄짜리 검사를 통해 푸시하기 전에 확인할 수 있습니다.

결정 테이블 — 하나를 선택하고 진행하세요

사이트가…합리적인 기본 스택호스트
포트폴리오 / 개인 사이트 / 이력서Next.js 또는 AstroVercel / Netlify
주로 글쓰기 / 블로그Astro 또는 Next.jsVercel / Netlify
단일 랜딩 / 마케팅 페이지Astro 또는 Vite + ReactNetlify / Cloudflare Pages
직접 편집하려는 일반 파일일반 HTML + CSS (빌드 단계 없음)Netlify / CF / GitHub Pages
"모르겠어요, 그냥 작동하게 해주세요"Next.js + VercelVercel

(마지막 행이 Next.js + Vercel을 선택한 것은 Claude가 의지할 수 있는 가장 문서화된 경로이기 때문일 뿐입니다 — 위의 모든 행은 동등하게 합법적입니다.)

Claude에게 건넬 프롬프트

공식 도구로 새로운 [Next.js / Astro / 일반 HTML+CSS] 사이트의 뼈대를 만들고, 스타터는 그대로 둔 채로 저를 다음 과정을 안내해 주세요: git init + 첫 번째 커밋 (env/비밀을 제외하는 .gitignore 포함), GitHub 리포지토리 생성, 그리고 [Vercel / Netlify] 연결하여 main으로의 모든 푸시가 자동 배포되도록 합니다. 코드를 작성하기 전에 빈 사이트가 실제 URL에서 라이브인지 확인하세요. 그런 다음 어떤 AI 에이전트에게든 설치된 프레임워크가 학습 데이터보다 최신일 수 있으므로 코드를 작성하기 전에 node_modules/[framework]/dist/docs의 문서를 읽으라고 지시하는 AGENTS.md와 `@AGENTS.md`만 포함하는 CLAUDE.md를 만드세요. 마지막으로 제 프로덕션 URL, 호스트, 배포 브랜치, 리포지토리를 노트 파일에 저장하세요. 정확한 클릭을 알려주고 각 단계에서 저를 기다려 주세요.

함정: 한 번도 배포하지 않고 사이트 전체를 구축하는 것(그러면 코드 와 파이프라인을 동시에 디버깅하게 됩니다), 또는 빠르게 움직이는 프레임워크에 대한 모델의 기억을 신뢰하는 대신 설치된 문서에 고정시키지 않는 것입니다.

→ 미디어, 크기 제한, 인코딩 명령, 프로덕션 확인: references/PLAYBOOK.md.


2단계 — 디자인 언어 코드화

목표: 사람과 Claude가 모든 세션에서 읽는, 쓰여지고 기계가 읽을 수 있는 디자인 시스템 — 색상, 타입, 간격, 모션, 보이스 — 을 만들어 모든 새 페이지가 다섯 가지 약간 다른 모습으로 표류하지 않고 브랜드에 맞게 유지되도록 합니다.

실제로 마음에 드는 페이지가 하나 생긴 후에 이 작업을 수행하고, 그 전에는 하지 마세요. 좋은 것에서 시스템을 추출하는 것이지, 진공 상태에서 발명하는 것이 아닙니다.

실행 방법

  • 먼저 분위기를 말로 표현하고, 그런 다음 모든 규칙을 거기서 도출하세요. 두 개의 짧은 문구; 두 분위기가 긴장 관계에 있다면, 그 긴장이 규칙이 됩니다. (실제 빌드의 한 문구는 "따뜻한 에디토리얼한 평온 + 장난기 있는 픽셀 공예"였습니다 — 하지만 "조용하고 고급스러운" 또는 "시끄럽고 브루탈리스트" 사이트는 자신의 것을 명명하고 매우 다른 규칙을 도출할 것입니다.)
  • 색상을 의도적이고 일관되게 사용하세요. 절제된 팔레트 — 종종 단일 악센트 — 는 계층 구조를 읽기 쉽게 유지하며 안전한 기본값입니다. 하지만 취향이 맥시멀리스트, 레트로, 또는 브루탈리스트라면, 다중 색상 시스템도 합법적인 선택입니다. 규칙은 "정확히 하나의 악센트"가 아니라 모든 색상에 정의된 역할이 있고 모든 곳에서 동일하게 사용된다는 것입니다.
  • 색상을 역할 기반 토큰으로 표현하고, 마크업에 흩뿌려진 헥스 코드로 사용하지 마세요. 다섯 개의 거의 동일한 회색을 발명하는 대신, 부드러운 텍스트와 테두리를 하나의 잉크 색상을 불투명도를 낮춰 표현하세요.
  • 타입을 얼굴이 아닌 역할로 짝지으세요 (본문/UI, 제목/"보이스", 모노, 디스플레이). 역할을 참조하여 실제 글꼴이 나중에 다시 작성하지 않고 변경될 수 있도록 하세요.
  • 간격 리듬과 z-index 사다리를 고정하고, "새로운 값을 발명하지 마세요"라고 작성하세요.
  • 분위기에 맞는 모션 철학을 명시하세요: CSS의 저렴한 앰비언트 루프, JS 라이브러리의 인터랙티브 피드백; 필수적이지 않은 모션은 prefers-reduced-motion 뒤에 게이트하세요.
  • 접근 가능한 기준을 설정하세요 (이는 품질의 일부이지, 추가 기능이 아닙니다): 본문 텍스트 대비 ≥ 4.5:1, 실제 제목 순서, 보이는 포커스 상태, 의미론적 랜드마크, 의미 있는 이미지의 대체 텍스트. 굵고 어두운 팔레트는 대비가 조용히 실패하는 정확한 지점입니다.
  • 보이스와 톤을 디자인으로 기록하세요 — 카피는 디자인의 일부입니다(문장 첫 글자 대문자? 장난기 있는? 평범한 단어? 기업용 필러 없음?).
  • 두 개의 커밋된 파일로 코드화하세요: 산문 형식의 DESIGN_SYSTEM.md (원칙 + 컴포넌트 레시피 + 빌드 체크리스트) 및 tokens 파일 (원시 값). 앞으로만 적용됨으로 표시하세요 — 기존 페이지에서 추출되었으며, 마이그레이션 대상이 아님 — 그래서 Claude가 "도움이 되게" 작동하는 코드를 리팩터링하지 않도록 합니다.
  • 컨텍스트에 연결하세요: 사이트가 단순하다면 AGENTS.md에서 디자인 시스템 파일을 참조하고, 복잡하다면 CLAUDE.md 자체에 포함시키는 것을 고려하세요.

Claude에게 건넬 프롬프트

제가 방금 본 페이지 [여기에 그들이 좋아하는 페이지 설명]의 디자인 시스템을 추출해 주세요. 분위기를 2-3단어로 먼저 말로 표현하고, 그런 다음 역할 기반 색상 팔레트 (토큰 포함), 타입 스케일 (본문, 제목, 모노 — 역할로, 얼굴이 아님), 간격 리듬 (공통 단위 1개), z-index 사다리, 모션 철학, 접근 가능한 기준을 포함하는 DESIGN_SYSTEM.md을 작성해 주세요. 그리고 같은 값을 가진 tokens 파일도 작성하세요. 파일 상단에 '앞으로만 적용됨 — 기존 페이지에서 추출됨, 마이그레이션 대상이 아님'이라고 명시하세요. 그런 다음 AGENTS.md(또는 CLAUDE.md)에서 이 파일을 참조하여 Claude가 새 페이지를 디자인 시스템에 맞추도록 안내하세요.

함정: 시스템을 분위기와 취향에서 도출하는 대신 추상적으로 발명하는 것입니다. 사랑하는 것이 무엇인지 아직 보여주지 않았다면 빈 팔레트로 끝나거나, 시스템이 당신의 목소리가 아닌 다른 사람의 목소리로 말하게 됩니다.

→ 컬러 팔레트, 타이포그래피, 디자인 시스템 일반: references/DESIGN_SYSTEM.md.


3단계 — 첫 번째 실제 페이지

목표: 홈페이지(또는 가장 중요한 페이지)를 디자인 시스템에 맞게 채우고, 기능적이며 읽기 쉽고 빠르게 만듭니다. 텍스트 콘텐츠는 실제여야 하고, 이미지는 실제여야 하며(채우기/스톡 사용 금지), 레이아웃은 그들이 승인한 느낌을 포착해야 합니다.

실행 방법

  • 이미 가지고 있는 것(히어로 섹션, BRIEF.md, 디자인 시스템)부터 시작하세요. 시스템 파일을 읽도록 지시하여 Claude에게 컨텍스트를 제공하세요.
  • 페이지를 섹션으로 나누고, 한 번에 하나씩 구축하세요. 각 섹션에 대해 구체적으로 알려주세요 — "히어로: 이름, 태그라인, CTA, 부드러운 그라데이션 배경" — 그리고 "멋지게 보이게 해"가 아닙니다. 작동하는 것을 보고, 조정하고, 커밋하세요.
  • 미디어를 처리하는 방법을 알아야 합니다. 커스텀 이미지/아이콘/Vectors가 포함되면, GIF와 큰 비트맵을 로컬에 저장하지 않고 압축된 WebP/AVIF로 제공하는 방법을 알아야 합니다. 아이콘의 경우, 임베드된 SVG 또는 그린 아이콘 세트를 참조하고 <img> 태그된 PNG를 피하세요.
  • 실제 사용자 텍스트를 삽입하세요. Lorem ipsum은 빌드의 이 단계에서 죽습니다. BRIEF.md의 목소리와 톤 지침을 따르는 실제 카피로 교체하세요.
  • 흐름을 보호하고 속도가 느려지기 전에 처리하세요: 레이아웃 이동, 대규모 번들, 깜박임, 스크롤 성능. Lighthouse 또는 직접 확인을 사용하세요.
  • 검증 가능성과 랜딩을 설정하세요: OG 이미지/메타 태그, robots.txt, sitemap.xml (사이트 > 1페이지인 경우).

Claude에게 건넬 프롬프트

DESIGN_SYSTEM.md과 BRIEF.md를 읽고 홈페이지를 구축해 주세요. 페이지를 [히어로, 소개, 작업, 연락처] 섹션으로 나누고 한 번에 하나씩 구축하세요. 각 섹션에 대해: 목적을 설명하고, 무엇을 포함할지 말하고, 저에게 보여준 후 조정하게 해 주세요. 실제 텍스트 콘텐츠를 사용하세요 — Lorem ipsum은 금지입니다. 모든 것이 제 디자인 시스템에 맞고, OG 메타 태그가 설정되어 있으며 (로고가 있거나 사이트 이름), robots.txt가 검색 엔진이 인덱싱하도록 허용하는지 확인하세요. 로컬 미리보기에서 각 섹션을 확인하게 해 주세요.

함정: "완벽한" 홈페이지를 만드는 데 너무 오래 걸리거나 채우기 콘텐츠를 사용하는 것입니다. 빈 하위 페이지는 괜찮습니다. 실제 카피가 없는 라이브 홈페이지는 나쁩니다.

→ 레이아웃, 미디어, 텍스트 스타일, 성능 기준: references/PLAYBOOK.md.


4단계 — 보기 -> 변경 -> 커밋 -> 반복 루프

목표: 이 루프를 워크플로우의 심장으로 만듭니다. 단계가 지나가도 절대 멈추지 않습니다. 작고, 안전하며, 눈에 보이는 개선을 지속적으로 제공합니다.

루프를 폐쇄하는 방법

  1. 보기. 라이브 사이트를 보면서 질문하세요: "무엇을 바꾸고 싶나요?" 하나만 꼽으세요. 들은 모든 내용을 캡처하세요(아이디어 목록, 디자인 지시, 오류 메시지, 원시 피드백).
  2. 계획. 변경을 설명하는 작업 카드로 바꾸세요. 의도와 수용 기준을 명시하세요. 미니어처로 작업하세요 — 현실적인 변경 하나를 추정하고 실행하세요.
  3. 변경. Claude에게 로컬에서 변경하도록 안내하세요. 변경이 디자인 시스템에 부합하는지 확인하세요. 커밋하고 푸시하세요. 무언가 고장 나면: 전체 파괴를 롤백하고 긴급 수정하는 대신, 마지막 작동 상태로 되돌린 후 다시 시도하세요.
  4. 확인. 변경이 라이브인지 확인하세요(자동 배포가 처리합니다). 새 라이브 URL을 방문하세요. 첫 번째 보기와 의도를 비교하세요.
  5. (선택 사항) P99 속도 및 가용성 확인. 놀라움 후에만 — 사이트 라이브의 첫 주에 느리거나 다운된 것을 발견했다면, CDN 캐싱 및 오류 경계와 같은 생산성 준비 조치를 활성화/확인하세요.

루프 안내 원칙:

  • 작게 유지하세요. 50줄 미만의 변경. 한 번에 하나의 구성 요소, 섹션, 또는 조정.
  • 시각적으로 확인하세요. "변경이 작동하는지 확실하지 않다면" — 브라우저에서 확인하세요.
  • 자주 커밋하세요. 2-3번의 변경마다 커밋, 3-4번의 변경마다 푸시. 루프가 사이트의 작업 사본을 되감기 가능하게 유지합니다.
  • 변경이 잘못되면: 마지막 안정적인 변경으로 git revert 또는 git checkout하여 되돌리세요. 이전 디자인 시스템 파일이 있다면 복원하세요. 그런 다음 다시 시도하세요.
  • 범위를 관리하세요. 갑자기 "사실 5개의 새 페이지가 필요해요"라는 경우 — 거절하거나, 별도의 짧은 세션에서 하나씩 수행하세요. 루프는 지속적인 개선을 위한 것이지, 일괄 마이그레이션을 위한 것이 아닙니다.

Claude에게 건넬 프롬프트

저는 지금 라이브 사이트에서 [구체적인 변경 하나]를 보고 싶습니다. 제 브리핑과 디자인 시스템을 확인하세요. 변경 사항을 설명하고, 로컬에서 적용해 주세요(50줄 미만). 적용 후 로컬 미리보기를 보여주세요. 제가 확인하면 커밋하고 푸시하세요. 라이브인지 확인하세요. 시작합니다.

함정: 한 번에 너무 많이 바꾸거나, 너무 큰 변경으로 루프를 건너뛰는 것입니다. 한 번에 하나씩 확인하세요.

→ 디버깅, 롤백, 협업 워크플로우: references/PLAYBOOK.md.


5단계 — 장인 정신: 디테일 채우기

목표: 첫 번째 관심 이후에 사이트를 기억에 남게 만듭니다. 속도와 액세스 가능성, 마이크로인터랙션, 폼과 흐름. 이것들은 다음 수준의 디테일입니다.

실행 방법

  • 속도와 액세스 가능성 감사를 실행하세요: Lighthouse, axe DevTools, 그리고 수동 키보드 내비게이션 테스트. 외부 CSS/JS로 인한 레이아웃 이동, 느린 WebFont 로드, 깜박임을 확인하세요. 좋은 점수를 받을 때까지 고치세요.
  • 마이크로인터랙션을 추가하세요: 호버 상태, 부드러운 전환, 로딩 상태, 스크롤 기반 애니메이션 — 분위기에 맞는 경우. 디자인 시스템의 모션 철학을 따르세요. 게이트를 잊지 마세요: prefers-reduced-motion
  • 폼과 액션을 구현하세요: 연락처 폼, 뉴스레터 가입, 버튼 — 서버리스 함수 또는 타사 서비스를 통해. 실제로 작동하고, 피드백을 제공하며, 오류를 우아하게 처리하는지 확인하세요.
  • 선택적 개선 사항: 검색, 태그/카테고리, 다크 모드 (설계된 경우), PDF 생성기에 연결된 인쇄 스타일시트, 번역/i18n (필요한 경우).

Claude에게 건넬 프롬프트

내 라이브 사이트 [URL]에서 보기/변경 루프를 실행해 주세요. 먼저 [속도 또는 액세스 가능성] 감사를 실행하고 가장 큰 문제를 하나 고치세요. 그런 다음 [마이크로인터랙션, 예: 호버 상태 + 부드러운 전환]을 제 디자인 시스템의 모션 철학에 맞게 추가하세요. 각 변경 후: 보여주고, 확인하게 해 주세요. 게이트 behind `prefers-reduced-motion`을 잊지 마세요.

함정: 먼저 사이트가 살아 있고 기본이 탄탄하다는 것을 확보하기 전에 멋진 것을 추가하는 것입니다. 기본이 없으면 장인 정신은 무너집니다.

→ 속도, 액세스 가능성, 폼, 고급 CSS: references/PLAYBOOK.md.


6단계 — (선택 사항) 청중 앞에 두고 듣기

목표: 사이트 앞에 실제 사람들을 두고, 배우고, 개선하세요. 당신이 그것을 좋아하는 것은 중요하지 않습니다 — 그들이 중요합니다.

실행 방법

  • 라이브 배포를 공유하세요. 사이트 링크를 친구, 동료, 동문, Twitter/Bluesky/Mastodon에게 전송하세요. "한 번 봐주시겠어요?"라고 말하고 무엇이 빠졌는지, 무엇이 잘못되었는지, 무엇이 모호한지, 무엇이 멋진지 물어보세요.
  • 원시 피드백을 수집하세요. 모든 피드백을 반박하거나 설명하지 말고 캡처하세요. 모든 의견을 가져가세요.
  • 분류하고 우선순위를 정하세요: 즉시 조치(버그), 다음 반응(더 많은 변경), 보류(장기 개선).
  • 피드백을 루프에 넣으세요. 상위 작업 3개를 선택하고 보기/변경/커밋을 반복하세요. 피드백을 다음 할 일로 다시 Claude에게 전달하세요.
  • 분석 설정 (선택 사항). 간단한 것으로: Cloudflare Web Analytics (무료, 쿠키 없음) 또는 Umami. 구글 애널리틱스를 피하세요. 방문자가 사이트와 어떻게 상호 작용하는지 이해하세요.
  • 사이트가 발견되도록 하세요 (선택 사항). 기본 SEO를 유지하세요: 페이지 제목, 메타 설명, 헤딩 구조, 내부 링크. 빠른: Sitemap 제출, robots.txt 허용. 링크 구축: 디렉토리, 게스트 게시물, 소셜을 통해.

Claude에게 건넬 프롬프트

내 사이트 [URL]에서 피드백 수집 라운드를 도와주세요. 피드백을 캡처하고 분류할 수 있도록 도와주세요(버그, 개선, 아이디어). 상위 3개를 선택하고 가장 중요한 것부터 보기/변경/커밋 루프를 실행하세요. 또한 사이트를 발견 가능하게 만들기 위한 기본 SEO가 있는지 확인하세요.

함정: 피드백을 개인적으로 받아들이거나 모든 것을 한 번에 고치려고 하는 것입니다. 천천히, 우선순위를 정하고, 반복하세요.


참조 파일

더 깊은 내용을 위해 이 스킬과 함께 제공되는 파일:

파일목적
references/PLAYBOOK.md실행 가능한 체크리스트: 배포, 미디어 처리, 성능 기준, 폼, 생산성 준비. 당신이 "어떻게..."라고 말할 때 보세요.
references/DESIGN_SYSTEM.md디자인 시스템 구축 및 유지 관리에 관한 심층 가이드: 팔레트, 타입, 간격, 모션, 브랜드 보이스.
references/TOOLS.md권장 도구: 이미지, 아이콘, 폰트, 애니메이션 라이브러리. 각각에 대한 빠른 의견과 더 나은 선택이 있는 경우.
references/CHECKLIST.md출시 전 체크리스트. 라이브로 가기 전에 무엇을 확인해야 하는지에 대한 참조
references/TROUBLESHOOTING.md일반적인 함정과 해결책: 빌드 오류, 호스트 설정 문제, 디자인 일관성 문제.

이 스킬을 처음부터 마지막까지 실행하느라 수고하셨습니다. 가장 중요한 것은: 사이트를 라이브로 만드는 것을 즐기고, 배우고, 창작하는 것을 잊지 마세요. 당신이 만든 것입니다. 자랑스러워하세요.

— Williampannn

관련 스킬