Fresh eyes
화면을 사용할 사람을 위해, 그 사람이 수행할 작업과 보게 될 콘텐츠로부터 화면을 디자인하세요. 판단이 앞서고, 참고 자료는 이를 날카롭게 하며, 스크립트는 이를 확인합니다. 여기서 어떤 것도 상식보다 우선하지 않습니다: 화면이 혼란스러운데 어떤 규칙도 그 이유를 설명하지 못한다면, 여전히 혼란스러운 것입니다.
<skill>는 이 스킬의 디렉토리입니다: ${CLAUDE_SKILL_DIR} (이것이 리터럴 변수로 표시되면, 이 파일이 읽힌 폴더를 사용하세요).
설정
스크립트는 Node 20 이상이 필요합니다. 스크립트가 설정이 필요하다고 말하면, 출력된 내용을 실행하세요: npm --prefix "<skill>" install 및/또는 node "<skill>/node_modules/playwright/cli.js" install chromium이며, 이는 어떤 폴더와 어떤 셸에서도 작동합니다.
스크립트를 여기서 실행할 수 없는 경우 (셸 없음, Node 없음, 브라우저 다운로드용 네트워크 없음), 중단하지 마세요: 세션에서 사용 가능한 브라우저 도구로 스크린샷을 찍거나, references/floor.md에 대해 코드를 한 줄씩 확인하고, 보고서에 렌더링 검사가 실행되지 않았다고 명시하세요. 코드만으로 수행된 시각적 검사를 보고하지 마십시오.
루프
생성 및 검토 모두에 사용하세요. 검토의 경우 먼저 references/review.md를 읽으세요: 그 단계들은 1단계부터 4단계를 대체하며, 개선된 버전은 요청자가 파일 변경을 요청하지 않는 한 원본 옆에 복사본으로 둡니다.
- 이해. 누가, 어떤 작업을 위해, 얼마나 자주, 어떤 기기에서, 어떤 실제 콘텐츠로 이 화면을 사용하는지 파악하세요.
DESIGN-CONTEXT.md파일이 있다면 읽으세요 (references/design-context.md). 없다면, 코드, 카피 및 요청 사항에서 추론하고 가정 사항을 기록하세요. 사용자를 먼저 인터뷰하기 위해 중단하지 마세요. - 스타일링 전에 결정. 만들기 전에, 작업 노트나 답변에 간략히 기록하세요: 이 화면의 단일 목적; 시선이 가장 먼저 닿아야 할 곳; 첫 화면이 데스크톱과 휴대폰에서 주요 결정을 위해 반드시 담아야 할 것; 나머지 모든 것의 순서; 단일 기본 동작; 생략할 것. 이 카테고리의 사용자들이 이미 좋아하는 제품 두세 개를 이름과 함께 적고, 그 구조를 따르며, 이 제품이 소유한 하나의 시그니처 움직임을 적으세요 (
references/modern.md). 이것이 당신의 의도이며, 6단계에서 이를 테스트합니다. - 먼저 단어를 작성. 실제 데이터에서 가져온, 사용자의 언어로 된 제목, 레이블, 버튼, 빈 상태 및 오류 상태 (
references/words.md). 숫자, 이름, 사용 후기, 트렌드를 절대 만들어 내지 마세요; 실제 데이터가 없으면, 보이는 플레이스홀더를 사용하세요. - 순서대로 구축: 구조, 다음 계층, 그 다음 장인 정신, 프로젝트 자체의 컴포넌트와 토큰을 사용하여 (React와 shadcn/ui의 경우
references/stacks/react-shadcn.md를 읽으세요). 새로운 시각적 시스템은node "<skill>/scripts/tokens.mjs" --accent "<hex>" --out <dir>에서 시작하며, 모든 색상 쌍을 확인합니다. - 렌더링하고 살펴보기. 앱의 경우, 개발 서버를 시작하고 URL을 전달하세요.
--out을 프로젝트 외부의 스크래치 폴더에 작성하세요:node "<skill>/scripts/render.mjs" <page.html | url> --out <dir>(설정이 필요하거나 실행할 수 없는 경우 설정 참조); 로그인 뒤에 있는 경우,--storage-state <file>을 추가하세요. 데스크톱 및 휴대폰, 라이트 및 다크 스크린샷을 저장하고, 측정 가능한 문제(대비, 포커스, 가로 스크롤, 작은 타겟, 경쟁하는 기본 버튼, 가장자리 줄무늬, 엠 대시)를 출력한 다음, "육안 확인" 목록을 출력합니다. 모든 문제를 수정하거나, 보고서에 하나가 남는 이유를 명시하세요; 검토는 바닥 문제, 줄무늬 및 엠 대시를 수정하고, 다른 측정된 징후들을 결과로 제시합니다. 라이트와 다크가 동일하게 보인다고 경고하면,--theme-mode class로 다시 실행하세요. 스크린샷, 특히 네 개의-first.png를 먼저 보고, 각 "육안 확인" 항목을 살펴보세요: 빈 목록은 바닥이 깨끗하다는 뜻이지 화면이 좋다는 뜻이 아닙니다. 스트레스 콘텐츠(가장 긴 실제 이름, 가장 큰 금액, 빈 계정)로 한 번 렌더링하세요. - 새로운 시각. 이 대화의 맥락이 전혀 없는 (포크가 아닌) 새로운 하위 에이전트를 시작하세요; 사용 가능한 경우
first-look에이전트 유형을 사용하세요. 전체 프롬프트:<skill>/agents/first-look.md를 읽고 따르세요. 작업: <한 문장>. 이미지: <절대 경로, 첫 화면 우선>. 다른 파일은 열지 마세요. 당신의 의도나 구축/변경한 내용에 대해 아무것도 추가하지 마세요. 그 답변을 2단계와 비교하세요: 잘못된 "이게 뭐지", 잘못된 첫 클릭, 망설임 또는 "이상함"은 수정 사항입니다; 이미 작동하는 페이지 검토에서, 작업을 막거나 오도하지 않는 망설임은 선택적 제안이지 수정 사항이 아닙니다. 하위 에이전트 없이, 첫 화면 이미지만 보고 코드를 다시 읽기 전에 직접 first-look 질문에 답하세요. - 수정하고 멈추기. 먼저 구조(레이블, 목록, 시각 자료, 재그룹화)로 각 망설임을 수정하세요; 다른 방법으로 해결할 수 없을 때만 문장을 추가하세요. 이름에 대한 의심은 그 아래 설명 줄이 아닌 더 나은 이름으로 해결되며, 메뉴 내에서는 절대 설명하지 않습니다. 5단계와 6단계를 최대 두 번 더 반복한 후, 여전히 열려 있는 문제를 명명하세요.
references/modern.md의 테스트 세 가지 질문(어떤 카테고리 제품이 이것을 현재형이라고 부를지; 시그니처가 어디에 있는지; 이것이 어떤 스타트업에 속할 수 있는지)에 답하고 보고하세요.
가장 간단한 경로를 먼저. 기본 동작은 화면이 열리는 순간 작동합니다; 추가 기능(모든 행 편집, 벌크 도구)은 한 단계 아래에 위치하며, 첫 화면을 방해하지 않습니다 (references/structure.md).
완성, 비어 있지 않음. 기계적 느낌을 피하는 것이 목표가 아닙니다. 화면은 완성된 제품처럼 보여야 합니다: 사람이 행동할 단위가 각자의 컨테이너 안에 있고, 의미를 전달하는 아이콘과 작은 시각 자료가 있으며, 전체 결정이 첫 화면에 있어야 합니다. 회색 문장의 넓은 열은 또한 실패입니다 (references/hierarchy.md).
요청에 맞게 확장. 단어만 (레이블, 오류 메시지): 13단계. 컴포넌트 또는 작은 수정: 15단계. 전체 화면 또는 검토: 7단계 전체.
대부분의 화면을 결정하는 질문들
| 질문 | 읽기 |
|---|---|
| 누가, 얼마나 자주, 어떤 작업을 위해 여기에 오는가? 얼마나 조밀해야 하는가(포스처)? 사물들은 어떻게 그룹화되고, 명명되며, 접근되는가? | references/structure.md |
| 시선이 가장 먼저 닿아야 할 곳은 어디인가? 정확히 하나의 기본 동작이 있는가? 모든 숫자에 비교 대상, 단위 및 날짜가 있는가? | references/hierarchy.md |
| 처음 사용자가 이것이 무엇인지, 자신이 어디에 있는지, 다음에 무엇을 해야 하는지 알 수 있는가? | references/clarity.md |
| 각 영역의 상태는 무엇이며, 정확히 하나의 상태인가? 누군가 잘못했을 때, 실행 취소 또는 확인을 하는가? | references/states.md |
| 단어가 사용자가 사용하는 방식으로 사물을 명명하는가? 각 오류가 해결 방법을 알려주는가? | references/words.md |
| 타입, 간격, 색상, 다크 모드 및 모션이 의도적인가? | references/craft.md |
| 완성된 것처럼 보이는가, 아니면 문서처럼 보이는가? 첫 화면이 결정을 담고 있는가? | references/hierarchy.md |
| 현재 시점처럼 보이면서 생성된 것처럼 보이지 않는가? 그것의 시그니처는 무엇인가? | references/modern.md |
| 이 화면이 어떤 제품에나 속할 수 있는가? 무엇을 제거할 수 있는가? | references/tells.md |
| 랜딩, 홈 또는 가격 페이지인가? 방문자가 무엇을 결정해야 하는가? | references/landing.md |
| 두 테마 모두에서 키보드, 대비, 리플로우, 이름, 타겟이 적절한가? | references/floor.md |
질문이 현재 보고 있는 화면에서 열려 있을 때만 참조를 읽고, 한 번에 모두 읽지 마세요. 각 카드에는 결정, 수행할 작업, 출처가 있는 이유, 찾아볼 것, 그리고 적용되지 않는 경우(단, 다음의 경우 제외)가 있습니다. 예외는 규칙만큼 중요합니다.
절대 변하지 않는 원칙
- 실제 콘텐츠만: 발명된 숫자, 사람, 인용문 또는 실적 없음.
- 접근성 바닥(
references/floor.md)은 라이트와 다크에서 모두 유지됩니다. - 요소의 한쪽 가장자리에 색상 줄무늬를 강조로 사용하지 않으며, 카피에 엠 대시를 사용하지 않습니다 (
references/tells.md). - 검토 시, 페이지에 있던 모든 데이터와 모든 동작을 유지하세요; 이동하거나 격하시킬 수는 있지만 제거하지는 마세요.
- "변경 불필요"는 사용자에게 아무런 비용이 들지 않을 때 완전한 검토입니다. 취향만을 위해 절대 변경하지 마세요.
보고서
평범한 단어로, 간결하게:
- 구축하거나 변경한 사항, 각각을 사용자의 작업 및 절약되는 시간과 연결하여 설명; 검토의 경우, 모든 변경 사항(크기, 간격, 색상 등 아주 작은 것까지)을 예를 들어 '이전, 이후, 사용자에게 절약되는 것'의 짧은 표 형태로 제시: 명명하지 않은 변경은 깨진 약속입니다;
- 가정한 사항, 최대 세 가지 항목, 그리고 가정이 틀렸을 때 변경될 사항;
- 확인한 사항: 수정 전후의 렌더링 문제, 그리고 새로운 시각 검토가 당신의 의도와 어떻게 비교되었는지;
- 테스트하지 않은 것 (제스처, 실제 휴대폰, Safari, 스크린 리더), 그리고 렌더링이 실행되었는지 여부.
점수, ID 또는 규칙 번호 없음. 프로젝트에 DESIGN-CONTEXT.md가 없으면, 당신의 가정을 바탕으로 하나 작성하겠다고 제안하세요.