Communitygithub.com

promptory-web-builder

에이전트가 'promptory 웹 빌더'를 아트 디렉션하고 구축하여 완성된 비디오 컷을 출력하는 방법을 보여줍니다.

promptory-web-builder란 무엇인가요?

이 스킬은 에이전트가 GSAP, Lenis, React Bits라는 세 가지 도구를 엄격한 의사 결정 흐름에 따라 사용하여 완성된 형태의 웹사이트를 구축하도록 안내합니다. 각 도구는 명확한 역할을 가지고 있으며, GSAP의 티커가 Lenis를 구동하고 ScrollTrigger가 Lenis의 스크롤을 읽는 단일 애니메이션 루프로 통합됩니다. 이 스킬은 디자인을 임의로 변경하는 것을 금지하는 황금률, 새로운 모든 요청에서 실행해야 하는 인테이크 설문지, 품질 점검 목록, 디자인 방향 선택 가이드 등 포괄적인 워크플로우를 제공합니다. 주로 React/Next.js 프로젝트를 대상으로 하지만, 바닐라 HTML/JS 설정도 지원하며, Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용하도록 설계되었습니다. 이 스킬은 참조 파일들을 활용하여 보다 정확한 구현을 돕고, 접근성(WCAG 2.2 AA)과 RTL/아랍어 지원을 중요하게 다룹니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/moramadan91/promptory-web-builder/tree/HEAD

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

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

문서

Promptory 웹 빌드

세 가지 도구, 하나의 스택, 각각 하나의 임무:

도구역할경험칙
Lenis스크롤 엔진 — 네이티브 스크롤 위에 부드럽고 관성 있는 스크롤 제공전역에 한 번 설치. 섹션별로 설치하지 않음.
GSAP (+ ScrollTrigger)애니메이션 엔진 — 사용자 정의 타임라인, 스크롤 기반 애니메이션, 고정이 사이트 디자인에 특화된 모든 것.
React Bits미리 만들어진 애니메이션 컴포넌트 (텍스트, 배경, 커서, 카드, 버튼)카탈로그 컴포넌트가 이미 효과를 제공한다면 먼저 시도.

이들은 하나의 애니메이션 루프를 공유합니다: GSAP의 티커가 Lenis를 구동하고, ScrollTrigger가 Lenis의 스크롤을 읽습니다. 이 연결을 올바르게 설정하는 것이 이 스킬에서 가장 중요한 부분입니다(§3).

범위: 실시간 웹/DOM 전용. 비디오 렌더링(Remotion, reels)에는 이 스킬이 적용되지 않습니다.

0. 황금률 — 디자인을 변경하지 마세요

사용자가 요청한 디자인과 효과를 구현하십시오. 레이아웃, 색상, 글꼴, 간격 또는 카피를 임의로 변경하지 말고, 아무도 요청하지 않은 추가 섹션이나 "보너스" 효과를 추가하지 마십시오. 효과나 수정이 확실히 개선되는 부분이 있다면, 한 줄로 제안하고 승인을 기다리십시오. 모션 및 품질 검사는 기존 디자인을 개선하는 데 사용되어야 하며, 대체해서는 안 됩니다.

0.5 인테이크 설문지 — 모든 새 웹사이트 요청의 첫 번째 단계

새 사이트에 대한 코드를 작성하기 전에 references/intake-questionnaire.md의 인테이크 설문지를 실행하십시오:

  1. 요청을 읽고 이미 답변된 부분은 건너뜁니다.
  2. 최대 3개의 짧은 라운드(프로젝트 → 모션 → 전달)로 나머지 질문을 합니다. 가능하면 Claude Code의 AskUserQuestion 도구를 사용하고(클릭 가능한 옵션 + 자동 "기타" 자유 텍스트 상자), 그렇지 않으면 각 라운드를 문자 옵션과 모든 질문에 빈 "✎ أخرى" 줄이 있는 하나의 코드 블록으로 출력합니다.
  3. 프로젝트 브리핑을 하나의 코드 블록으로 보여주고 진행 승인을 기다립니다.
  4. 그런 다음 답변을 정확히 따라 구축합니다.

