Craft은(는) 무엇을 하나요?
개요
시각적인 모든 것을 만들기 위한 관문입니다. "가격 페이지 디자인"이라는 요청을 완성되고 검토된 디자인으로 바꿔줍니다. 프로젝트 브리프를 기반으로 작동하며, 모든 상태를 다루고, 방향이 명확하지 않을 때만 옵션을 제공하며, 디자인 시스템의 조각만 사용하고, 보여주기 전에 스스로 작업을 점검합니다. 고정된 시점에서 다른 디자인 스킬을 호출합니다. 그것들을 대체하지 않습니다.
사용 시기
- "<페이지, 화면, 흐름, 요소>를 디자인 / 생성 / 목업 / 리디자인 해줘",
/craft(/craft:craftin the Claude Code plugin). - 여러 페이지를 한 번에 ("온보딩 디자인: 환영, 가입, 확인").
사용하지 말아야 할 시기
- 사용자가 정확히 설명한 작은 수정(값 하나, 레이블 하나, 크기 하나): 그냥 실행하세요.
- 검토만 필요한 경우("이게 뭐가 문제야?"):
craft-critique. 옵션만 필요한 경우:craft-explore.
시작하기 전에
references/adapters/에 있는 어댑터 중 사용 중인 툴에 맞는 것이 없으면, 해당 툴에서 동일한 동사를 수행하고 수동으로 매핑했다고 말하세요. 디자인 툴이 전혀 없으면 HTML로 빌드하세요 (html.md). 이미지만 가지고 있다면, 이미지에서 읽은 값은 추정치라고 말하세요.
정지는 실제입니다
정지(stop) 란: 질문과 함께 당신의 차례를 끝내고 기다리는 것을 의미합니다. 원샷(one-shot) 또는 헤드리스(headless) 세션에서도 항상 그렇게 할 수 있습니다. 이 경우 당신의 최종 메시지가 바로 질문입니다. 세션이 "기다릴 수 없거나" "왕복을 줄이기 위해" 사용자를 대신해 정지를 결정하지 마십시오. 스스로 결정하면 5초짜리 답변이 몇 시간의 재작업으로 바뀝니다.
단계
- 컨텍스트.
- 프로젝트 루트의
DESIGN.md를 읽으세요. 파일이 없거나 Product 섹션이 없는 경우(동기 전용 기록) → 필수 하위 스킬:craft-setup, 그런 다음 여기로 돌아오세요. - 디자인 시스템(토큰, 컴포넌트, 가이드)과 현재 페이지와 관련된 화면들을 읽으세요.
- 브리프와 코드가 일치하지 않을 때(브리프는 청록색, 토큰은 파란색): 코드를 따르고, 한 줄로 설명한 다음,
DESIGN.md› 미해결 질문에 충돌을 추가하고, 어느 쪽이 잘못되었는지 업데이트하겠다고 제안하세요. 페이지 자체 CSS 내에서 토큰을 재정의하지 마십시오. - 디자인 툴 가이드와 코드가 다르고
design-sync.json이 존재하는 경우, 가이드를 오래된 것으로 간주하지 마세요. 함께 분류하세요: 코드 변경됨 → 그리기 전에 가이드를 새로고침하겠다고 제안하세요. 가이드 변경됨 → 사용자의 변경 사항이 내보내기를 기다리는 중이므로 가이드와 함께 그리고 보류 중인 내보내기를 언급하세요.
- 프로젝트 루트의
- 범위를 말로 표현. 만들 각 페이지 또는 요소를 나열하고, 각각의 역할과 다음 작업 하나를 명시하세요.
- 모호한 단어는 하나의 해석을 명확히 진술하세요 ("가격 페이지 = 빵집의 가격표, 구독 요금제 아님").
- 항목이 두 개 이상이거나 요청이 모호한 경우 목록을 확인하고 정지하세요. 명확한 항목 하나: 계속 진행하세요.
- 각 항목에 대해 순서대로:
- 필수 하위 스킬:
craft-states. 먼저 작성된 상태 목록과 정지가 옵니다. - 방향이 열려 있습니까? 사용자가 아이디어를 요청했거나, 브리프나 시스템이 선택하지 않은 두 가지 구조적으로 다른 레이아웃이 모두 타당한 경우에만 → 상태를 그리기 전에 필수 하위 스킬:
craft-explore. 여러 페이지의 경우, 범위 정지에서 어떤 페이지(있는 경우)에 옵션을 줄지 물어보세요. 기본적으로 페이지별로 옵션 라운드를 실행하지 마십시오. 그런 다음 선택된 방향으로 상태가 그려집니다. 기존 패턴을 따르는 화면은 바로 그리기로 넘어갑니다. - 그리기 – 기본 상태를 먼저, 그 다음 다른 상태를 그리세요. 시스템의 조각과 토큰만 사용하세요. 새로운 것(컴포넌트, 색상, 스케일에 없는 크기) → 사용하기 전에 필수 하위 스킬:
craft-system(추가 모드). 코드에는 존재하지만 툴에는 그려지지 않은 컴포넌트(인덱스에 "코드에만 있음") → 필수 하위 스킬:craft-sync(하나의 컴포넌트 가져오기), 먼저 해당 컴포넌트만 그리세요. 사용자가 가져오기를 거부한 경우(DESIGN.md참조), 가져오기 전에 한 번 물어보세요. 계속 거부하면 보드 자체에서 코드 값을 사용하여 빌드하고 메모하세요. 유사품을 그리지 말고, 페이지에 새 값을 하드코딩하지 마십시오. - 모든 보드에 대해 필수 하위 스킬:
craft-critique(자체 점검 모드) : 렌더링하고, 이 작업 범위 내에서 찾은 문제를 수정하고, 다시 렌더링하세요.
- 필수 하위 스킬:
- 마무리.
- 아래 요약과 함께 결과를 보여주세요.
- 결정 사항을
DESIGN.md› 결정 로그에 추가하세요 (날짜, 결정, 이유). - 답변된 질문은 미해결 질문에서 이동하세요.
마무리 요약 (최종 메시지의 형태)
만든 것: <페이지/요소> — <위치: 파일 또는 보드>
결정 사항: <각각, 이유와 함께 한 줄> (DESIGN.md › 결정 로그에도 있음)
시스템 변경 사항: <추가되거나 변경된 조각/토큰> — 영향: <화면>
자체 점검 수정 사항: <당신이 보기 전에 craft-critique이 변경한 것>
미해결 질문: <사용자가 아직 결정해야 할 사항>
규칙
| 규칙 | 이유 |
|---|---|
매번 DESIGN.md를 먼저 읽는다 | 브리프가 없으면 모든 화면이 제각각 스타일을 발명한다 |
| 항목이 둘 이상일 때는 작업 전에 범위 확인 | 잘못 읽고 세 페이지를 만들면 세 페이지가 낭비된다 |
그리기 전에 상태 목록 작성 (craft-states를 통해) | 해피 패스는 많은 상태 중 하나일 뿐이다 |
| 방향이 열려 있을 때만 옵션 제공 | 해결된 패턴에 옵션을 주면 사용자의 주의가 낭비된다 |
시스템 조각과 토큰만 사용. 새로운 것은 craft-system을 통해 | 페이지에 하드코딩된 값이 드리프트의 시작점이다 |
| 코드가 오래된 브리프보다 우선. 메모하고 덮어쓰지 않는다 | 토큰이 실제로 배송되는 것이고, 브리프는 결정에 의해 업데이트된다 |
| 보여주기 전에 자체 점검 | 사용자는 디자인을 검토해야지 실수를 잡아서는 안 된다 |
결정 사항은 DESIGN.md에 기록 | 다음 세션의 디자인이 기억이 아닌 여기서 시작된다 |
완료 조건
확인된 범위의 모든 항목에 대해 상태가 그려지고 자체 점검되었으며, 시스템 변경 사항이 craft-system을 거쳤고, 마무리 요약이 제공되었고, DESIGN.md의 결정 로그가 업데이트되었을 때.
일반적인 실수
| 생각 | 현실 |
|---|---|
| "세 페이지가 충분히 명확하니 그냥 만들자" | 먼저 목록을 확인하세요. 메시지 하나면 됩니다. |
| "여기서 버튼을 52px로 만들자. 토큰은 44라고 하지만 이 사용자층은 더 큰 것이 필요해" | 시스템 결정입니다. craft-system을 통해 제안한 다음 모든 곳에서 사용하세요. |
| "브리프가 청록색이라고 하니 이 페이지 CSS에서 파란색을 재정의하자" | 코드가 이깁니다. 충돌을 표시하고 질문하세요. 토큰을 로컬에서 패치하지 마세요. |
| "보여주면 그들이 뭐가 잘못됐는지 말해주겠지" | 먼저 craft-critique를 자체 점검 모드로 실행하고 무엇을 수정했는지 말하세요. |
| "결정 사항이 내 메시지에 있으니 충분해" | 메시지는 스크롤되어 사라집니다. DESIGN.md에 추가하세요. |
| "이 세션은 답변을 기다릴 수 없으니 내가 결정하고 목록으로 만들자" | 질문과 함께 당신의 차례를 끝내는 것이 정지입니다. 그렇게 하세요. 첫 번째 열린 정지 이후로는 아무것도 만들지 마세요. |
| "왕복을 줄이기 위해 두 정지를 하나의 메시지에 넣자" | 괜찮습니다. 그런 다음 정지하세요. 둘 다 질문하고, 아무것도 만들지 말고, 기다리세요. |