디자인 설정은(는) 무엇을 하나요?
개요
첫 화면을 그리기 전에, 제품이 무엇인지, 누구를 위한 것인지, 어떻게 느껴져야 하는지, 절대 어떤 모습이 되어서는 안 되는지 합의하세요. 이를 DESIGN.md에 기록합니다. 이 문서는 이후 모든 디자인 결정이 가장 먼저 참조하는 브리프입니다. 묻고, 만들어내지 마세요: 에이전트가 지어낸 브랜드는 사용자가 되돌려야 할 추측일 뿐입니다. 기존 자료를 읽고, 사용자와 한 번에 하나의 질문씩 인터뷰하며, 브리프를 작성하고 승인을 받은 후에 기초를 구축하세요.
사용 시기
- 디자인 작업이고 프로젝트 루트에
DESIGN.md가 없을 때 - "디자인 설정", "우리 스타일 / 브랜드 / 가이드라인 정의",
/craft-setup(/craft:craft-setupin the Claude Code 플러그인) 명령을 받았을 때
사용하지 말아야 할 때
DESIGN.md가 존재하고 작업이 디자인인 경우:craft사용- 하나의 토큰이나 가이드라인만 변경하는 경우:
craft-system사용
단계
- 먼저 읽습니다. README, 문서, 기존 CSS 또는 토큰, 디자인 파일, 브랜드 폴더, 오래된
DESIGN.md초안을 읽습니다. 이미 답변된 내용을 기록합니다. 코드에 이미 디자인 시스템이 있는 경우 (UI 패키지, 토큰 파일, 컴포넌트 라이브러리), 그 사실과 개수를 말하고 브리프의 브랜드 섹션에 "디자인 시스템 출처:<path>"라고 기록합니다. 6단계에서는 기초를 생성하는 대신 디자인 도구로 가져오기를 제안하며, 해당 질문들은 건너뜁니다. 두 개의 UI 패키지 → 브랜드 질문을 건너뛰기 전에 어떤 것이 출처인지 물어보세요. 파일이 이미 답변한 질문은 절대 묻지 마세요. 대신 한 줄로 확인합니다 ("README에 pt-BR 전용이며 60세 이상 회원이라고 나와 있어서, 18px 텍스트와 48px 터치 영역으로 디자인하겠습니다."). - 인터뷰, 한 번에 하나의 질문씩. 인터뷰 순서를 따르세요: 제품, 대상 사용자 및 목소리, 분위기, 브랜드, 참고 자료, 제약 조건.
- 가능할 때마다 3~5개의 옵션과 "다른 것"을 함께 제시하세요.
- 이미 답변된 질문은 건너뜁니다.
- 첫 화면을 디자인하기에 충분한 답변이 모이면 중단합니다. 좋은 답변 6개가 15개보다 낫습니다.
- 참고 자료는 필수입니다. 사용자가 좋아하는 2~5개의 제품, 사이트 또는 이미지를 요청하세요. 각각에 대해 무엇을 가져오고 무엇을 피할지 물어보세요. 링크나 열어볼 수 있는 이미지라면, 질문하기 전에 보고 무엇이 보이는지 말하세요.
DESIGN.md를 프로젝트 루트에 작성합니다. 템플릿을 사용하여 여덟 개의 섹션(제품, 대상 사용자 및 목소리, 분위기, 브랜드, 참고 자료, 제약 조건, 결정 로그, 미해결 질문)을 모두 포함하세요.- 가능한 사용자의 표현을 사용하세요.
- 추론했지만 사용자가 확인하지 않은 내용은 사실로 브리프에 넣지 말고 미해결 질문으로 기록하세요.
- 멈추고 사용자에게
DESIGN.md를 보여줍니다. 사용자가 승인할 때까지 수정합니다. - 기초 구축.
- 코드에 이미 디자인 시스템이 있는 경우: 가져오기를 제안합니다. 승인 시, 필수 하위 스킬:
craft-sync(가져오기). 인벤토리를 보여주고 어떤 컴포넌트를 그릴지 묻습니다. 거절 시, 결정 로그에 "<날짜> — <도구>로 가져오기 거절됨"을 기록합니다. "건너뛰기" 후에도 제안하세요: 브리프가 아니라 디자인 도구에 관한 것입니다. - 코드에 시스템이 없는 경우: 필수 하위 스킬:
craft-system을 생성 모드로 사용하여 기초(토큰, 타이포그래피, 간격, 상호작용 규칙)를 만듭니다. 자체 승인 중단이 있습니다. - 기존 토큰과 스타일은 시작점입니다. 허락 없이 이름을 바꾸거나 이동하지 말고 확장하세요.
- 코드에 이미 디자인 시스템이 있는 경우: 가져오기를 제안합니다. 승인 시, 필수 하위 스킬:
사용자가 "건너뛰기" 또는 "그냥 디자인해요"라고 말하는 경우
계속 묻지 마세요. 읽은 내용과 사용자가 말한 내용을 바탕으로 최소한의 DESIGN.md를 작성합니다:
- 모든 빈칸은 미해결 질문이 됩니다.
- 모든 가정에는 "(가정됨)"이라고 표시합니다.
가장 중요한 가정을 한 줄로 말하세요. "건너뛰기"는 인터뷰와 브리프 승인 중단을 면제하지만, 6단계는 면제하지 않습니다:
- 코드에 디자인 시스템이 있는 경우 → 여전히 가져오기 질문 한 번을 묻습니다 ("<도구>로 지금 가져올까요? 어떤 컴포넌트가 있는지 보여드리고 고르실 수 있습니다"). 그런 다음 계속 진행합니다.
- 토큰이 아직 없는 경우 → 기초 단계와 그 중단은 여전히 실행됩니다.
craft는 시스템 조각 없이는 그릴 수 없기 때문입니다.
그런 다음 요청받은 작업을 계속합니다.
시작하기 전에
references/adapters/에 도구에 맞는 어댑터가 없으면, 도구에서 동일한 동작을 수행하고 어떤 것을 수동으로 매핑했는지 말하세요. 디자인 도구가 전혀 없으면 HTML(html.md)로 구축합니다. 이미지만 있는 경우, 이미지에서 읽은 값은 추정치임을 말하세요.DESIGN.md는 모든 도구에서 저장소의 일반 마크다운 파일입니다. 선택적 참고 자료 보드만 디자인 도구에 있습니다.
규칙
| 규칙 | 이유 |
|---|---|
| 한 번에 하나의 질문, 옵션과 함께 | 질문이 많으면 대충 훑어보고 반만 답합니다 |
| 묻기 전에 읽고, 파일이 말하는 내용은 절대 묻지 않음 | README에 있는 내용을 묻는 것은 읽지 않았다는 뜻입니다 |
| 만들어진 브랜드 금지: 색상, 글꼴, 분위기는 사용자에게서 얻거나 "(가정됨)"으로 표시 | 만들어진 브랜드는 화면마다 되돌려야 할 추측입니다 |
| 참고 자료에는 항상 가져올 것/피할 것이 함께 제공 | "Stripe가 마음에 들어요"는 무용지물입니다. "차분한 간격은 가져오고 그라데이션은 피하세요"가 규칙입니다 |
| "절대 싫은 것"은 명시적으로 물어볼 것 | 피할 것을 아는 것이 목표보다 디자인을 더 빨리 좁힙니다 |
| 설정 중에 기존 파일을 재설계하지 않음 | 설정은 결정을 기록합니다. CSS 변경은 아직 요청되지 않은 디자인 작업입니다 |
| 설정 중에 화면을 만들지 않음 | 화면은 브리프와 기초가 승인된 후 craft가 만듭니다 |
완료 조건
DESIGN.md가 여덟 개의 섹션으로 승인되고, 기초가 확정되었을 때: craft-system을 통해 생성 및 승인되거나, (코드에 시스템이 있는 경우) craft-sync를 통해 가져오거나 가져오기가 거절되고 기록되었을 때. "건너뛰기" 후에는: DESIGN.md에 가정이 표시되어 작성되고, 기초가 존재하며(승인되었거나 이미 프로젝트에 있음), 원래 작업이 계속되었을 때.
흔한 실수
| 생각 | 현실 |
|---|---|
| "예쁜 팔레트와 글꼴을 고르면 사용자가 바꿀 수 있어" | 사용자는 결정된 사실을 몰랐으면 바꿀 수 없습니다. 물어보거나 "(가정됨)"으로 표시하세요. |
| "여기 있는 김에 메인 화면 몇 개를 모형으로 만들자" | 그것은 승인 후 craft의 역할입니다. 설정은 브리프와 기초에서 끝납니다. |
| "시간 절약을 위해 여섯 질문을 한 번에 물어보자" | 한 번에 하나씩, 옵션과 함께. 사용자가 답변하기 더 빠릅니다. |
| "토큰이 지저분하니 재구성하겠습니다" | 확장하세요. 재구성은 별도로 승인된 변경입니다. |
| "참고 자료가 없으니 그 섹션을 건너뛰자" | 요청하세요. 사용자에게 없으면 분위기에 맞는 세 가지를 제시하고 각각에서 무엇을 가져오고 피할지 물어보세요. |