Communitygithub.com

prototype-first

설계 옵션을 프로토타입으로 보여주고, 실제 개발에 들어가기 전에 선택을 받으세요. 새로운 화면, 새로운 흐름, 리디자인, 웹사이트나 랜딩 페이지, '옵션을 보여줘' 또는 '프로토타입 가능해?' 같은 요청, 그리고 합리적인 답변이 두 개 이상인 UX 질문에 사용합니다. 선택된 프로토타입으로부터 개발하는 방법도 다룹니다.

prototype-first란 무엇인가요?

이 스킬은 코드를 작성하기 전에 디자인 결정을 내리기 위해 설계된 '프로토타입 우선' 워크플로우를 정의합니다. 디자이너(또는 제품 관리자)가 여러 디자인 방향을 시각적으로 비교하고 선택할 수 있도록 하여, 잘못된 것을 구축하는 데 드는 비용(여러 개의 PR과 리뷰 시간)을 절약합니다. 주요 플랫폼(Claude Code, Cursor 등)에서 사용할 수 있으며, HTML 파일이나 임시 브랜치를 통해 프로토타입을 생성하고, 선택지를 명확히 제시한 후 사용자의 선택을 기다립니다. 워크플로우는 참고 자료 수집, 2~4개의 변형 제작, 선택 제시 및 중지, 선택 해석, 선택된 디자인 구축의 5단계로 구성됩니다. 프로토타입은 PR을 열지 않고, 레이블이 코드에 침투하지 않으며, 선택된 프로토타입이 최종 사양이 되는 엄격한 규칙을 따릅니다. 최종 출력 형식은 표 형태로 각 변형의 핵심 아이디어와 트레이드오프를 요약합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xa3k5/skills/tree/main/skills/prototype-first

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

프로토타입 우선

저는 디자이너입니다. 작업을 계획서를 읽어서 평가하지 않고, 보고 클릭해보면서 평가합니다. 프로토타입 하나는 몇 분이면 만들 수 있습니다. 잘못된 것을 구축하는 것은 수많은 PR과 하루 종일의 리뷰를 낭비하는 것입니다.

이 스킬은 한 가지 일을 합니다: 코드가 작성되기 전에 저로부터 디자인 선택을 받아내는 것입니다. 프로토타입을 위해 PR을 열지 않으며, 프로토타입을 제품으로 출시하지 않고, 제가 선택하지 않은 방향으로 절대 구축하지 않습니다.

엄격한 규칙

  1. 프로토타입을 위해 PR을 열지 마세요. 초안도 안 됩니다. PR은 main 브랜치에 병합될 코드를 위한 것입니다. 프로토타입 PR은 버려질 것에 리뷰와 CI 노이즈를 추가할 뿐입니다.
  2. 매 라운드마다 멈추세요. 아래 형식으로 변형들을 보내고 제 답변을 기다리세요. 제가 살펴보는 동안 '가장 유력한 선택'을 구축하기 시작하지 마세요. 제가 다른 것을 선택하면 그 작업은 낭비가 되고, 어차피 제가 검토해야 합니다.
  3. 선택된 프로토타입이 사양입니다. 최종 빌드는 그 프로토타입과 같아야 합니다. 이후 피드백은 제가 명명한 것만 변경합니다. 저는 빌드를 제가 선택한 사진과 비교하기 때문에, 어떤 차이든 실수로 읽히지 개선으로 읽히지 않습니다.
  4. 프로토타입 레이블은 프로토타입 파일에 남깁니다. "B2", "방향 A", 변형 별명은 코드, 토큰, 커밋, PR, 이슈에 절대 나타나지 않습니다. 선택 과정에서만 의미가 있었습니다. 코드베이스에서는 나중에 누군가 디코딩해야 하는 노이즈일 뿐입니다.
  5. 참고 자료는 이미지로 보세요. 제가 참고 사이트나 앱을 언급하면, 해당 사이트나 앱의 스크린샷을 보세요. 텍스트 전용 조회는 참고 자료를 좋게 만든 모든 시각적 특성을 잃어버리며, 결과는 평범하게 읽힙니다.

