Communitygithub.com

supersite-build

AI 코딩 에이전트를 위한 정밀 웹사이트 빌더입니다. supersite-plan.md 사양 명세서를 읽고, 깔끔하고 조립 가능한 React/Next.js 컴포넌트를 생성하며, 디자인 토큰을 연결하고, npm run build로 컴파일을 검증합니다.

supersite-build란 무엇인가요?

supersite-build는 AI 코딩 에이전트가 supersite-plan.md에 정의된 아키텍처 계획을 정확하게 실행하도록 설계된 전문 스킬입니다. 이 스킬은 명세서를 읽고, 타입스크립트 타입, 중앙 설정 파일, 기본 CSS를 생성하는 단계를 거쳐 점진적으로 UI 기본 요소(컨테이너, 버튼, 뱃지 등)를 구축하고, 최종적으로 계획된 모든 섹션 블록(네비게이션 바, 히어로, 기능 그리드, 가격 매트릭스 등)을 조립합니다. 모든 단계는 빌드 게이트(npm run build)로 검증되어 컴파일 오류 없이 완전한 작동을 보장합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 코딩 에이전트 플랫폼에서 사용할 수 있으며, 엄격한 사양 기반 접근 방식과 반복적인 빌드 검증을 통해 '안티 슬롭' 감사(보라색 그라데이션 얼룩, 부유하는 카드, 일반적인 플레이스홀더 복사 방지)를 수행하여 고품질의 일관된 출력을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/developer-mohanaditya/supersite/tree/HEAD/skills/supersite-build

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

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

문서

🔨 supersite-build: 정밀 빌더

supersite-build는 /supersite-plan이 수립한 아키텍처 계획을 실행합니다. supersite-plan.md를 읽고, 원자적 컴포넌트를 구성하며, 디자인 토큰과 카피를 연결하고, 빌드 엔진을 통해 구현을 검증합니다.


실행 파이프라인

┌─────────────────────────────────────────────────────────────┐
│ 1. 사양 명세서 읽기 및 검증                                 │
│ supersite-plan.md에서 토큰, 라우트, 매니페스트 파싱         │
├─────────────────────────────────────────────────────────────┤
│ 2. 스캐폴딩, 타입 및 설정                                  │
│ src/types/site.ts, src/config/site.ts 및 기본 CSS 생성     │
├─────────────────────────────────────────────────────────────┤
│ 3. UI 기본 요소 구축                                       │
│ Container, SectionHeader, Button, Badge 및 Card            │
├─────────────────────────────────────────────────────────────┤
│ 4. 섹션 블록 구축                                          │
│ Navbar, Hero, Contrast, Features, Proof, Pricing 및 Footer │
├─────────────────────────────────────────────────────────────┤
│ 5. 라우트 조립 및 빌드 검증                                │
│ 페이지 연결, 접근성 확인 및 npm run build 실행             │
└─────────────────────────────────────────────────────────────┘

1단계: supersite-plan.md 읽기 및 검증

  1. 작업 공간 루트에서 supersite-plan.md를 찾습니다.
    • 파일이 없으면 사용자에게 알리고 일시 중지합니다:

      "프로젝트 루트에 supersite-plan.md가 없습니다. 협업 계획을 설계하려면 /supersite-plan을 실행하거나, 직접 생성을 위해 /supersite <프롬프트>를 실행하세요."

  2. 계획에서 아키텍처 매개변수를 파싱합니다:
    • 미적 장르 및 색상 팔레트(Hex/OKLCH, 60-30-10 분포).
    • 타이포그래피 및 모서리 반경 선택.
    • 라우트 및 컴포넌트 매니페스트.
    • 섹션 카피, 헤드라인 및 상호작용 요소.

2단계: 스캐폴딩, 타입 및 설정

  1. 의존성 확인:
    • 표준 유틸리티(lucide-react, clsx, tailwind-merge)가 있는지 확인합니다. 없으면 설치:
      npm install lucide-react clsx tailwind-merge
      
  2. 타입스크립트 계약 생성 (src/types/site.ts):
    • NavItem, FeatureItem, PricingPlan, Testimonial, FAQItem에 대한 타입을 정의합니다.
  3. 중앙 설정 파일 생성 (src/config/site.ts):
    • 네비게이션 링크, 브랜드 메타데이터 및 구조화된 섹션 콘텐츠를 한 곳에 저장합니다.
  4. 기본 CSS 업데이트 (src/app/globals.css):
    • 색상 변수, 선택 스타일 및 동작 감소 접근성 블록을 주입합니다:
      @layer base {
        ::selection {
          background-color: var(--accent);
          color: var(--accent-foreground);
        }
      }
      
      @media (prefers-reduced-motion: reduce) {
        *, ::before, ::after {
          animation-duration: 0.01ms !important;
          animation-iteration-count: 1 !important;
          transition-duration: 0.01ms !important;
          scroll-behavior: auto !important;
        }
      }
      

