Communitygithub.com

supersite-plan: 협력형 웹사이트 설계자

AI 코딩 에이전트를 위한 협력형 웹사이트 설계 도구입니다. 구조화된 선택지와 사용자 정의 지침을 바탕으로 인터뷰를 진행하고, 사이트 스토리와 미학을 설계하며, 완전한 supersite-plan.md 명세서를 출력합니다.

supersite-plan: 협력형 웹사이트 설계자란 무엇인가요?

supersite-plan은 코드를 작성하기 전에 웹사이트를 계획하는 AI 에이전트 스킬입니다. 이 도구는 잘못된 기대를 방지하기 위해 구조화된 인터뷰를 수행하고, 디자인 시스템을 수립하며, 내러티브 시퀀스를 초안으로 작성하고, 완전한 `supersite-plan.md` 프로젝트 계약서를 생성합니다. Claude Code, Cursor, Codex와 같은 주요 AI 코딩 에이전트 플랫폼에서 사용할 수 있도록 설계되었습니다. 이 도구는 4가지 주요 단계로 작동합니다: (1) 다차원 발견 인터뷰(사이트 범위, 미적 장르, 핵심 기능, 코드베이스 관계), (2) 디자인 토큰 및 장르 합성, (3) 내러티브 및 라우트 아키텍처, (4) `supersite-plan.md` 명세서 계약서 출력. 사용자가 `/supersite-build` 명령어를 실행하면 이 계약서를 기반으로 실제 코드가 생성됩니다. 명확하고 인간적인 상호작용을 보장하기 위해 'Zero Em-Dash 규칙'(em-dash 사용 금지)을 의무적으로 적용합니다.

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

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

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

문서

📐 supersite-plan: 협력형 설계자

supersite-plan은 코드를 작성하기 전에 웹사이트를 계획합니다. 집중 인터뷰를 통해 디자인 시스템을 수립하고, 내러티브 시퀀스를 초안으로 작성하며, 완전한 supersite-plan.md 프로젝트 계약서를 생성하여 잘못된 기대를 방지합니다.

계획이 확정되면 사용자는 /supersite-build를 실행하여 계획을 실행합니다.


협력형 계획 수립 흐름

┌─────────────────────────────────────────────────────────────┐
│ 1. 다차원 발견 인터뷰                                       │
│    구조화된 프론티어 질문 (선택지 + 사용자 정의 프롬프트)              │
├─────────────────────────────────────────────────────────────┤
│ 2. 디자인 토큰 및 장르 합성                                 │
│    선택 사항을 60-30-10 팔레트, 타이포그래피 및 재료에 매핑          │
├─────────────────────────────────────────────────────────────┤
│ 3. 내러티브 및 라우트 아키텍처                               │
│    섹션 순서, 헤드라인, 컴포넌트 분류 세부 설명                     │
├─────────────────────────────────────────────────────────────┤
│ 4. supersite-plan.md 명세서 계약서 출력                       │
│    /supersite-build가 실행할 전체 아키텍처를 지속적으로 저장         │
└─────────────────────────────────────────────────────────────┘

1단계: 프론티어 발견 인터뷰

사용자에게 일련의 목표 질문을 합니다. 각 질문에 대해 구조화된 옵션과 권장 기본값을 제공하고, 사용자 정의 지침을 환영합니다.

질문 패턴:

질문 [N]: [주제]
[A] (권장) 옵션 1 설명
[B] 옵션 2 설명
[C] 옵션 3 설명

👉 옵션 문자(A, B, C)로 답변하거나, 직접 구체적인 지침을 입력하세요.

Zero Em-Dash 규칙 (필수)

질문을 하거나, 옵션을 구성하거나, 카피를 작성하거나, 사용자에게 응답할 때 절대 em-dash(— 또는 --)를 사용하지 마십시오. Em-dash는 인터뷰 질문과 선택지를 인공적인 AI 판에 박힌 문구처럼 보이게 만듭니다. 생각을 깔끔하고 자신 있는 문장으로 나누거나, 콜론, 쉼표, 괄호를 대신 사용하십시오.

4가지 발견 영역:

1. 사이트 범위 및 라우트 계층 구조

  • [A] (권장) 고전환율 랜딩 페이지: 단일 페이지 내러티브 스크롤로 최대 전환율에 최적화됨 (Hero → 문제 → 제품 미리보기 → 증명 → 가격 → CTA).
  • [B] 다중 페이지 SaaS 아키텍처: 다중 라우트 구조 (/ 홈, /features 심층 분석, /pricing 매트릭스 및 FAQ, /security 규정 준수).
  • [C] 스튜디오 포트폴리오 및 사례 연구: 시각적 쇼케이스 (/ 쇼릴, /work/[slug] 인터랙티브 사례 연구, /inquire 연락처 양식).

2. 미적 장르 및 재료 기반

  • [A] (권장) 다크 프리시전: 흑요석 표면 (#09090b), 가는 선 테두리 (border-white/10), 고정폭 원격 측정, 레이저 에메랄드 또는 사이언 악센트.
  • [B] 콰이엇 럭셔리: 촉각적 아이보리 캔버스 (#faf8f5), 딥 포레스트 그린 잉크 (#0c2217), 샴페인 골드 디테일, 편집체 세리프 헤딩.
  • [C] 스위스 편집체: 신문 용지, 단색 1px 검정색 구분선 그리드, 버밀리언 신호 악센트, 대담한 그로테스크/세리프 대비.
  • [D] 모던 엔터프라이즈: 선명한 흰색 표면, 딥 네이비 블루 신뢰 악센트, SOC2/HIPAA 규정 준수 리본, 밀도 높은 비교 테이블.
  • [E] 볼드 컨슈머: 따뜻한 크림 캔버스, 2.5px 단색 잉크 테두리, 하드 오프셋 드롭 섀도우, 강렬한 네온 악센트, 재치 있는 마이크로카피.
  • [F] 시네마틱 스튜디오: 전체 뷰포트 어두운 극장 무대, 앰비언트 배경 비네트, 라이브 제품 쇼케이스, 스크롤 기반 장면 마커.

3. 핵심 기능 및 차별성

  • 이 제품이 해결하는 특정 마찰점 또는 깨진 현 상태는 무엇입니까?
  • 어떤 구체적이고 계량 가능한 지표가 당신의 우월성을 증명합니까? (예: 막연한 "번개처럼 빠른" 대신 "14ms 미만의 콜드 스타트", "제로 AWS 이그레스 마크업")

4. 코드베이스 관계

  • [A] (권장) 그린필드 클린 빌드: 표준 Next.js, React, Tailwind CSS 및 Lucide 아이콘을 사용하는 새 프로젝트.
  • [B] 기존 코드베이스에서 상속 (from-codebase): 로컬 리포지토리(globals.css, Tailwind 토큰, package.json)를 검사하여 기존 제품 브랜딩과 일치시킵니다.

2단계: 프로젝트 계약서 합성

사용자가 답변 또는 지침을 제공하면:

  1. ../supersite/references/genres/에서 해당 장르 청사진을 로드합니다.
  2. ../supersite/references/anti-slop.md에서 안티-슬롭 규칙을 적용합니다.
  3. ../supersite/references/copy-craft.md를 사용하여 진정성 있고 권위 있는 헤드라인과 카피를 작성합니다.
  4. ../supersite/references/component-system.md를 기반으로 구성 가능한 컴포넌트 분류를 정의합니다.
  5. Zero Em-Dash 규칙을 적용합니다. supersite-plan.md에 설명, 섹션 청사진, 헤드라인 및 마이크로카피에 em-dash(— 또는 --)가 하나도 포함되어 있지 않은지 확인합니다.

3단계: supersite-plan.md 작성

합의된 아키텍처를 프로젝트 루트의 supersite-plan.md에 저장합니다:

# ⚡ supersite 명세서 계약서: [프로젝트 이름]

> `/supersite-plan`이 생성함. `/supersite-build`로 실행.

## 1. 프로젝트 개요 및 대상 사용자
* **제품:** [간결한 제품 설명]
* **대상 사용자:** [특정 역할, 예: 시니어 인프라 엔지니어]
* **주요 전환 목표:** [예: 무료 스테이징 클러스터 배포 / 엔터프라이즈 데모 예약]

## 2. 디자인 시스템 토큰
* **미적 장르:** [예: 다크 프리시전]
* **60-30-10 팔레트:**
  * 60% 캔버스: `#09090b` (흑요석)
  * 30% 구조: `#121317` (패널) / `#27272a` (가는 선 테두리) / `#fafafa` (잉크)
  * 10% 레이저 악센트: `#10b981` (일렉트릭 에메랄드)
* **타이포그래피:** 디스플레이 (`Geist Sans`), 원격 측정 (`Geist Mono`)
* **모서리 반경:** `rounded-lg` (버튼 8px, 카드 12px)

## 3. 사이트 탐색 및 라우트 계층 구조
* 라우트 1: `/` (홈 전환 내러티브)
* 라우트 2: `/features` (아키텍처 및 API 심층 분석)
* 라우트 3: `/pricing` (인터랙티브 티어 매트릭스 및 FAQ)

## 4. 섹션별 청사진
* **내브바:** 고정식 프로스트 글라스 헤더 (`backdrop-blur-md`), 로고, 링크, 기본 CTA.
* **섹션 1 (Hero):**
  * 필: `v2.4 릴리스 // 분산 벡터 캐시`
  * 헤드라인: *"12ms 글로벌 읽기 복제본으로 서버리스 벡터 인덱싱을 배포하세요."*
  * 서브헤드: *"엣지에 임베딩을 저장합니다. 32개 리전에 자동 동기화되며 이그레스 마크업이 없습니다."*
  * CTA: *"지금 클러스터 배포"* + *"RFC 읽기"*
  * 제품 시각 자료: 라이브 탭 방식 인터랙티브 터미널 (`TypeScript` / `cURL`).
* **섹션 2 (문제 대비):** 중앙 집중식 데이터베이스 병목 현상 대 분산 엣지 캐시 비교.
* **섹션 3 (기능 벤토):** 3개의 비대칭 셀 (아키텍처 데이터 흐름, 지연 시간 차트, SDK 인체공학적 샘플).
* **섹션 4 (사회적 증명):** 계량화된 지표 (일일 1,420만 벡터, 99.99% 가동 시간) + 2개의 검증된 엔지니어 인용문.
* **섹션 5 (가격 매트릭스):** 개발자 (무료), 팀 ($49/월), 엔터프라이즈 (맞춤형) + 결제 간격 토글.
* **섹션 6 (FAQ):** 4개의 기술 공개 아코디언.
* **푸터:** 사이트맵, 상태 표시, 저작권 및 규정 준수 배지.

## 5. 파일 및 컴포넌트 매니페스트
* `src/components/ui/container.tsx`
* `src/components/ui/section-header.tsx`
* `src/components/ui/button.tsx`
* `src/components/site/navbar.tsx`
* `src/components/site/hero.tsx`
* `src/components/site/problem-contrast.tsx`
* `src/components/site/feature-grid.tsx`
* `src/components/site/social-proof.tsx`
* `src/components/site/pricing-matrix.tsx`
* `src/components/site/faq-accordion.tsx`
* `src/components/site/footer.tsx`
* `src/config/site.ts`
* `src/types/site.ts`

## 6. 사전 비행 확인 기준
* 보라색 그라데이션 오브 또는 일반적인 AI 블롭 없음.
* WCAG 2.2 AA 대비 규정 준수 (텍스트 ≥4.5:1, UI 경계 ≥3.0:1).
* 모바일 터치 대상 ≥44×44px.
* `npm run build`가 TypeScript 또는 스타일링 경고 없이 성공해야 함.

4단계: 다음 작업 프롬프트

supersite-plan.md를 작성한 후 사용자에게 알립니다:

계획 완료! 아키텍처 계약서가 supersite-plan.md에 작성되었습니다. 계획을 검토하거나 조정을 요청하세요. 사이트 구축을 시작할 준비가 되면 다음을 실행하세요: /supersite-build

Individual skills in this repo

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

관련 스킬