사용자가 "ابدأ على طول" / "skip"이라고 말하면 ⭐ 기본값을 사용하고 브리핑에 명시하십시오. 기존 사이트의 작은 수정의 경우, 요청이 모호하지 않으면 설문지를 건너뜁니다.

브리핑에는 다음이 기록되어야 합니다: 언어 및 방향(아랍어/RTL, 영어/LTR 또는 둘 다), 접근성 목표(기본 WCAG 2.2 AA), 양식 및 해당 백엔드, 분석 도구(있는 경우).

0.6 시각적 참조 — Prompt Motion

https://prompt-motion.com/ 은 모션 디렉션을 위한 시각적 라이브러리입니다(운동 타이포그래피, 제품 UI, 파티클, 셰이프, 차트… 각각에 대한 프롬프트 포함). 사용자가 영감을 요청하거나, 설문지에서 "제안 필요" / "대담한 모션"을 선택하거나, 해당 사이트의 링크를 공유할 때만 사용하십시오. 모션 아이디어를 차용하고 GSAP / Lenis / React Bits로 재구축하며, 클라이언트의 디자인은 유지하십시오. 워크플로우, 카테고리→컴포넌트 맵 및 모션 사양 템플릿: references/visual-references.md.

0.7 품질 기준 — 무엇이든 보여주기 전에 확인하십시오

빌드에서 일반적인 출력의 징후(기본 인디고 악센트, 이모지 아이콘, 발명된 지표, 로렘 입숨, 템플릿 섹션)를 검사하십시오. 자신의 코드에 있는 것은 수정하고, 클라이언트 디자인의 것은 한 줄 수정을 제안하십시오. 전체 목록: references/quality-bar.md.

0.8 디자인 방향 — 모든 사이트는 다르게 보입니다

클라이언트가 자체 디자인이 없을 때는 코드를 작성하기 전에 방향을 선택하십시오. references/design-styles.md를 읽고:

  1. 브리핑의 산업 및 청중에 맞는 가이드에서 세 가지 방향을 선정하십시오.
  2. 이 채팅 또는 프로젝트에서 마지막 세 사이트에서 사용된 방향은 건너뛰십시오(스타일 로그).
  3. 프로젝트 브리핑에 한 줄을 작성하십시오: 방향: <이름> — <이유>, 대안 하나 포함.
  4. 해당 방향의 시그니처 선택으로 구축한 다음, 다양성 검사를 실행하십시오: 여섯 가지 축 중 적어도 네 가지가 이전 사이트와 달라야 합니다.

방향은 구조와 느낌에 대한 참조입니다. 참조의 브랜드, 사진, 카피 또는 정확한 레이아웃을 절대 복사하지 마십시오. 클라이언트가 디자인을 제공하면 그것을 따르고 이 단계를 건너뛰십시오(§0 황금률).

0.9 독특한 시각적 디자인 (브리핑이 열려 있을 때)