이것이 프로토타입이어야 하나요?

변경 사항에 명백한 답이 하나 있는가 (간격 값, 레이블, 색상 토큰)?
├── 예 → 빌드하고 무엇이 변경되었는지 말하세요. 프로토타입을 건너뛰는 것은 좋은 결과입니다.
└── 아니오
    ├── 새 화면, 새 흐름, 리디자인, 또는 2개 이상의 합리적인 답변이 있는가?
    │   └── 예 → 프로토타입.
    │       ├── 실제 데이터, 실제 내비게이션 또는 네이티브 동작이 필요한가?
    │       │   └── 예 → main에서 분기된 임시 브랜치 `proto/<주제>`
    │       └── 아니오 → 독립형 HTML 파일, 채팅 또는 이슈 스레드에서 공유
    └── 확실하지 않음 → 한 줄로 물어보세요: "이것 프로토타입으로 할까요, 아니면 그냥 빌드할까요?"

프로토타입을 /lab 경로나 개발 플래그 뒤에 제품 내부에 숨기지 마세요.

워크플로우

1단계: 참고 자료와 질문

  1. 제가 언급한 모든 참고 자료의 스크린샷을 수집하세요. 긴 페이지는 섹션으로 나누세요.
  2. 각각에 대해 구체적인 관찰 내용을 작성하세요: 유형, 제목 처리 방식, 제품이 어떻게 보여지는지, 레이아웃 구조, 그리고 눈에 띄는 한 가지 순간. 각각이 왜 효과적인지 말하세요.
  3. 요청에 의문을 제기하세요. 제가 요청한 것이 약한 UX라면, 그렇게 말하고 이유를 말하세요. 최종 사용자 입장에서 생각하세요. 제가 설명한 문자 그대로의 수정이 아니라.
  4. 추론할 수 없는 몇 가지 짧고 번호가 매겨진 질문을 하세요. 예: 유형, 밀도, 톤, 현재 버전에서 유지할 것.

완료 조건: 모든 참고 자료에 대해 작성된 관찰 내용이 있고, 제가 당신의 질문에 답변했거나 질문이 없어야 합니다.

2단계: 변형 구축

  • 2~4개의 변형을 보여주세요. A, B, C, D로 레이블을 붙이세요. 하나의 변형으로는 제 취향에 대해 아무것도 배울 수 없습니다. 4개를 초과하면 노이즈입니다.
  • 적어도 하나의 변형은 당신 자신의 더 나은 아이디어여야 합니다. 1단계에서 반대 의견을 제시했다면, 제가 요청한 변형 옆에 배치하세요.
  • 맥락 안에서 목업을 만드세요. 빈 페이지에 떠 있는 컴포넌트가 아니라 전체 창이나 섹션을 보여주세요.
  • 실제 디자인을 사용하세요. 앱의 현재 토큰, 유형, 컴포넌트를 사용하세요. 앱에 두 모드가 모두 있다면 라이트 모드와 다크 모드를 보여주세요.
  • 실제와 같은 데이터를 사용하세요. 실제처럼 보이는 이름, 숫자, 텍스트 길이. 절대 로렘 입숨을 사용하지 말고, 절대 실제 사람이나 장소의 데이터를 사용하지 마세요.
  • 흐름을 클릭 가능하게 만드세요. 단계나 상태가 있는 모든 것에 대해 시나리오 전환기, 라이트/다크 토글, 작동하는 상호작용, 각 상태가 의미하는 바에 대한 평문 설명이 있는 하나의 HTML 파일을 만드세요.
  • 질문에 맞게 완성도를 조정하세요. 시각적 방향의 경우 완성된 제품처럼 보여야 합니다. 외형이 제가 평가하는 것이기 때문입니다. 흐름의 경우 앱처럼 보이고 작동해야 하며, 마무리 작업은 기다릴 수 있습니다. 제가 길을 잃는지 여부를 평가하기 때문입니다.

