Communitygithub.com

사이트 구축

클라이언트 웹사이트의 전체 파이프라인을 실행합니다: 브리핑 및 디자인 수집, 사이트맵 및 카피 작성, 빌드, 검증, 리뷰, SEO, 출시 준비를 포함하며 두 개의 승인 게이트와 제한된 수정 루프가 있습니다. 새 사이트를 시작하거나 재구축할 때, 또는 사용자가 "사이트를 구축해"라고 말하거나 /build-site를 실행할 때 사용하세요.

사이트 구축란 무엇인가요?

이 스킬은 Claude Code와 같은 AI 에이전트가 클라이언트 웹사이트를 처음부터 끝까지 구축하는 완전한 파이프라인을 제공합니다. Intake Gate(단계 0)에서 브리핑과 디자인 참조를 확인하고, Plan(단계 1)에서 사이트맵과 카피를 작성하며, Build(단계 2)에서 디자인-취향-프론트엔드 스킬을 사용하여 Astro 프로젝트 내에서 페이지를 구축합니다. 각 단계는 명확한 마일스톤과 산출물을 가지며, 두 개의 사용자 승인 게이트(Plan 승인 및 최종 사이트 승인)를 포함하여 잘못된 방향으로 가는 것을 방지합니다. SEO 최적화(단계 3)는 리뷰 전에 실행되며, Fix Loop(단계 6)는 최대 2라운드의 P0/P1 문제 수정으로 제한됩니다. 이 파이프라인은 `.claude/pipeline/` 디렉토리에 상태를 저장하여 여러 세션에 걸쳐 작업을 지속할 수 있게 해줍니다. Cursor, Codex, Windsurf 등 유사한 에이전틱 워크플로우를 지원하는 AI 코딩 도구와 호환됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cgfeletar/website-builder/tree/HEAD/core/.claude/skills/build-site

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

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

문서

클라이언트 사이트 구축

메인 세션은 이 파이프라인을 실행하고 하위 에이전트에 위임합니다. (하위 에이전트는 다른 하위 에이전트를 시작할 수 없으므로, 이것이 오케스트레이터 에이전트가 아닌 스킬인 이유입니다.)

[0 Intake 게이트]  브리핑 + DESIGN.md + 참조
      ↓
