Craft UI
레퍼런스 이미지 입력, 작동하는 레이아웃 출력 — 단, 제품과 요청이 이해된 후에만 가능합니다.
이 스킬이 해결하려는 문제: 무작위 섹션, 자리 표시자 카피, 기본 그라데이션, 빈 영역으로 구성된 그럴듯해 보이지만 내용이 없는 페이지가 만들어지는 것입니다. 이는 에이전트가 증거 대신 장르 관습에 따라 디자인할 때 발생합니다. 여기서 모든 구조적, 시각적 결정은 다음 세 가지 출처 중 하나로 추적 가능해야 합니다: 실제 운영 중인 제품, 사용자의 브리프, 또는 실제로 본 레퍼런스. 출처가 없으면 수집하거나 요청해야 합니다. 빈 공간을 기본값으로 채우지 마십시오.
불가침 규칙
- 설계 계약(Design Contract, 2단계) 전에 코드를 작성하지 마십시오. '빠른' 페이지도 예외는 아닙니다:
discovery: lite는 계약을 단축할 뿐, 제거하지 않습니다. 경제성은 라우터가 처리하며, 컨텍스트를 건너뛰는 방식으로 처리하지 않습니다. - 기본값보다 증거. 모든 토큰, 섹션, 카피 라인은 출처를 명시해야 합니다. "랜딩 페이지에 일반적인 것"은 출처가 아닙니다.
- 구조는 척추이지 뷔페가 아닙니다. 섹션은 방문자의 질문에 답하거나 브리프의 목표를 달성할 때만 존재합니다.
references/anti-ai-slop.md를 참조하세요. - 실제 콘텐츠. 제품명, 레이블, 데이터, 언어는 사이트/브리프에서 가져옵니다. 로렘 입숨, 가짜 로고, 조작된 지표, 사용자가 플레이스홀더를 승인하지 않은 이상 "Seu produto aqui"는 사용하지 마십시오.
- 사용자의 언어로 응답하고, 제품의 언어로 UI를 구축하십시오 (pt-BR 제품은 pt-BR 카피를 사용).
- 모든 섹션에 페이드-업 효과를 적용하는 대신, 하나의 기억에 남는 모션을 사용하십시오.
- 컴포넌트보다 토큰을 먼저. 색상, 반경, 서체, 간격, 그림자, 이징은 CSS 변수에 저장하고, 컴포넌트는 해당 변수만 읽습니다.
- 경제성은 결정 사항입니다. 라우터가 상세도(verbosity)와 실행할 스킬을 결정합니다. 적용되는 레퍼런스 섹션만 읽으십시오.
- 전문적인 품질 기준.
references/quality-bar.md는 완료의 정의입니다 — 콘텐츠, 시각적 충실도, 반응형, WCAG AA, 성능, 인계.terse모드에서는 자동으로 검사하며 절대 건너뛰지 않습니다.
워크플로우
0. 분류 (Triage, 메인 에이전트, 몇 초)
- 사용자의 요청을 그대로 캡처하고, URL, 첨부 파일, "não quero" 제약 조건, 상세도 힌트("só o código", "rápido", "me explica")를 기록합니다.
- 사용 가능한 도구를 확인합니다: 서브에이전트/Task 도구, 브라우저 또는 웹 페치, 로컬 저장소, 스킬/MCP 목록.
- 요청이 기존 파일에 대한 사소한 수정(색상 하나, 간격 값 하나)인 경우 라우터에 알립니다 —
discovery: lite로 설정될 수 있습니다. 새 페이지나 재디자인은 항상discovery: full을 받습니다. - 사용자가 기존 레이아웃이 "amador", "precisa melhorar", "conserta essa landing"이라고 말하거나 코드가 있는 라이브 사이트를 가리키는 경우,
references/polish-existing-site.md를 읽고 해당 경로를 따르십시오: 실제 코드베이스에 덧붙이는 방식으로 연마(polish)하고 재구축하지 마십시오. 파일을 건드리기 전에git status를 실행하십시오.
1. 세 가지 발견 에이전트 (병렬 실행)
서브에이전트 도구(OpenCode subagent, Claude Code Task/Agent, Codex spawn_agent, Cursor 백그라운드 에이전트)를 사용하십시오. 서브에이전트 도구가 없으면 메인 에이전트에서 세 가지 패스를 순차적으로 실행하고 각 패스에 해당 제목을 레이블로 붙이십시오. 발견 에이전트는 코드를 작성하지 않습니다.
| 에이전트 | 임무 | 계약에 제공하는 정보 |
|---|---|---|
| A — 프로덕션 사이트 분석가 | 프로덕션 환경의 사이트 이해: 제품, 대상, 실제 카피, 현재 구조, 브랜드 토큰, 제약 조건. | 사이트 컨텍스트 브리프 |
| B — 요청 및 레퍼런스 분석가 | 실제 요청을 해독하고, 실제로 본 레퍼런스에서만 스타일 DNA 추출; 레퍼런스가 없으면 검색. | 요청 브리프 + 스타일 DNA |
| C — 스킬 라우터 / 경제성 | 이번 실행에 필요한 최소한의 추가 스킬/도구를 선택하고 상세도 설정. | 라우팅 결정 |
전체 사양, 출력 스키마, 단어 예산: references/agents.md. 각 에이전트에 절대 스킬 루트 경로, 역할 사양, 사용자의 원시 요청, URL/첨부 파일을 전달하십시오. 반환값을 단어 예산 이내로 제한하십시오.
레퍼런스 이미지가 포함된 경우, references/pattern-transfer.md도 읽으십시오. 스타일 토큰은 이동하지만, 구성 레시피는 그렇지 않습니다. 레퍼런스만을 근거로 히어로나 섹션 패턴을 절대 채택하지 마십시오 — 제품(A)과 요청(B)에 의해 정당화되어야 합니다.
2. 설계 계약 — 하드 게이트
references/design-contract.md를 읽으십시오. A + B + C를 하나의 계약으로 병합합니다. 그런 다음 다음을 확인하십시오:
- 구조적 척추(spine)가 정렬되어 있고, 각 섹션은 역할, 출처, 레퍼런스에서 문자 그대로 복사된 토폴로지, 실제 콘텐츠를 가지며, 빈 영역이 없습니다.
- 모든 토큰과 카피 라인은 출처를 인용하며, 알 수 없는 것은 표시되고 발명되지 않습니다.
- 에이전트/사이트/레퍼런스 간 충돌은 사용자에게 하나의 통합된 질문(최대 3개 항목)을 통해 해결되었으며, 추측하지 않았습니다.
- 상세도와 스킬 목록은 C에서 오며, "존재한다는 이유만으로" 스킬을 실행하지 않습니다.
- 패턴 채택 원장(ledger)이 있습니다: 모든
채택/적응/폐기는 A와 B를 인용합니다; 레퍼런스만으로 히어로/섹션 레시피를 가져오지 않았습니다 (references/pattern-transfer.md참조). - 구성이 관련 없는 다른 분야의 제품에 대해 그럴듯하지 않습니다. 토큰은 이식 가능하지만, 히어로 레시피는 그렇지 않습니다.
발견 하위 에이전트는 사용자에게 절대 질문하지 않습니다 — 격차(Gaps) / 알 수 없음(Unknowns)만 보고합니다. 메인 에이전트는 세 가지 브리프를 모두 수집하고, 하나의 통합된 질문(최대 3개 항목)을 한 후 답변을 받을 때까지 게이트를 닫아둡니다. 중요한 사실(제품명, 대상, 실제 콘텐츠, 레퍼런스 이미지)이 아직 알려지지 않은 경우, 질문하고 중단하십시오. 3단계를 시작하지 마십시오.
3. 계획
간결한 계획: 토큰, 스파인의 ASCII 와이어프레임, 실제 카피/데이터 뱅크, 하나의 모션 순간(트리거와 이유 포함). 레퍼런스 및 사이트 브리프와 비교하십시오; 관찰된 것이 아닌 기본값인 것은 수정하거나 제거하십시오.
4. 빌드
- 기본적으로 하나의 자체 포함된 HTML 파일(CSS 변수(토큰 역할), 실제 대체 폰트가 있는 Google Fonts). 사용자의 프로젝트가 이미 React/Tailwind를 사용하는 경우에만 기존 프로젝트 구조를 사용하십시오.
- 모션 레시피:
references/motion-and-effects.md. 고정된 cdnjs 버전의 GSAP 사용. - 코드는 간결하게 유지: 레이아웃에 필요하지 않은 라이브러리나 추상화는 사용하지 마십시오.
- 1440 / 768 / 390에서 반응형, 가시적인 포커스 상태,
prefers-reduced-motion존중. - 빌드하는 동안
references/anti-ai-slop.md를 다시 읽으십시오 — 특히 빈 영역(empty-band)과 섹션 뷔페(section-buffet) 행을 주의하십시오.
5. 시각적 검증
렌더링하고 레퍼런스 및 사이트 브리프와 나란히 비교하십시오. 가능한 경우 브라우저 도구를 사용하십시오(C가 라우팅). references/quality-bar.md의 검증 프로토콜을 실행하십시오: 1440 / 768 / 390에서 전체 페이지 스크린샷, 섹션 순서 및 콘텐츠 존재 여부, 빈 영역이나 잘린 텍스트 없음, 가로 스크롤 없음, 실제 픽셀 대비, 키보드 포커스, 축소 모션, 콘솔 오류. 계층 구조, 간격 리듬, 반경/그림자 일관성, 밀도, 언어를 확인하십시오. 수정 라운드: 상세도가 terse일 때 1회, full일 때 최대 3회; 가장 큰 시각적 차이점부터 먼저 수정하고 체크리스트가 통과하면 중단하십시오.
6. 응답
C의 상세도에 따라 형식을 지정합니다. terse: 3–5줄 — 무엇이 구축되었는지, 사용된 증거, 검증 결과. full: 또한 어떤 레퍼런스 특성이 어디에서 왔는지, 사용/생략된 스킬, 제안된 다음 변경 사항 하나를 나열합니다. references/quality-bar.md의 인계 기준을 따르고, 알려진 제한 사항을 한 번 명시한 후 항상 사용자의 언어로 작성하십시오.
다른 스킬 사용
에이전트 C가 실행별로 결정하며, 먼저 세션에서 실제로 사용 가능한 스킬을 확인하십시오. 스킬이 없는 경우 → 대체 방안을 사용하고 마지막에 한 번 언급하십시오.
| 단계 | C가 사용을 결정한 경우 | 대체 방안 |
|---|---|---|
| 계획/디자인 방향 | Impeccable (/impeccable shape, 이후 craft); 세션당 한 번 컨텍스트 단계 실행 | frontend-design 또는 3단계 계획 |
| 리뷰 및 연마 | Impeccable critique, polish, audit | 계약에 대한 자체 리뷰 |
| 모션 품질 | emil-design-eng (이징, 지속 시간, 스프링, 호버/프레스용) | references/motion-and-effects.md |
| 시각적 검증 | Browser MCP (Chrome DevTools / Claude in Chrome / developer-mcp-chrome): 3가지 너비에서 스크린샷, 콘솔 확인 | 검사 내용을 설명하고 사용자에게 스크린샷 요청 |
| 3D 로고 또는 객체 | img2threejs (레퍼런스에 재구축할 가치가 있는 3D 객체가 있는 경우에만; 한계 명시: 하나의 이미지는 숨겨진 측면을 드러낼 수 없음) | 평면 SVG 또는 CSS |
| 코드 크기 유지 | ponytail (종속성 추가 전) | 일반 CSS + 하나의 GSAP 타임라인 |
해당 단계에 적용될 때만 스킬을 호출하십시오. 정적 랜딩 페이지에는 img2threejs가 필요하지 않습니다.
독창성과 안전성
- 패턴을 재현하되, 자산은 재사용하지 마십시오. 레퍼런스의 로고, 일러스트레이션, 브랜드 이름, 정확한 카피를 절대 재사용하지 마십시오. 사용자의 브랜드와 A/B의 실제 콘텐츠를 사용하십시오.
- 많은 핀이 상업용 UI 키트로 연결됩니다. 스타일과 구조만 일치시키십시오.
- 레퍼런스의 외관은 시작점일 뿐입니다. 사용성을 해친다면(낮은 대비, 작은 글씨체), 분위기는 유지하고 문제를 해결한 후 그렇게 명시하십시오.
파일
references/agents.md— 세 가지 발견 에이전트, 스키마 및 예산.references/design-contract.md— 병합 템플릿 및 하드 게이트.references/anti-ai-slop.md— 일반적이고, 쌓아올리기만 하며, 내용이 없는 레이아웃의 증상과 해결책.references/quality-bar.md— 전문적인 완료 정의 및 검증 프로토콜.references/pattern-transfer.md— 레퍼런스 이미지가 동일한 히어로 레시피를 관련 없는 제품에 이식하는 것을 방지.references/polish-existing-site.md— 기존 프로덕션 레이아웃을 개선해야 할 때의 추가 워크플로우.references/categories.md— 장르 기준(섹션 메뉴가 아닌 최소 실행 가능성).references/style-dna.md— 레퍼런스 읽기 템플릿; 증거 필요.references/motion-and-effects.md— CSS 효과 및 GSAP 레시피.assets/refs.json— 알려진 레퍼런스 링크 (여전히 시청 필요).