완료 조건: 모든 변형이 실제 토큰과 실제 데이터로 맥락 안에서 목업되었고, 모든 흐름이 클릭 가능해야 합니다.

3단계: 라운드 전송 및 중지

"필수 출력 형식" 아래의 형식으로 라운드를 보내세요. 그런 다음 멈추세요.

완료 조건: 라운드가 전송되었습니다. 제가 답변할 때까지 아무 일도 일어나지 않습니다.

4단계: 내 선택 읽기

제가 말한 것의미당신이 할 일
"C"보여진 대로 C를 구축5단계로 이동
"D, 하지만 3px가 아닌 1.5px"정확히 그 변경 사항이 적용된 D그 부분만 변경하고 5단계로 이동
"A의 버튼들, C의 검색창"혼합각 명명된 부분을 내가 명명한 변형에서 가져옴. 내가 가장 마음에 든다고 말한 부분이 우선함. 구축하기 더 쉬운 변형 쪽으로 표류하지 마세요.
"B가 마음에 드는데 테스트해보고 싶어"잠정적 선택B를 구축하고, 실제 앱이나 기기에서 B를 시험해볼 때까지 차순위 변형을 유지하세요
하나의 변형에 대한 피드백반복해당 변형만 다음 라운드로 보여주고, 3단계로 돌아가기
"이 프로토타입을 모르겠어"프로토타입 중단PR로 실제 제품을 구축
"이것들 중 아무것도 아니야"당신이 내 의도를 놓침참고 자료와 내 말로 돌아가세요. 같은 아이디어의 네 번째 버전을 만들지 마세요.

제가 이유를 말하지 않으면 이유를 물으세요. 제가 이유 없이 선택하면, 한 가지 짧은 질문을 하세요: "왜 B가 이겼나요?" 결정과 함께 제 답변을 기록하세요. 이유 없는 선택은 다음 에이전트에게 제 취향에 대해 아무것도 가르쳐주지 않습니다.

완료 조건: 어떤 변형(또는 어떤 부분의 혼합)을 구축할지, 그리고 그 이유를 알게 되었습니다.

5단계: 선택된 것으로 구축

  • 구축하는 사람에게 프로토타입 링크와 정확한 값(색상, 크기, 간격, 유형)을 전달하세요. 아무도 기억에 의존하여 재구축하지 않습니다.
  • 디자인을 그것이 무엇인지로 설명하세요("조밀한 테이블, 상태 표시줄, 왼쪽 레일"), 절대 레이블로 설명하지 마세요.
  • 이후의 일반적인 피드백("너무 복잡함", "계층 구조 없음")은 제가 지적한 곳에만 적용하세요. 그것은 제가 프로토타입에서 마음에 들어한 것을 제거할 권한이 아닙니다. 프로토타입 요소를 삭제하거나 변경하기 전에 이름을 명시하고 물어보세요.

완료 조건: 빌드가 선택된 것과 일치하고, 프로토타입 레이블이 코드, 커밋, PR, 이슈에 나타나지 않습니다.

필수 출력 형식

모든 라운드는 다음과 같아야 합니다:

**확인할 위치:** <링크 또는 첨부 파일>, 또는 `git checkout proto/<주제> && <실행 명령어>`

| 변형 | 핵심 아이디어 | 트레이드오프 |
| --- | --- | --- |
| A | <한 줄: 이 변형이 테스트하는 아이디어> | <포기하는 것> |
| B | ... | ... |

**제가 반대한 점:** <한두 줄, 또는 "없음">

문자(A, B 등), 혼합(`A의 x, C의 y`), 또는 `없음`으로 답변하세요.

이 형식을 유지하세요. 프로토타입이 설명을 담당합니다.

호출 변형

호출동작
/prototype-first1단계부터 전체 워크플로우, 3단계 후 중지
/prototype-first <변형>마지막 라운드의 하나의 변형을 반복하고, 3단계로 돌아가기
/prototype-first compare현재 UI에 대해 NOW / PROPOSED 토글이 있는 하나의 프로토타입

관련 스킬