3단계: UI 기본 요소 구축 (src/components/ui/)

모듈식 기본 요소 생성:

  • container.tsx: 반응형 패딩이 있는 최대 너비 컨테이너(max-w-6xl 또는 max-w-7xl).
  • section-header.tsx: 표준화된 뱃지, 제목 및 설명 블록.
  • button.tsx: 명시적인 :focus-visible 스타일이 있는 변형 기반 버튼(primary, secondary, outline, ghost).
  • badge.tsx: 가는 테두리선이 있는 필 및 상태 칩.
  • card.tsx: 계획의 표면 색상, 테두리 및 반경 토큰을 적용하는 표면 래퍼.

4단계: 섹션 블록 구축 (src/components/site/)

계획에 명시된 각 섹션을 구성합니다:

  • navbar.tsx: 데스크톱 네비게이션 링크, 행동 유도 CTA 및 모바일 햄버거 드로어가 있는 반응형 헤더.
  • hero.tsx: 후크 필, H1 제목, 리드 문단, CTA 클러스터 및 대화형 제품 미리보기(예: 터미널 또는 UI 프레임).
  • problem-contrast.tsx: 현 상태의 문제와 현대적 해결책을 대비시키는 비대칭 시각적 대조.
  • feature-grid.tsx: 비대칭 벤토 그리드 또는 모듈식 기능 셀. 반복적인 3카드 복사 없음.
  • product-showcase.tsx: 대화형 컴포넌트(탭 코드 탐색기, 라이브 대화형 미리보기 또는 설정 플레이그라운드).
  • social-proof.tsx: 검증 가능한 지표 콜아웃 및 특정 엔지니어링 역할이 포함된 고객 사용 후기 인용문.
  • pricing-matrix.tsx: 월간/연간 청구 토글("use client" 사용), 티어 카드, 기능 체크리스트 및 체크아웃 CTA.
  • faq-accordion.tsx: 부드러운 CSS 그리드 높이 전환을 사용하는 확장 가능한 기술 Q&A.
  • footer.tsx: 다중 열 네비게이션 링크, 법적 앵커, 시스템 상태 점 및 저작권.

5단계: 라우트 조립 및 빌드 검증

  1. src/app/page.tsx 조립:
    • 섹션 컴포넌트를 가져와 깔끔하고 선언적인 JSX로 내러티브 레이아웃을 구성합니다.
  2. 추가 라우트 조립:
    • 계획이 다중 페이지 라우트(/features, /pricing, /security)를 지정한 경우 해당 page.tsx 파일을 구성합니다.
  3. 사전 점검 안티 슬롭 감사 실행:
    • 금지된 스타일 확인: 보라색 그라데이션 얼룩 없음, 근거 없는 카드 없음, 일반적인 플레이스홀더 복사 없음.
    • 터치 대상 확인: 상호작용 히트 영역이 ≥44×44px인지 확인.
    • 엠 대시 확인: 모든 UI 카피, 헤드라인, 마이크로카피 및 버튼 레이블에 엠 대시(— 또는 --)가 없는지 확인.
  4. 컴파일 및 빌드 게이트:
    • 작업 공간 빌드 명령어 실행:
      npm run build
      
    • 타입스크립트 오류나 누락된 import가 발생하면 즉시 수정하고 빌드가 코드 0으로 깔끔하게 통과할 때까지 다시 실행합니다.
  5. 사용자에게 보고:
    • 모든 대화 응답 및 진행 보고서에서 엠 대시 제로 규칙을 적용합니다 (— 또는 -- 절대 사용 금지). 대신 마침표, 콜론, 쉼표 또는 괄호를 사용합니다.
    • 클릭 가능한 링크와 함께 구축된 파일의 깔끔한 요약을 제공합니다:
      • [supersite-plan.md](file:///path/to/supersite-plan.md)
      • [page.tsx](file:///path/to/src/app/page.tsx)
      • src/components/site/ 내 개별 컴포넌트 링크
    • 성공적인 컴파일을 확인합니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