[1 계획]  사이트맵, 페이지 섹션, 카피  →  plan.md, src/data/*
      ↓
[사용자 게이트 1]  계획 및 카피 승인
      ↓
[2 빌드]  페이지 및 비주얼 시스템
      ↓
[3 SEO]     SEO 에이전트            →  seo-report.md
      ↓
[4 검증]  npm run verify (하드 게이트)
      ↓
[5 리뷰]  사이트-리뷰어 에이전트  →  review-report.md
      ↓
[6 수정 루프]  P0/P1 → 수정 → 검증 → 재리뷰 (최대 2라운드)
      ↓
[사용자 게이트 2]  사이트 승인
      ↓
[7 출시 준비]  출시 체크리스트 + 인계 문서
      ↓
[8 교훈]  docs/lessons.md에 추가

산출물

모든 것은 .claude/pipeline/에 저장됩니다:

pipeline-state.md   단계, 수정 라운드, 마지막 업데이트 시간
plan.md             사이트맵, 페이지별 섹션, 페이지별 주요 액션
review-report.md    사이트-리뷰어의 보고서
seo-report.md       SEO 보고서
screenshots/        npm run verify 결과

모든 단계 시작 시 pipeline-state.md를 읽고 그 상태에서 재개합니다. 각 단계 종료 시 업데이트합니다. 이렇게 하면 여러 세션에 걸쳐 빌드를 지속할 수 있습니다.

단계 0: Intake 게이트

각 항목을 확인합니다. 누락된 항목이 있으면 중단하고 사용자가 채우도록 도운 후 다른 작업을 진행합니다.

항목준비 완료 조건
.agents/product-marketing.md비즈니스 사실 섹션 완료, 주요 액션 명명, 대상 및 톤 채움. 사용자가 제공한 정보로 초안을 작성하려면 product-marketing 스킬을 사용하세요.
src/data/business.json이름, 전화번호, 주소, 영업시간, 지도 링크가 브리핑과 일치. 브리핑에서 복사하세요.
DESIGN.md모든 섹션이 채워짐. 사용자가 참조만 가지고 있는 경우, references/에서 초안을 작성하고 확인을 요청하세요.
references/각각에서 무엇을 참고할지에 대한 설명과 함께 최소 두 개의 스크린샷 또는 URL.
클라이언트 자산로고 및 사진, 또는 대체품이 지금은 괜찮다는 명시적인 메모.
편집클라이언트가 직접 사이트를 편집할 것인가? (단계 7에 영향을 미침)

그런 다음 DESIGN.md에서 src/styles/tokens.css를 채웁니다.

단계 1: 계획

  1. plan.md 작성: 페이지 (대부분의 클라이언트는 홈, 주요 오퍼별 페이지 또는 메뉴/서비스 페이지, 소개, 연락처 필요), 페이지당 하나의 주요 액션, 각 페이지의 섹션 순서. 브리핑과 site-essentials를 사용하세요.
  2. copywriting 스킬로 카피를 작성한 후, copy-editing을 실행하세요. 브리핑의 고객 언어와 클라이언트의 자체 단어로 시작하고, 그 구문 중 일부를 거의 그대로 사용하세요. CLAUDE.md의 하우스 규칙 9(일반적인 AI 표현 금지)를 따르세요. src/data/ (home.json, services, FAQs)에 넣고, 컴포넌트에는 넣지 마세요.
  3. 모르는 것은 [NEED: ...]로 표시하세요. 절대 빈칸을 지어낸 사실로 채우지 마세요.

사용자 게이트 1

중단하세요. 사용자에게 사이트맵, 각 페이지의 섹션과 주요 액션, 전체 카피, 그리고 모든 [NEED: ...] 항목을 보여주세요. 승인 또는 변경을 기다리세요. 빌드 후보다 지금 카피를 변경하는 것이 더 저렴합니다.

단계 2: 빌드

이 Astro 프로젝트 내에서 design-taste-frontend 스킬(Taste Skill)로 빌드하세요. 시작하기 전에 다음을 알려주세요:

  • 종류는 place (사람이 방문하는 곳) 또는 service (사람이 고용되는 곳)이며, 기술 종류는 절대 안 됩니다.
  • DESIGN.md와 references/가 팔레트, 타이포그래피, 느낌을 설정합니다. 자체적으로 정한 팔레트와 폰트는 무시됩니다.
  • 비즈니스 사실은 src/data/business.json에서 가져옵니다. 자체적인 대체 연락처 규칙은 적용되지 않습니다.
  • 모션은 CLAUDE.md의 하우스 규칙을 따릅니다.

페이지별로 빌드하고, 홈을 먼저 빌드하세요. 홈 후에 npm run verify를 실행하고, 세 개의 스크린샷을 보고 다음 페이지를 빌드하기 전에 보이는 문제를 수정하세요. Taste Skill의 완료 게이트는 중단될 때 자체적으로 실행됩니다; 그 결과물을 입력으로 간주하되, 충돌 시 CLAUDE.md가 우선합니다.

단계 3: SEO

SEO 에이전트는 head 태그, JSON-LD 및 robots를 편집하므로 검증 및 리뷰 전에 실행됩니다. 이렇게 하면 리뷰가 완성된 사이트를 평가할 수 있습니다.

seo: "이 사이트의 SEO를 감사하고 구현하세요. 로컬 비즈니스 단계를 포함합니다. 브리핑: .agents/product-marketing.md. 보고서를 .claude/pipeline/seo-report.md에 작성하세요."

단계 4: 검증 (하드 게이트)

npm run verify

모든 check-site FAIL 및 스크린샷 문제(가로 스크롤, 콘솔 에러)는 리뷰 전에 수정되어야 합니다. [NEED: ...] 실패는 사용자에게 이미 요청한 사실에 대해서만 허용되며, 목록을 작성하세요. check-site가 일반적인 것으로 플래그한 카피는 클라이언트가 실제로 그 단어를 사용하지 않는 한 다시 작성하세요.

단계 5: 리뷰

리뷰어는 읽기 전용이며 최종 메시지로 보고서를 반환합니다. 그 메시지를 그대로 .claude/pipeline/review-report.md에 저장하세요.

site-reviewer: "빌드된 사이트를 리뷰하세요. 계획: .claude/pipeline/plan.md. 브리핑: .agents/product-marketing.md. 디자인: DESIGN.md. 스크린샷: .claude/pipeline/screenshots/. SEO 변경 완료: .claude/pipeline/seo-report.md. 전체 보고서를 최종 메시지로 반환하세요."

단계 6: 수정 루프

site-reviewer 판정조치
준비 완료게이트 2로 이동
후속 조치 필요, P2만게이트 2로 이동, P2 목록 작성
후속 조치 필요 (P1) 또는 차단됨 (P0)라운드 < 2: 수정, 단계 4(검증) 재실행, 변경된 페이지에 대해 site-reviewer 재실행 후 보고서 저장. 라운드 = 2: 중단하고 사용자에게 보여줌.

단순히 브리핑에 맞지 않는 것이 아니라 실제로 고장난 것은 bug-fixer 에이전트를 사용하세요. pipeline-state.md에서 라운드를 매번 증가시키세요.

사용자 게이트 2

중단하세요. 사용자에게 390 및 1440에서의 홈 스크린샷, 판정, 남은 P2, 필요한 SEO 결정, 남은 [NEED: ...] 항목, 교체해야 할 대체 사진을 보여주세요. 승인을 기다리세요.

단계 7: 출시 준비

  1. npm run check:launch를 실행하고 모든 FAIL을 수정하세요. 그런 다음 docs/launch-checklist.md를 채우고 각 항목을 완료, 해당 없음, 또는 누군가를 기다리는 중(누군지 명시)으로 표시하세요.
  2. 클라이언트를 위해 docs/handoff.md를 채우세요.
  3. 클라이언트가 사이트를 직접 편집할 경우, docs/client-editing.md를 따르세요.
  4. 사이트가 실제 도메인에서 라이브가 된 후, 사용자에게 claude-seo를 실행하도록 상기시키세요: /seo local <url> 및 /seo audit <url>.

단계 8: 교훈

보고서와 수정 라운드에서 두 번 잘못되었거나 실제 시간이 많이 소요된 것을 스캔하세요. 각 교훈에 날짜가 있는 줄을 docs/lessons.md에 추가하세요. 어떤 교훈을 site-starter에 다시 복사하여 모든 미래 사이트에 적용할 가치가 있는지 사용자에게 알려주세요.

관련 스킬