출처: anthropics/skills, 스킬 frontend-design (Apache-2.0, LICENSE.txt 참조). 브리핑이 시각적 방향을 열어둔 경우에만 적용됩니다. §0이 우선합니다: 클라이언트의 디자인과 브리핑 자체의 문구를 따르십시오. 브리핑이 아래 나열된 스타일 중 하나를 요청하는 경우도 포함됩니다.

  • 먼저 주제를 식별하십시오: 제품, 청중, 주요 작업. 브리핑에 명시되지 않은 경우 하나를 제안하고 확인하십시오. 산업과 재료가 독특한 선택을 하는 곳입니다.
  • 히어로는 주제 세계에서 가장 특징적인 것으로 시작합니다(헤드라인, 이미지, 라이브 데모 또는 인터랙션). 큰 숫자, 작은 레이블, 그라데이션 악센트가 명확히 최선의 선택이 아닌 한 기본값을 피하십시오.
  • 서체: 하나의 패밀리, 또는 명확히 구별되는 두 개. 명확한 서체 스케일을 설정하십시오. 헤드라인에서 서체 처리는 디자인의 일부입니다.
  • 줄 길이는 80자 미만. 세리프 본문 텍스트는 산세리프보다 약간 더 큰 줄 간격이 필요합니다.
  • 타이포그래피 징후를 피하십시오: 헤드라인에서 하나의 이탤릭 또는 컬러 단어, 모두 대문자 레이블, 아무것도 추가하지 않는 헤딩 위의 레이블.
  • 번호가 매겨진 마커(01 / 02 / 03)는 콘텐츠가 정말 순서일 때만 사용하십시오.
  • 모션: 하나의 조율된 순간(페이지 로드 또는 하나의 리빌). 모든 섹션에 페이드 앤 슬라이드를 적용하지 말고, 모든 카드에 호버 트랜지션을 적용하지 마십시오. 사용자 동작(열기, 확장, 확인)에 응답하는 모션은 괜찮습니다.
  • 코드 작성 전 계획: 4–6개의 명명된 16진수 색상, 서체 역할, 레이아웃 개념(ASCII 와이어프레임 허용), 원칙. 브리핑에 대해 계획을 검토하십시오. 어떤 부분이 비슷한 페이지의 일반적인 기본값처럼 읽히면 수정하고 무엇이 변경되었는지 말하십시오.
  • 브리핑에서 요청하지 않는 한 피해야 할 기본 스타일: 크림 배경에 테라코타 악센트; 거의 검은색에 산성 녹색 또는 버밀리온 악센트; 헤어라인 규칙과 제로 반경의 브로드시트; 동일한 반경과 회색 그림자가 있는 동일한 둥근 SaaS 카드; 모든 헤딩 위의 모두 대문자 눈썹; 가운데 점 메타 문자열('A · B · C'); '단어 — 조각' 레이블; 검은색 대신 #0B0B0B 또는 #111; 작은 레이블에 모노스페이스; 모든 링크에 '→'.
  • 대담함은 한 곳에 집중하십시오. 주변의 모든 것을 조용하게 유지하십시오. 브리핑에 도움이 되지 않는 장식은 제거하십시오.
  • 품질 기준: 모바일 반응형, 보이는 포커스, 축소된 모션 존중, 접근 가능한 대비.
  • CSS 선택자 특이성, 특히 규칙이 서로를 취소하는 섹션 간의 패딩과 마진을 주의하십시오.
  • 카피: 최종 사용자를 위한 평범한 단어, 능동태, 문장 케이스. 흐름을 통해 하나의 동사를 유지하십시오("게시"는 "게시됨"으로 이어짐). 오류는 사과 없이 무슨 일이 일어났는지와 수정 방법을 말합니다. 빈 상태는 다음 작업을 초대합니다.

1. 결정 흐름 — 요청에 따른 도구 선택

  1. 아랍어, 이중 언어 또는 RTL 사이트 → 레이아웃을 작성하기 전에 references/rtl-arabic.md를 읽으십시오. 방향은 구조적입니다. 나중에 수정하는 데 비용이 많이 듭니다.
  2. 사이트 어디든 부드러운 스크롤 → Lenis (전역 제공자, §3). 스크롤 애니메이션이 존재할 때 프로젝트 설정 시 한 번 수행하십시오.
  3. 이미 효과를 수행하는 React Bits 컴포넌트가 있습니까? → references/react-bits-catalog.md 확인 → 설치(§4). 일반적인 적중: 분할/블러/스크램블 텍스트, 스크롤 리빌 텍스트, 애니메이션 배경(오로라, 파티클, 그리드, 셰이더), 사용자 정의 커서, 마그넷/틸트 카드, 마키, 갤러리, 독/메뉴, 애니메이션 버튼/카운터.
  4. 효과가 이 디자인에 특화된 경우(히어로 인트로 시퀀스, 고정된 스토리텔링 섹션, 가로 스크롤 섹션, 동기화된 다중 요소 리빌) → GSAP 타임라인 / ScrollTrigger(§5, 자세한 내용은 references/gsap.md).
  5. 프로젝트가 React가 아닌 경우(일반 HTML/바닐라) → React Bits를 사용할 수 없습니다. Lenis + GSAP만 사용하십시오(assets/vanilla-setup.js).
  6. 모든 양식, 목록, 예약 또는 데이터 기반 섹션 → references/forms-and-states.md(레이블, 오류, 다섯 가지 상태).
  7. 타사 서비스 선택(글꼴, 양식 백엔드, 분석, 호스팅, 이미지) → references/free-services.md를 읽은 다음 현재 한도를 확인하십시오.
  8. 클라이언트 디자인이 없는 새 사이트 → 먼저 방향을 선택하십시오(§0.8, references/design-styles.md).

