🔨 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 읽기 및 검증
- 작업 공간 루트에서
supersite-plan.md를 찾습니다.- 파일이 없으면 사용자에게 알리고 일시 중지합니다:
"프로젝트 루트에
supersite-plan.md가 없습니다. 협업 계획을 설계하려면/supersite-plan을 실행하거나, 직접 생성을 위해/supersite <프롬프트>를 실행하세요."
- 파일이 없으면 사용자에게 알리고 일시 중지합니다:
- 계획에서 아키텍처 매개변수를 파싱합니다:
- 미적 장르 및 색상 팔레트(Hex/OKLCH, 60-30-10 분포).
- 타이포그래피 및 모서리 반경 선택.
- 라우트 및 컴포넌트 매니페스트.
- 섹션 카피, 헤드라인 및 상호작용 요소.
2단계: 스캐폴딩, 타입 및 설정
- 의존성 확인:
- 표준 유틸리티(
lucide-react,clsx,tailwind-merge)가 있는지 확인합니다. 없으면 설치:npm install lucide-react clsx tailwind-merge
- 표준 유틸리티(
- 타입스크립트 계약 생성 (
src/types/site.ts):NavItem,FeatureItem,PricingPlan,Testimonial,FAQItem에 대한 타입을 정의합니다.
- 중앙 설정 파일 생성 (
src/config/site.ts):- 네비게이션 링크, 브랜드 메타데이터 및 구조화된 섹션 콘텐츠를 한 곳에 저장합니다.
- 기본 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단계: 라우트 조립 및 빌드 검증
src/app/page.tsx조립:- 섹션 컴포넌트를 가져와 깔끔하고 선언적인 JSX로 내러티브 레이아웃을 구성합니다.
- 추가 라우트 조립:
- 계획이 다중 페이지 라우트(
/features,/pricing,/security)를 지정한 경우 해당page.tsx파일을 구성합니다.
- 계획이 다중 페이지 라우트(
- 사전 점검 안티 슬롭 감사 실행:
- 금지된 스타일 확인: 보라색 그라데이션 얼룩 없음, 근거 없는 카드 없음, 일반적인 플레이스홀더 복사 없음.
- 터치 대상 확인: 상호작용 히트 영역이 ≥44×44px인지 확인.
- 엠 대시 확인: 모든 UI 카피, 헤드라인, 마이크로카피 및 버튼 레이블에 엠 대시(
—또는--)가 없는지 확인.
- 컴파일 및 빌드 게이트:
- 작업 공간 빌드 명령어 실행:
npm run build - 타입스크립트 오류나 누락된 import가 발생하면 즉시 수정하고 빌드가 코드 0으로 깔끔하게 통과할 때까지 다시 실행합니다.
- 작업 공간 빌드 명령어 실행:
- 사용자에게 보고:
- 모든 대화 응답 및 진행 보고서에서 엠 대시 제로 규칙을 적용합니다 (
—또는--절대 사용 금지). 대신 마침표, 콜론, 쉼표 또는 괄호를 사용합니다. - 클릭 가능한 링크와 함께 구축된 파일의 깔끔한 요약을 제공합니다:
[supersite-plan.md](file:///path/to/supersite-plan.md)[page.tsx](file:///path/to/src/app/page.tsx)src/components/site/내 개별 컴포넌트 링크
- 성공적인 컴파일을 확인합니다.
- 모든 대화 응답 및 진행 보고서에서 엠 대시 제로 규칙을 적용합니다 (