웹 디자인 위자드
개요
웹 페이지에 대해 여러 개의 독특한 디자인 스타일을 병렬 워크트리로 생성하여, 사용자가 최종 방향을 결정하기 전에 비교하고 다듬을 수 있게 합니다. 핵심 원칙: 분기적으로 탐색하고, 최적의 옵션으로 수렴하세요.
사용 시기
- 사용자가 웹 페이지에 대해 다양한 디자인 스타일을 탐색하고자 할 때
- 사용자가 디자인 옵션, 시각적 방향 또는 스타일 비교를 요청할 때
- 사용자가 여러 구현체 중에서 선택하고자 할 때
다음과 같은 경우에는 사용하지 마세요:
- 사용자가 이미 특정 디자인을 정의한 경우 →
saurun:react-tailwind-v4-components또는frontend-design을 직접 사용하세요. - 사용자가 새로 만드는 것이 아니라 기존 디자인을 수정하고자 하는 경우
전제 조건
아래 모든 스킬이 설치되어 있어야 합니다. 하나라도 없으면 중단하고 사용자에게 알리세요.
| 스킬 | 사용 단계 | 목적 |
|---|---|---|
ui-ux-pro-max | 2단계 | 디자인 시스템 생성 |
superpowers:using-git-worktrees | 6단계 | 병렬 워크트리 설정 |
frontend-design | 6단계 | 프로덕션 수준 구현 |
vercel-react-best-practices | 6단계 | React 최적화 |
copywriting | 6단계 | 카피 다듬기 |
nano-banana-pro | 6단계 | 이미지 생성 — 설치: npx skills add intellectronica/agent-skills@nano-banana-pro -g -y |
워크플로우
digraph design_wizard {
"사용자 요청" [shape=doublecircle];
"발견" [shape=box];
"스타일 생성" [shape=box];
"사용자 만족?" [shape=diamond];
"개선" [shape=box];
"그래픽 선호도" [shape=box];
"프로젝트 설정" [shape=box];
"병렬 구현" [shape=box];
"병렬 검증" [shape=box];
"완료" [shape=doublecircle];
"사용자 요청" -> "발견";
"발견" -> "스타일 생성";
"스타일 생성" -> "사용자 만족?";
"사용자 만족?" -> "개선" [label="아니오"];
"개선" -> "사용자 만족?";
"사용자 만족?" -> "그래픽 선호도" [label="예"];
"그래픽 선호도" -> "프로젝트 설정";
"프로젝트 설정" -> "병렬 구현";
"병렬 구현" -> "병렬 검증";
"병렬 검증" -> "완료";
}
1단계: 발견
AskUserQuestion을 사용하여 맥락을 수집합니다. 질문을 배치 처리 — 한 번 호출에 최대 4개의 질문을 사용하세요. 문맥에서 명백한 답변은 추론합니다 (예: 커피숍은 소비자 대상이고 따뜻한 분위기일 가능성이 높음).
수집할 정보:
- 프로젝트 이름 — package.json 또는 Git 저장소 이름에서 감지하고, 사용자에게 확인
- 페이지 유형 — 랜딩, 포트폴리오, 블로그, 이커머스, SaaS, 문서
- 대상 독자 — 전문가, 소비자, 개발자, 창의 산업
- 분위기/느낌 — 전문적인, 유쾌한, 럭셔리, 미니멀, 대담한, 따뜻한, 미래지향적인
- 콘텐츠 언어 — 영어, 덴마크어 등
- 스타일 선호/비선호 — 위 항목에서 명확하지 않은 경우에만 질문
사용자 요청에서 답변이 명확한 질문은 건너뜁니다.
2단계: 스타일 생성
ui-ux-pro-max를 사용하여 디자인 스타일을 생성합니다:
기본값: 4가지 스타일 (사용자가 다른 개수를 요청할 수 있음)
각 스타일에 대해:
-
발견 단계 응답으로 다양한 키워드 구성. 결합: 페이지 유형 + 대상 독자 + 분위기 + 독특한 미적 감각. 모든 스타일 간에 다양성을 보장하세요.
-
디자인 시스템 생성:
Skill도구로ui-ux-pro-max를 다음 인자와 함께 호출:"[키워드]" --design-system --persist -p "[ProjectName]" --page "[style-name]"현재 작업 디렉토리의design-system/pages/[style-name].md에 저장됩니다. -
사용자에게 제시: 스타일 이름, 주요 색상, 타이포그래피, 분위기 형용사, 최적 사용 사례.
생성된 스타일을 추적하여 개선 라운드에서 중복 키워드가 발생하지 않도록 하세요.
3단계: 개선 (반복)
| 사용자 말 | 동작 |
|---|---|
| "완전히 다른 N개의 스타일을 줘" | 다른 키워드로 N개의 새 스타일 생성 |
| "N개 더 옵션을 줘" | N개 새로 생성 (이전 키워드 회피) |
| "X와 Y가 마음에 들어, X와 비슷한 걸 더 줘" | X와 Y 유지, X의 변형 생성 |
| "스타일 X와 Y를 결합해 줘" | 두 미학을 혼합한 1개 생성 |
| "X, Y, Z를 구현해 줘" 또는 "전부 구현해 줘" | 선택 항목으로 4단계로 이동 |
4단계: 그래픽 선호도
구현 전에, 선택된 모든 스타일에 대한 그래픽을 한 번에 질문:
AskUserQuestion을 옵션과 함께 사용:
- "모든 스타일에 그래픽 많이 (히어로 + 악센트 그래픽 + 일러스트레이션)"
- "모든 스타일에 그래픽 최소 (히어로 이미지만)"
- "디자인 스타일이 그래픽을 결정하도록 함" (권장)
- "스타일별로 직접 선택"
사용자가 마지막 옵션을 선택한 경우에만 스타일별로 질문합니다.
5단계: 프로젝트 설정
프로젝트 위치 확인
제안: 현재 작업 디렉토리의 designs/[project-name]/.
사용자에게 확인하거나 재정의하도록 요청합니다.
프로젝트 생성
mkdir -p [location]concept.md작성 — 템플릿은 concept-template.md를 참조하세요. 발견 단계 응답으로 채웁니다. 데이터가 있는 필드만 채우고, 정보가 없는 섹션은 생략합니다.git init를 실행하지 마세요 — 기존 저장소를 사용하세요. 프로젝트 문서를 현재 브랜치에 커밋합니다.
git add designs/[project-name]/concept.md
git commit -m "docs: initialize [project-name] design exploration"
프로젝트 구조
[repo-root]/
├── designs/[project-name]/
│ └── concept.md
├── design-system/pages/
│ ├── [style-1].md
│ └── [style-2].md
└── .worktrees/
├── [style-1-branch]/ # React + Vite + TypeScript 프로젝트
└── [style-2-branch]/
6단계: 병렬 구현
중요: 다수의 Task 도구 호출로 단일 메시지에서 모든 구현 에이전트를 생성하세요.
선택된 각 스타일에 대해 하나의 하위 에이전트를 생성합니다. 전체 프롬프트 템플릿은 implementation-prompt.md를 참조하세요. [absolute-path-to-repo-root] 를 실제 저장소 루트 경로로 바꾸어 하위 에이전트가 워크트리 간 참조를 해결할 수 있게 하세요.
각 하위 에이전트의 핵심 사항:
superpowers:using-git-worktrees를 사용하여.worktrees/[style-name]/에 워크트리 생성- React + Vite + TypeScript 프로젝트 생성:
npm create vite@latest . -- --template react-ts design-system/pages/[style-name].md에서 디자인 스펙 읽기Skill도구를 사용하여frontend-design,vercel-react-best-practices,copywriting,nano-banana-pro호출- 그래픽 선호도에 따라 이미지 생성
npm run build로 빌드하여 검증- 모든 변경 사항 커밋
7단계로 넘어가기 전에 모든 에이전트가 완료될 때까지 기다리세요.
7단계: 병렬 검증
중요: 다수의 Task 도구 호출로 단일 메시지에서 모든 검증 에이전트를 생성하세요.
각 구현에 대해 하나의 검증 하위 에이전트를 생성합니다. 전체 프롬프트 템플릿은 verification-prompt.md를 참조하세요. 포트를 순차적으로 할당 (5173, 5174, 5175, ...) 하고 [absolute-path-to-repo-root] 를 실제 경로로 바꾸세요.
검증 확인 사항:
- 개발 서버가 오류 없이 시작되는지
- 모든 URL/링크가 유효한지
- 이미지가 존재하고 올바르게 참조되는지
- 디자인 스펙 준수 여부 (색상, 타이포그래피, 레이아웃, 효과) — 1~10점
- 프로덕션 빌드 성공 여부
모두 완료된 후, 비교 요약을 표시:
스타일 1: [이름] — ✅ 모두 통과 — 디자인: 8.5/10
스타일 2: [이름] — ⚠️ 2개의 깨진 URL — 디자인: 9.0/10
스타일 3: [이름] — ❌ 빌드 실패 — 보고서 참조
결과를 바탕으로 가장 우수한 성능의 스타일을 추천합니다.
빠른 참조
| 단계 | 동작 | 주요 도구 |
|---|---|---|
| 1. 발견 | AskUserQuestion으로 맥락 수집 (최대 4개 배치) | AskUserQuestion |
| 2. 스타일 생성 | ui-ux-pro-max로 4개의 디자인 시스템 생성 | Skill |
| 3. 개선 | 사용자가 스타일을 선택할 때까지 반복 | AskUserQuestion |
| 4. 그래픽 | 선택된 스타일에 대한 그래픽 선호도 질문 | AskUserQuestion |
| 5. 프로젝트 설정 | concept.md 생성, 스캐폴딩 커밋 | Write, Bash |
| 6. 구현 | 스타일별로 병렬 하위 에이전트 생성 | Task |
| 7. 검증 | 병렬 검증 에이전트 생성, 비교 표시 | Task |
일반적인 실수
- 하위 에이전트에서 디자인 스펙 재생성 — 디자인 스펙은 2단계에서 생성됩니다. 하위 에이전트는 스펙을 읽기만 하고, ui-ux-pro-max를 다시 호출하지 않습니다.
- 순차적 하위 에이전트 생성 — 6단계와 7단계는 반드시 단일 메시지에서 다수의 Task 호출로 모든 에이전트를 생성해야 합니다. 절대 하나씩 생성하지 마세요.
- 그래픽 선호도 건너뛰기 — 구현 전에 항상 질문하세요. 추측하지 마세요.
- 워크트리에서
git add .사용 — node_modules, .env 또는 OS 파일이 커밋되지 않도록 특정 경로만 스테이징하세요. - 스타일 간 동일한 키워드 — 사용된 키워드를 추적하여 다양성을 보장하세요. 중복 키워드는 중복 디자인을 생성합니다.
오류 처리
| 오류 | 복구 |
|---|---|
ui-ux-pro-max 스크립트 실패 | 더 간단한 키워드로 재시도. 지속되면 스타일 키워드에서 디자인 시스템을 수동으로 생성. |
| 모든 스타일 거부됨 | 사용자에게 구체적인 방향을 물음: "무엇이 마음에 안 드셨나요? 색상? 레이아웃? 전반적인 느낌?" |
| 하위 에이전트 스킬을 찾을 수 없음 | 에이전트는 Skill 도구를 사용하여 호출해야 합니다. 스킬이 실제로 없으면 해당 개선 단계를 건너뛰고 기록하세요. |
| 구현 빌드 실패 | 워크트리에서 수정하고 빌드 재실행. 수정 불가능한 경우 문제 보고. |