2. 설치

npm install gsap @gsap/react lenis
  • @gsap/react → React 프로젝트 전용(useGSAP 제공).
  • lenis/react 및 lenis/snap은 lenis 내부에 포함되어 있습니다 — 추가 패키지가 필요하지 않습니다.
  • 모든 GSAP 플러그인(ScrollTrigger, SplitText, Flip, ScrollSmoother, Draggable…)은 gsap 내부에 포함되어 있습니다.
  • React Bits 컴포넌트는 CLI를 통해 개별적으로 추가됩니다(§4). 일부는 자체 종속성(motion, three, ogl, matter-js…)을 가져옵니다 — CLI가 설치하지만, 선택하기 전에 카탈로그의 Deps 열을 확인하여 번들을 비대하게 만들지 않도록 하십시오.

절대 GSAP의 ScrollSmoother를 Lenis와 함께 사용하지 마십시오 — 이들은 두 개의 경쟁하는 부드러운 스크롤 엔진입니다. Lenis가 이 스택의 스크롤 엔진입니다.

3. Lenis + GSAP + ScrollTrigger 연결 (정확히 이렇게 하십시오)

React / Next.js

assets/SmoothScroll.jsx를 프로젝트에 복사하고(예: components/SmoothScroll.jsx) 앱을 한 번 래핑하십시오:

// app/layout.jsx (Next.js App Router)
import SmoothScroll from '@/components/SmoothScroll';
import ScrollToTopOnRoute from '@/components/ScrollToTopOnRoute';

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        <SmoothScroll>
          <ScrollToTopOnRoute />
          {children}
        </SmoothScroll>
      </body>
    </html>
  );
}

아랍어의 경우 <html>에서 로케일을 기반으로 lang 및 dir을 설정하십시오(references/rtl-arabic.md §1 참조).

Vite/React의 경우 main.jsx에서 <App />을 동일한 방식으로 래핑하고 ScrollToTopOnRoute를 건너뛰십시오(next/navigation을 사용합니다).

제공자가 수행하는 작업 — 그리고 각 줄이 중요한 이유:

  • <ReactLenis root options={{ autoRaf: false }}> → <html>에 하나의 전역 인스턴스; autoRaf: false는 GSAP이 이를 구동하기 때문입니다.
  • lenis.on('scroll', ScrollTrigger.update) → 모든 부드러운 스크롤 프레임에서 ScrollTrigger가 다시 계산됩니다. 이 단계를 놓치면 애니메이션이 늦게/잘못된 위치에서 실행됩니다.
  • gsap.ticker.add(t => lenis.raf(t * 1000)) → 하나의 공유 루프(GSAP 시간은 초, Lenis는 ms를 원함).
  • gsap.ticker.lagSmoothing(0) → 탭 전환 후 따라잡을 때 덜컹거림이 없습니다.
  • 글꼴 및 로드 후 ScrollTrigger.refresh() → 트리거 위치가 최종 레이아웃과 일치합니다.

바닐라 HTML/JS

assets/vanilla-setup.js를 진입 모듈로 사용하고 필요한 곳에서 lenis를 가져오십시오.

4. React Bits — 컴포넌트 선택 및 설치

  1. references/react-bits-catalog.md에서 컴포넌트를 찾으십시오(그룹화: 텍스트 애니메이션, 애니메이션, 컴포넌트, 마이크로, 배경 — 이름, 기능, 종속성).
  2. 프로젝트에 맞는 변형을 선택하십시오: JS 또는 TS, 그런 다음 CSS 또는 TW(Tailwind).
  3. 설치:
    npx shadcn@latest add @react-bits/SplitText-TS-TW
    
    @react-bits/ 약어를 사용하려면 프로젝트의 components.json에 다음이 포함되어야 합니다:
    { "registries": { "@react-bits": "https://reactbits.dev/r/{name}.json" } }
    
    components.json이 없거나 shadcn 프로젝트가 아닌 경우? 대신 직접 URL을 사용하십시오:
    npx shadcn@latest add https://reactbits.dev/r/SplitText-TS-TW.json
    # 또는
    npx jsrepo@latest add https://reactbits.dev/r/SplitText-TS-TW
    
  4. 설치된 파일을 열고 사용하기 전에 props를 읽으십시오 — 모든 컴포넌트는 구성 가능합니다(색상, 속도, 지연, 이징, 트리거). 데모 기본값을 그대로 두지 말고 기존 사이트 디자인 토큰(색상, 글꼴)과 일치하도록 props를 설정하십시오.
  5. 사용자가 에이전트 워크플로우를 원하는 경우: npx shadcn@latest mcp init --client claude는 Claude Code를 MCP를 통해 레지스트리에 연결합니다.

통합 참고 사항:

  • 스크롤 시 애니메이션되는 React Bits 컴포넌트(ScrollReveal, ScrollFloat, AnimatedContent, SplitText…)는 내부적으로 GSAP ScrollTrigger 또는 IntersectionObserver를 사용합니다 → §3이 적용되어 있는 한 Lenis와 자동으로 작동합니다.
  • 컴포넌트는 클라이언트 컴포넌트입니다('use client'). Next.js에서는 이를 허용하는 클라이언트 컴포넌트나 페이지 내에서 렌더링하십시오.
  • WebGL/셰이더 배경(종속성 three, ogl, vgpu)은 무겁습니다: 페이지당 최대 1~2개, 폴드 아래는 느리게 로드(next/dynamic with ssr: false 또는 React.lazy)하고 고정 크기 컨테이너를 제공하십시오. 화면 밖이거나 탭이 숨겨져 있을 때 일시 중지하십시오.
  • 동일한 뷰포트에 두 개의 커서 효과 또는 두 개의 배경을 쌓지 마십시오.
  • 5초 이상 반복되는 경우 각 컴포넌트에 일시 중지 컨트롤이 있는지 확인하십시오(references/accessibility-motion.md §5 참조).
  • 라이선스: React Bits는 MIT + Commons Clause입니다 — 모든 클라이언트 웹사이트(유료 클라이언트 작업 포함) 내에서 무료로 사용할 수 있지만, 컴포넌트 자체를 패키지/템플릿으로 재판매하거나 재배포해서는 안 됩니다. React Bits 소스를 이 스킬이나 공유 라이브러리에 절대 붙여넣지 말고 항상 레지스트리에서 설치하십시오.

5. GSAP 필수 사항 (사용자 정의 애니메이션)

React에서는 항상 scope와 함께 useGSAP를 사용하십시오 — 절대 useEffect를 직접 사용하지 마십시오:

'use client';
import { useRef } from 'react';
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
import { useGSAP } from '@gsap/react';
gsap.registerPlugin(ScrollTrigger, useGSAP);

export default function Story() {
  const root = useRef(null);
  useGSAP(() => {
    const tl = gsap.timeline({
      scrollTrigger: { trigger: root.current, start: 'top top', end: '+=150%', scrub: 1, pin: true },
    });
    tl.from('.line', { yPercent: 100, autoAlpha: 0, stagger: 0.15 })
      .to('.image', { scale: 1.15 }, '<');
  }, { scope: root });
  return <section ref={root}>…</section>;
}

핵심 패턴 (자세한 내용 + 반응형 matchMedia, 배칭, FOUC, 체크리스트는 references/gsap.md에):

  • 1개 이상의 요소가 있는 모든 것에 타임라인 사용; 반복 카드에는 ScrollTrigger.batch() 사용.
  • 스크롤 연결 모션을 위한 scrub (Lenis를 사용하면 scrub: true가 이미 부드럽습니다; scrub: 1은 추가 지연을 추가합니다).
  • pin: true는 네이티브 스크롤에서 Lenis와 함께 작동합니다 — Lenis가 root를 사용할 때 pinType 핵이 필요하지 않습니다.
  • 가로 스크롤 섹션: 래퍼를 고정하고, 트랙의 x를 -(track.scrollWidth - innerWidth)로 트윈하고, scrub: true, invalidateOnRefresh: true를 설정하십시오. RTL에서는 방향을 반대로 하십시오(references/rtl-arabic.md §6 참조).
  • 장식 블록을 gsap.matchMedia()로 감싸서 축소된 모션 사용자가 대체 효과를 받도록 하십시오(references/accessibility-motion.md §3 참조).

6. RTL / 아랍어

전체 가이드: references/rtl-arabic.md. 요약:

  • <html dir="rtl" lang="ar"> — 올바른 루트 방향 없이는 CSS 논리적 속성이 제대로 작동하지 않습니다.
  • Flexbox flexDirection과 Grid gridTemplateColumns는 자동으로 반전됩니다.
  • 텍스트 정렬: 본문 text-start / 제목 text-balance.
  • 아랍어 글꼴: references/free-services.md의 변형 글꼴 목록, 아랍어 문자 집합이 포함된 것을 선택하십시오.
  • GSAP 가로 스크롤: 방향을 반대로 하고 RTL 스크롤바 동작을 테스트하십시오.
  • next-intl 또는 next-i18n과 같은 i18n 라이브러리를 사용하는 것은 괜찮지만 필수는 아닙니다. 가장 중요한 것은 <html> 방향이 올바른지 확인하는 것입니다.

7. 양식

references/forms-and-states.md를 읽고 초점, 유효성, 오류, 비활성화, 로딩, 빈 상태, 성공, 낙관적 UI 등 다섯 가지 상태를 구현하십시오.

양식 백엔드 선택(무료 옵션은 references/free-services.md에):

  • Web3Forms → 이메일만 필요, 무료 계층 250/월.
  • Formspree → 유료 계층에서 더 많은 기능.
  • Resend + React Email → 트랜잭셔널 이메일, React 컴포넌트로 이메일 작성, 높은 전달 가능성.
  • 클라이언트가 백엔드를 가지고 있거나 원한다면 → action을 해당 엔드포인트로 설정하고 references/forms-and-states.md에 설명된 다섯 가지 상태를 구현하십시오.

8. 마이크로 카피

references/micro-copy.md에는 다음에 대한 지침이 포함되어 있습니다:

  • 오류 메시지 (무슨 일이 일어났고 어떻게 고치는지): references/forms-and-states.md 참조.
  • 로딩 및 빈 상태.
  • CTA 및 버튼 텍스트.
  • 툴팁 및 접근성 레이블.

9. 카피라이팅

references/copywriting.md에는 다음에 대한 지침이 포함되어 있습니다:

  • 브랜드 보이스 및 톤.
  • 헤드라인, 부제목, 본문.
  • SEO 메타 설명.

10. 접근성

references/accessibility-motion.md:

  • WCAG 2.2 AA 기본값.
  • ARIA 레이블 및 역할.
  • 포커스 관리.
  • prefers-reduced-motion 지원.

a11y 체크리스트도 참조하십시오.

11. 분석

references/free-services.md 목록에서 선택하십시오 (Umami, Plausible, PostHog…).

PHP 분석 도구(Piwik/Matomo 자체 호스팅)는 React SPA에서 제대로 작동하지 않으며 Next.js에서 구성하기 어렵습니다 — 피하십시오.

12. 글꼴

references/free-services.md → 무료 변형 글꼴 목록. Google Fonts, Fontsource, Fontshare, jsDelivr.

13. 이미지 및 미디어

  • 긴 목록의 경우 next/image, lazy loading + placeholder 사용.
  • loading="lazy"는 <img> 및 <iframe>에서 기본값이 아닙니다 — 명시적으로 설정하십시오.
  • WebP + AVIF 소스 세트를 제공하십시오 (Next.js의 내장 최적화를 사용하거나 수동으로 <picture> 요소 사용).
  • 아이콘은 인라인 SVG여야 함 (로딩 없음, 확장 가능, 색상 변경 가능).
  • 배경은 CSS 그라데이션, CSS 필터 또는 LQIP (저품질 이미지 플레이스홀더)를 사용하십시오.
  • 비디오: <video> 요소를 사용하고 항상 자막을 추가하십시오.

14. 성능

references/performance.md:

  • Lighthouse 목표.
  • 번들 크기 제한.
  • 이미지 최적화.
  • 코드 분할 지침.

만들어야 할 LG 성능 작업:

  • 선호하는 Lighthouse 점수 목표를 명시하십시오.
  • GSAP 및 Lenis가 제대로 정리되었는지 확인하십시오 (§3).
  • IntersectionObserver로 느리게 로드할 수 있는 섹션을 식별하십시오.
  • WebGL 컴포넌트에 일시 중지 컨트롤이 있는지 확인하십시오.

15. SEO

references/seo.md:

  • 메타 태그.
  • 구조화된 데이터.
  • 오픈 그래프.
  • 사이트맵.

만들어야 할 SEO 작업:

  • Next.js 메타데이터 API로 메타 태그를 설정하십시오.
  • 사이트에 대한 JSON-LD 구조화된 데이터를 생성하십시오.
  • 사이트맵을 구성하고 확인하십시오.
  • robots.txt를 확인하십시오.
  • 검색 엔진이 인덱싱할 수 있는지 확인하십시오 (noindex 없음, 차단된 리소스 없음).

16. 배포

references/deployment.md:

  • Vercel, Netlify, Cloudflare Pages.
  • 환경 변수.
  • 빌드 명령어.
  • 미리보기 배포.

만들어야 할 배포 작업:

  • 자동 배포를 위해 Git 리포지토리를 연결하십시오.
  • 환경 변수를 설정하십시오(비밀 키는 배포 대시보드에, 공개 변수는 .env.local에).
  • 빌드 명령어를 확인하십시오.
  • 미리보기 배포를 확인하십시오.
  • 사용자 정의 도메인을 설정하십시오(있는 경우).

17. 방어적 프롬프트 (버그 방지)

  • 어떤 코드를 작성하기 전에 항상 references/ 디렉토리의 관련 가이드를 확인하십시오.
  • 알 수 없는 오류가 발생하면 멈추고, 컨텍스트를 설명하고, 문제를 해결하기 전에 승인을 기다리십시오.
  • 불필요한 타사 종속성을 추가하지 말고 항상 references/free-services.md를 확인하십시오.
  • 항상 references/quality-bar.md 및 references/accessibility-motion.md를 확인하십시오.
  • 접근성에 대해 추측하지 마십시오. WCAG 2.2 AA를 고수하십시오.
  • 사용자 프롬프트가 명확하지 않은 경우, 가정하지 말고 명확히 하십시오.
  • 사용자가 완료되었다고 말할 때까지 코드를 계속 작성하지 마십시오. 이전 코드가 완료될 때까지 기다렸다가 다음 단계를 진행하십시오.
  • 사용자 정의 도메인, SSL, 이메일 전달 가능성, 양식 백엔드 한도 등 배포 전제 조건을 추측하지 마십시오 — 클라이언트에게 물어보십시오.

관련 스킬