PRD → 모바일 앱 HTML 디자인 하네스 (/k-style-ui-ux:go, /k-style-ui-ux:max)

GitHub stars
406

Install

/plugin install k-style-ui-ux@k-style-ui-ux

Run it inside Claude Code after adding the marketplace with /plugin marketplace add vmc-inner-circle/k-style-ui-ux.

Contents

Discovered from source

Skills 2

k-style-ui-ux:go — 1차: 모든 흐름을 처음부터 끝까지

PRD 한 장 → (PRD 요구사항을 뺄 때만) 확인 한 번 → 15분 안에 완성된 디자인. 이 결과물은 그 자체로 완성품이다: 사용자가 만들거나 신청하는 모든 대상의 시작 → 보기 → 고치기 → 끝(결과) 화면, 실제 사진, 캔버스. 오류·확인·빈·진행 상태 화면은 max 스킬이 더한다(사용자가 원할 때).

사용자는 디자인을 모른다고 가정하고, 디자인·제품 결정은 하네스가 내리고 이유를 남긴다. 단, PRD에 적힌 것을 빼거나 가볍게 바꾸는 결정만은 만들기 전에 사용자에게 확인한다.

경로: 이 SKILL.md가 있는 폴더(<스킬 폴더> — Claude Code는 Base directory로 보여 준다)의 ../../core가 공용 폴더다. 맨 처음 한 번 SK=$(cd "<스킬 폴더>/../../core" && pwd -P)로 절대경로를 정하고, 모든 명령·서브에이전트 프롬프트에 그 절대경로를 쓴다. 산출물은 out/.

에이전트마다 다른 것 (이 하네스는 Claude Code·Codex·Cursor에서 돈다 — 차이는 여기에만 적는다):

  • "같은 메시지에서/한 메시지에" 띄운다 = 서브에이전트를 동시에 띄우고 모두 돌아올 때까지 같은 턴에서 기다린다는 뜻이다. Claude Code는 Agent 도구, Cursor는 Task 도구(서브에이전트) 여러 개를 한 응답에, Codex는 서브에이전트(multi-agent)를 연달아 띄운 뒤 결과를 기다린다. 서브에이전트를 쓸 수 없는 환경이면 같은 묶음을 메인이 순서대로 처리한다(시간은 늘어난다).
  • 모델 등급: "가벼운 모델" = Claude Code haiku, "중간 모델" = Claude Code sonnet. 모델을 고를 수 없으면 기본 모델로 띄운다.
  • 스킬 부르기: Claude Code는 /k-style-ui-ux:go·/k-style-ui-ux:max, Codex는 $k-style-ui-ux:go·$k-style-ui-ux:max, Cursor는 채팅에 /를 치고 go·max(또는 "k-style-ui-ux max로 …").

캔버스 의견 고치기 — 메시지가 [k-style-ui-ux 수정 요청]로 시작하면

새로 만들지 않는다. 아래 "진행"을 건너뛰고 $SK/references/feedback.md대로 적힌 화면의 그 요소만 고친 뒤 selfcheck.py·audit.py --shots·build_canvas.py를 다시 돌리고, 그 문서의 마지막 메시지 형식으로 끝낸다.

원칙

$SK/references/principles.md를 먼저 읽는다 — 모든 서브에이전트 프롬프트에 그 전문을 그대로 붙인다.

진행 — 보통 한 턴, PRD 요구사항을 뺄 때만 두 턴

첫 줄에 한 문장으로 알린다: "바로 만들게요. 15분쯤 걸려요."

1단계 — 동시에 시작 (목표 3분)

  • 맨 먼저(1초): python3 $SK/scripts/save_prd.py out — 붙여넣은 PRD 원문을 out/prd.md로 저장(파일로 받았으면 --from <파일>). 실패하면 그때만 직접 쓴다.
  • 이어서 바로(3초): PRD의 핵심 기능·갈등에서 키워드 3~4개를 뽑아 python3 $SK/scripts/market.py out "<키워드>" … — 같은 문제를 푸는 잘 되는 앱(평점 수 상위 5)의 스토어 화면·설명·리뷰를 out/market/에 모은다($SK/references/market.md 1절). 도메인 이름이 아니라 이 PRD의 말로.
  • 먼저 30초: PRD에서 도메인(예: 여행·생활·커머스·교육·결혼)과 제품 성격 키워드 3개를 정한다 — 키워드는 라이브러리 어휘에서 고른다: 따뜻함·감성·친근·활기·선명·강렬·밝음·산뜻·신뢰·차분·고급·모노·에디토리얼·생활·여행·자연·건강·기록·커뮤니티. 도메인은 구체적으로(예: "뷰티,헤어", "운동,예약") — 라이브러리에 맞는 도메인이 없으면 승인된 브랜드 시드에서 색을 만든다(자동). 그리고 감정 온도: 축하·결혼·선물·돌잔치처럼 설렘 자체가 제품의 핵심이면 warm, 금융·업무·의료처럼 믿음이 핵심이면 cool, 여행·생활·가족 일상처럼 둘 다 아니면 비운다(대부분 비운다).
  • 백그라운드로 즉시: python3 $SK/scripts/setup_out.py out --domain "<도메인>" --tags "<키워드,…>" [--temp warm|cool] [--gender 여성|남성] — --gender는 PRD에 타깃 성별이 적혀 있을 때만(짐작해서 넣지 않는다) — 공통 파일 복사 + 팔레트 라이브러리($SK/foundation/palettes/)에서 기본 1 + 대안 2 자동 결정. 사용자에게 색을 묻지 않는다.
  • 같은 메시지에서 서브에이전트 1개 — 시장 관례: $SK/references/market.md 2절 프롬프트로 out/market/에서 out/conventions.json을 뽑는다(2개 이상 앱에서 본 것만 관례).
  • 같은 메시지에서 서브에이전트 1개 — 명세 목록: $SK/references/spec-mode.md의 프롬프트로 out/prd.md에서 out/spec_inventory.json을 뽑는다(화면·단계·부딪히는 규칙 최대 20개, 항목마다 원문 인용).
  • 메인은 그동안 out/journey.md를 쓴다:
    • 사람 카드(맨 먼저 — 이 앱이 누구를 위한 것인가): PRD에 사용자 구분(유형·단계·페르소나)이 있으면 그 구분과 이름을 그대로 가져온다. 없으면 여정에서 서로 가장 다른 사람 2~3명. 사람마다 {누구(상황 한 줄 — 나이·국적·성별처럼 사진에 영향을 주는 특성 포함), 처음 오는 이유, 그때 마음(불안·막막함·호기심·자부심…), 알고 싶은 것 3~5개(그 사람이 앱을 열 때 머릿속에 있는 질문 — 기능 이름이 아니라 질문, 그리고 그 답이 보일 화면 id), 이 앱에서 성공한 순간, 주로 쓰는 화면 id}. 같은 앱이라도 목적이 다르면 알고 싶은 것이 다르다 — 예: 기록하러 온 사람은 "내 기록이 어떻게 쌓였나, 내가 어떻게 변했나", 남이 궁금해서 온 사람은 "나와 비슷한 사람은 누구고 어떻게 됐나, 나와 같은 시기를 지난 사람은 어땠나, 그 사람들은 무엇을 쓰나". 이 카드를 screens.json의 people에도 옮긴다. 핵심 사람(이 앱이 가장 먼저 붙잡아야 하는 사람) 하나를 정하고 이유를 가정 로그에.
    • 여정표: 시기(사용 전·중·후) × 사람 카드의 사람(모두 — 주인공 한 명만 따라가지 않는다) × {할 일, 궁금해지는 것, 막히는 순간}. 궁금한 것은 "물어보기 미안한 사소한 것"까지. 막히는 순간(아무도 답이 없음·마감이 지남·전부 안 됨·거절)은 그 순간을 푸는 화면이나 상태로 이어져야 한다.
    • 범위: 커버한다 / 커버하지 않는다(이유) / 경계(추천 결정). 사람 나누는 방식(권한).
    • 시나리오 데이터 표 + 사실 표: 등장인물·주요 항목 3~5개, 그리고 화면에 나올 모든 사실(날짜·시간·인원 수·누가 어디에 속하는지·무엇이 무엇과 겹치는지·각 대상의 상태 이름)을 한 표에. 모든 화면이 이 표만 인용한다(원칙 19). 숫자를 쓰는 제목("23명")은 표에서 센 값. 사람마다 아바타 파일도 이 표에 적는다 — 먼저 앱 전체 아바타 스타일 하나를 정하고($SK/foundation/assets/avatars/avatars.json의 styles: 실명이 신뢰의 핵심이면 photo, 익명 서비스면 animals, 아니면 성격에 맞춰 people·line·soft), 그 스타일의 files에서 성별·나이가 맞는 파일을 사람마다 하나씩(겹치지 않게). 고른 스타일과 이유는 가정 로그에.
    • 가정 로그: 하네스가 대신 정한 것과 이유(팔레트 선택 이유 포함 — out/palettes.json의 why).
  • 명세 목록이 오면 병합: 같은 화면의 탭·섹션으로 쪼개진 screen은 feature로 합친다. screen+step ≥ 15면 mode: "spec" — screen·step은 전부 화면이 된다(빼려면 1.5단계 결정 + 확인). 아니면 brief — 지금처럼 여정에서 화면을 끌어낸다. 흐름 고리(objects)를 먼저 채운다 — 대상마다 create(처음 만드는 시작점)·view·edit(고치기·지우기·취소)·after(끝: 그 행동의 결과 화면 — 완료 확인·바뀐 결과가 보이는 화면. 목록·상세로 대신하지 않는다)에 화면 id. after에는 결과 화면(kind: "result" 또는 <id>--done)이 하나 이상 있어야 한다(selfcheck). 빈 칸이 있으면 그 화면을 화면 목록에 추가한다(시작과 끝이 빠지는 것은 치명적이다). n/a는 edit에만, 이유와 함께. 이어서 각 항목의 covered_by(화면 id) 또는 decision을 채운다(요소 단위는 목록에 없다 — 빌드 에이전트가 PRD의 그 화면 절을 읽는다). rule은 target(화면 id)·state(error|confirm|done) 또는 policy(정책 문구로만 반영할 화면 id).
  • 화면 유형(screens.json 전에): $SK/references/screen-kinds.md를 읽고 home·detail·list 기본 화면마다 archetype을 정한다 — 기본값은 conventions.json의 archetypes.<종류>.majority, 없으면 그 문서의 판단 질문. majority와 다르게 고르면 그 화면에 archetype_why(이 앱의 core 때문인 이유).
  • 시장 관례 합치기(conventions.json이 오면, screens.json 전에): 탭 구성·온보딩 순서·홈 첫 블록·결제 흐름은 follow가 기본값 — 벗어나려면 이 앱의 core 때문이어야 하고 이유는 decisions.json에. consider(후킹 장치)는 1.5단계 후보로, avoid(리뷰 불만)는 해당 화면 정책으로. 리서치가 3분 안에 안 오면 기다리지 않는다(market.md 3절).
  • 이어서 out/screens.json:
{"groups": ["처음 들어올 때", "홈 — 시기마다 맨 위가 바뀐다", "…"],
 "story": {"headline": "이 앱이 PRD의 갈등을 푸는 방식 한 문장(<em>강조</em>)", "summary": "2~3문장",
           "ideas": [{"title": "", "desc": ""}]},
 "screens": [{"id": "home", "file": "screens/home.html", "title": "홈 · 출발 50일 전", "group": "…",
   "purpose": "한 줄", "role": "everyone|editor", "policies": ["화면 정책 1~3줄: 규칙·경계·엣지 케이스"],
   "branches": [{"to": "home-edit", "label": "갈래 조건"}],
   "traits": {"list_first_use": false, "form": false, "shares": false, "large_list": false, "long_task": false}, "kind": "home|list|detail|form|result|sheet", "over": "sheet일 때만: 아래 깔리는 화면 id",
   "archetype": "home·detail·list일 때: screen-kinds.md의 유형 이름(예: 찾기형·대상형·행 목록)"}],
 "promos": [{"name": "첫 예약 1만원 쿠폰", "until": "11월 30일", "source": "PRD F7"}],
 "photo_centric": false,
 "avatar_style": "people|line|soft|animals|photo — 사람 아바타를 쓰면 필수(assets/avatars/avatars.json)",
 "badges": {"확정": "is-brand", "바뀜": "is-warning", "요청": "is-info", "완료": "is-success", "후보": ""},
 "accent": "할인",
 "people": [{"name": "Observer — 자연곱슬 입문 전", "who": "상황 한 줄", "why": "처음 오는 이유", "feels": "그때 마음",
             "wants": [{"q": "나와 비슷한 사람은 어떻게 됐나", "at": ["답이 보일 화면 id"]}],
             "win": "이 앱에서 성공한 순간", "screens": ["주로 쓰는 화면 id"], "core": true}],
 "prd_coverage": {"F1": ["…"], "US1": ["…"]}}
  • 사람 카드는 기능·단계를 더하는 근거가 아니다. PRD의 흐름(가입·온보딩 순서 등)은 그대로 두고, 같은 화면 안에서 무엇을 먼저 보여 주고 어떤 말투로 말하는가를 그 화면을 쓰는 사람에게 맞춘다. 알고 싶은 것(wants)의 답은 at 화면의 첫 화면에서 가장 크게 보인다 — 화면의 정보 위계는 기능 목록 순서가 아니라 그 화면을 여는 사람의 질문 순서다. 목록·카드 한 칸에도 그 질문에 답하는 정보(예: 남이 궁금한 사람에게는 작성자가 나와 얼마나 비슷한지, 어느 시기인지, 무엇을 썼는지)가 실린다. 그 사람의 질문과 상관없는 정보는 아래로 내린다. 막막한 사람에게 숙련자 대시보드 말투 금지. 단, 질문은 위계를 정하는 데 쓰는 것이지 화면 구성 단위가 아니다 — 질문마다 블록을 하나씩 만들고 질문 문장을 제목으로 다는 식이면 화면이 질답지가 된다. 예외: 홈의 큐레이션 묶음(기획전처럼 콘텐츠를 모아 보여 주는 칸) 제목은 질문과 거의 같은 말이어도 된다(예: "나와 비슷한 곱슬의 요즘 루틴") — 한 화면에 그런 제목은 하나, 앱 말투로. 화면은 평범한 앱의 모습(피드·목록·타임라인·카드) 그대로이고, 답은 그 안의 데이터(사진·이름·기간·제품·숫자)를 어디에 얼마나 크게 두느냐로 준다.
  • 화면은 여정의 궁금해지는 순간에서 끌어낸다. 같은 화면이 시기에 따라 달라지면 별도 화면 id로(예: home, home-d7, home-trip).
  • "지금 화면을 벗어나지 않고 고르거나 확인하는 일인가?"(수강권 고르기·한 번 더 확인·근거/용어 설명·정렬 고르기) → 새 화면이 아니라 kind: "sheet" + over(아래 깔리는 화면). 입력이 많거나 다시 돌아와 볼 내용이면 화면.
  • promos: 이 서비스가 실제로 하는 판촉·소식(쿠폰·할인·이벤트·새 소식)만 PRD·여정 근거와 함께. 없으면 빈 배열 — 배너·띠 배너·쿠폰·남은 시간은 여기 선언한 것만 쓸 수 있다(selfcheck).
  • kind: "list" 화면은 large_list(30개 넘게 쌓일 수 있나)를 반드시 적는다 — true면 검색 칸 필수(selfcheck).
  • 1차는 기본 화면 + 결과 화면만. 행동의 끝(예약 완료·출석 완료·취소 완료·신청 뒤)은 별도 화면(kind: "result")이나 traits.shares(→ --done)로 그린다.
  • 상태 화면 항목·states는 손으로 쓰지 않는다 — expand_states.py가 traits와 명세 규칙에서 펼친다: 목록 + 첫 사용 → empty, 폼 → error, 밖으로 내보내는 행동·한 번 누르는 요청 → done, 사용자가 지켜봐야 하는 긴 작업(사진 여러 장 업로드 등, long_task) → progress, 명세 규칙 → 그 규칙의 error(같은 요소 오류) 또는 confirm(되돌릴 수 없음·중복 경고 대화상자). loading·success는 상태가 아니다. 화면당 상태 2개 이하(기본 포함 3) — 넘으면 규칙을 정책 문구로 내린다.
  • 탭·세그먼트로 내용이 바뀌는 화면은 "tabs": [{"label": "지난 수업", "screen": "my-bookings-past"}] — 칸마다 그 내용을 보여 주는 화면(현재 칸은 자기 id).
  • accent(선택, 기본은 빼둔다): 강조색(.accent-text·.accent-dot)이 맡을 뜻 하나(할인·마감 임박·새 소식·내 손이 필요한 것 중 이 앱에서 첫눈에 걸려야 하는 것). 선언하지 않으면 강조 부품을 쓸 수 없다. 팔레트가 강조색을 가졌으면 out/palettes.json의 accent_seen이 그 서비스의 쓰임새다. CTA·선택 상태를 강조색으로 칠하지 않는다 — 버튼은 계속 브랜드 색.
  • photo_centric: 사진·이미지가 사용자가 만들거나 보는 핵심 콘텐츠면 true.
  • branches는 갈래에만(조건에 따라 다른 곳으로 가는 경우). 순서대로 이어지는 흐름은 적지 않는다 — 캔버스가 배치로 보여준다.
  • brief는 10~16장(하한을 채우려고 늘리지 않는다). spec은 명세 목록대로 — 명세에 없어도 여정의 시기별 변형(예: 단계별 홈)은 그대로 끌어낸다.

1.5단계 — 제품 판단: 가장 중요한 것만 남긴다 (목표 2분)

같은 메시지에서 함께: python3 $SK/scripts/expand_states.py out --stage go(1차 상태 펼치기 — 결과 화면(done)만. 오류·확인·빈·진행은 max가 펼친다). 메인은 판단하는 동안 이미지 자리 목록 out/image_slots.json을 쓰고 python3 $SK/scripts/imgsearch.py placeholders out으로 자리표시 파일을 만든다($SK/references/images.md 1절) — 빌드는 그 경로를 쓴다.

out/decisions.json:

{"core": "누가(핵심 사람) 무엇을 얻는가 — 이 앱이 푸는 그 사람의 단 하나의 갈등 한 문장",
 "items": [{"id": "F5", "name": "변경 사항 전달", "source": "PRD|여정|하네스",
            "verdict": "keep|lighten|cut|later", "how": "가볍게 바꾼다면 어떻게(예: 알림 대신 '바뀜' 표시)",
            "why": "판단 이유 한 줄", "ask": true}]}
  • 후보 = PRD의 기능·유저스토리 + 여정표에서 떠오른 것 + 하네스가 떠올린 것 + 시장 관례의 follow·consider 전부(source: "시장", id는 M·K 번호 그대로 — selfcheck가 빠진 것을 잡는다). 각각 여섯 질문에 답해 판정한다:
    1. 핵심 갈등을 푸는가 2. 이미 쓰는 앱·통로(카톡·전화·지도·예약 앱)가 하는가 3. 누구에게 새 할 일·새 알림이 생기는가 4. 없으면 무슨 일이 생기나(빈도 × 피해) 5. 더 가벼운 형태로 대신할 수 있나 6. 사람 카드 중 누구의 '처음 오는 이유'나 '성공한 순간'에 닿나 — 아무에게도 닿지 않으면 cut 후보, 어떤 사람의 성공한 순간 그 자체면 빼지 않는다(무겁다면 lighten — 예: 자동 분석 대신 사용자가 직접 걸러 보기)
  • core를 푸는 기능은 keep이고, 사용자가 결정하는 화면에 반드시 보인다(예: "겹치지 않게 확정"이 core면 겹침은 후보 화면뿐 아니라 확정 화면에도). core 기능을 lighten하면 그 결정은 사실 표와 모든 화면에 같은 방식으로 반영한다.
  • 요구사항은 문구가 아니라 의도를 충족한다(예: "변경 사항 전달"의 의도 = 묻지 않아도 안다 → 알림 대신 열면 보이는 표시로 충족 가능). 대신 근거를 남긴다.
  • 반대 입장 서브에이전트 3개를 한 메시지에 병렬로: 사람 카드에서 서로 가장 다른 둘(각자의 하루를 따라가며 "이건 귀찮다/이건 꼭 필요하다") + "30%를 빼야 하는 PM". 각자 장부 초안에 반박만 돌려준다. 판정은 메인이 여섯 질문 기준으로 한다.
  • 확인이 필요한 것 = source: "PRD" 이면서 cut 또는 lighten인 항목(ask: true). 하네스가 떠올렸다가 뺀 것은 묻지 않는다(캔버스에만 공개).
  • 확인이 필요 없으면 바로 2단계로. 필요하면 여기서 턴을 끝낸다(최대 3개, 영향 큰 순). 형식:
만들기 전에 이렇게 정했어요. 괜찮으면 "그대로", 다시 넣을 게 있으면 번호만 알려주세요.
1. (무엇이 달라지는지 쉬운 말로 한 문장) — (이유 한 줄)
2. …
[[ASK]]

전문 용어 금지. 답을 받으면 되살릴 번호는 verdict: keep으로 바꾸고 2단계로.

2단계 — 병렬 빌드 (목표 4분)

  • 같은 메시지에 이미지 탐색 에이전트(가벼운 모델, 자리 4개당 1개, 최대 6)도 함께 띄운다($SK/references/images.md 2절). 탐색이 돌아오면 선택 에이전트 1개(중간 모델, 3절)를 띄운다 — 빌드와 겹쳐 진행, 3단계 전에 끝난다.
  • 빌드 서브에이전트 ceil(전체 화면 수 / 4)개(최대 10)를 한 메시지에 띄워 나눠 맡긴다(같은 흐름끼리, 상태 화면은 기본 화면과 같은 에이전트). 각자 자기 파일만 쓴다.
  • 부품은 COMPONENTS.md의 판단 질문으로 고른다 — 화면마다 "탐색·진열·판촉" 절의 질문에 답해 예인 부품을 쓴다. 목록 행·흰 블록만으로 모든 화면을 짜지 않는다(질문이 예인데 행으로 대신하면 실패). 화면을 채우려고 쓰지도 않는다.
  • 화면 유형대로 짠다: 맡은 화면에 archetype이 있으면 $SK/references/screen-kinds.md의 그 유형 행(첫 화면 주인공·부품·아래로)을 붙인다 — 스크롤 전 첫 화면에서 가장 큰 면적은 그 주인공이 차지하고, 주인공 요소에 data-anchor를 단다(audit가 잰다). 사람 카드의 알고 싶은 것은 그 주인공 자리에 담는다. 원칙 1의 핵심 메시지 머리글(지금 상황 한 문장)은 대표 콘텐츠형·피드형이 아니면 주인공 위에 그대로 둔다 — 주인공보다 커지면 안 되는 건 그 사이에 끼는 아바타 줄·안내 띠다.
  • 각 에이전트에게 붙이는 것: 위 원칙 전문, $SK/foundation/COMPONENTS.md 전문, out/journey.md의 시나리오 데이터 표, 맡은 화면의 screens.json 항목, 모범 답안 경로 $SK/foundation/examples/*.html(구조만 참고).
  • 상태 화면은 기본 화면 파일을 복사해 바뀐 부분만 고친다 — 같은 화면의 두 모습이 구조(제목 위치·블록 묶음·사진 크기)가 달라지면 안 된다. 상태 화면에 기본 화면과 같은 목적의 버튼을 하나 더 붙이지 않는다(해결 행동이 주 버튼).
  • 각 에이전트에게 맡은 화면 영역의 시장 관례(follow 중 keep한 것 + 근거 시트 경로 out/market/<n>-<앱>.jpg, 관련 avoid)도 붙인다 — "구조만 참고, 문구·그림·색은 베끼지 말 것".
  • 각 에이전트에게 맡은 화면의 명세 항목(spec_inventory의 covered_by·rule — PRD 원문 인용 포함)과 이미지 자리 경로(image_slots.json 중 그 화면 것)도 붙인다. 상태 화면은 rules에 적힌 규칙이 보이는 모습으로.
  • 각 에이전트에게 사람 카드(맡은 화면을 쓰는 사람과, at이 그 화면인 알고 싶은 것 — 첫 화면에서 그 질문의 답을 가장 크게, 말투는 그 사람의 마음에 맞춘다 — 질문마다 블록을 만들어 질답지로 만들지 않는다)와 사실 표도 붙이고 "표에 없는 날짜·숫자·상태를 지어내지 말 것"을 지시한다.
  • 파일: out/screens/<id>.html — COMPONENTS.md의 뼈대 그대로(../tokens.css·../components.css·../palette.js, 일러스트 ../assets/fluent/<이름>.svg). 갈래·이동은 실제 <a href>로 잇는다. 누르는 것은 전부 셋 중 하나 — 다른 화면 href / data-back / data-stay="바뀐 뒤 안내 한 문장"(COMPONENTS.md 버튼 절, selfcheck가 검사).

3단계 — 검증·수정 (목표 3분, 동시에 · 수정은 1회, 흐름별 병렬)

한 메시지에서 동시에(포그라운드로 실행해 같은 턴에서 결과를 받는다 — 백그라운드로 돌려 놓고 "끝나면 알려드릴게요"로 턴을 끝내지 않는다. 턴이 끝나면 다시 이어지지 않는다):

  • python3 $SK/scripts/build_canvas.py out — 캔버스 out/index.html(Screens·Foundation·Components 탭, 드래그 이동, 색 점 3개, 갈래 화살표, 정책 3줄 — 스크립트가 만들고 AI는 손대지 않는다)
  • python3 $SK/scripts/selfcheck.py out — 매니페스트·파일·상태·금지 문구·갈 곳 없는 버튼·한글 문구(해요체에 섞인 하십시오체·"~을 통해"·"제공합니다"는 실패, 나머지 번역투·띄어쓰기·은유 라벨은 경고 — 맥락을 보고 고칠지 정한다)
  • python3 $SK/scripts/audit.py out --shots out/.shots — 렌더링 측정(대비·토큰 밖 색·의미 배지·CTA·터치·한국어 줄바꿈·캔버스) + 화면 캡처
  • 사실 대조 서브에이전트 1개(같은 메시지에서): journey.md 사실 표와 모든 screens/*.html의 글자를 대조해 어긋남(날짜·시간·인원·겹침·상태 이름)만 목록으로 돌려준다. 고치지는 않는다.

❌ 항목과 캡처를 보고 고친다. 여러 화면에 걸친 문제는 공통 원인부터. 고칠 화면이 많으면 흐름별로 서브에이전트에 나눠 병렬로 고친다. 수정은 1회, 흐름 고리(시작·끝)와 P0 항목 우선. 수정 후 selfcheck만 한 번 더. 그래도 남는 항목은 마지막 메시지에 적는다. 1차의 시간 상한은 15분 — 넘을 것 같으면 P1 이하 수정은 미루고 마지막 메시지에 적는다.

비평 체크리스트: $SK/references/checklist.md (캡처를 볼 때, P0·P1이면 반드시 고친다).

끝 — 마지막 메시지

  • 무엇을 만들었는지 3줄(핵심 한 문장, 화면 수, 기본 색과 그 이유 — 캔버스에서 색 점으로 바꿀 수 있다고 안내)
  • 뺀 것(하네스가 떠올렸다 뺀 것 포함)은 캔버스 맨 위 "정한 것 · 뺀 것"에 있다고 안내
  • 따른 시장 관례 1~2개와 일부러 벗어난 것(있으면, 이유와 함께) — 참고한 앱 이름
  • 하네스가 대신 정한 것 중 사용자가 알아야 할 것 2~3개
  • 남은 ❌ 항목(있으면)
  • 고칠 곳 한 줄: "고칠 곳은 캔버스에서 화면을 크게 보고 '의견'으로 남긴 뒤, '의견 복사'해 여기에 붙여넣으세요 — 그 요소만 고쳐요"
  • 다음 단계 한 줄: "오류·확인·빈 화면 같은 상태까지 보고 싶으면 max를 실행하세요(10분쯤, N장 예정)" — max를 부르는 법은 위 "에이전트마다 다른 것"대로 지금 에이전트에 맞춰 적는다 — N은 screens.json의 pending_states
  • 마지막 줄: [[DONE out/index.html]] — 이 줄 없이 턴을 끝내면 미완성으로 처리된다. 기다릴 작업이 남았으면 기다린 뒤에 쓴다.

참고

  • 기준: docs/success-criteria.md, 근거: docs/design-criteria.md
  • 팔레트 라이브러리 방법·목록: $SK/foundation/palettes/README.md (구동 중에는 라이브러리·승인된 시드(seeds.json)에서만 고른다)
  • 시장 관례: $SK/references/market.md · 명세 목록: $SK/references/spec-mode.md · 이미지: $SK/references/images.md · 캔버스 의견 고치기: $SK/references/feedback.md

k-style-ui-ux:max — 2차: 상태·예외까지

경로: 이 SKILL.md가 있는 폴더(<스킬 폴더> — Claude Code는 Base directory로 보여 준다)의 ../../core가 공용 폴더다. 맨 처음 SK=$(cd "<스킬 폴더>/../../core" && pwd -P), 1차 지시문은 <스킬 폴더>/../go/SKILL.md — 그 맨 위 "에이전트마다 다른 것"(동시에 띄우기·모델 등급)을 여기서도 따른다.

0. 어디서 시작하나

  • 메시지가 [k-style-ui-ux 수정 요청]로 시작하면 → 상태를 더하지 않는다. $SK/references/feedback.md대로 적힌 화면의 그 요소만 고치고 selfcheck.py·audit.py --shots·build_canvas.py를 다시 돌린 뒤 그 문서의 마지막 메시지 형식으로 끝낸다.
  • out/screens.json이 있고 "stage": "go"면 → 1차는 끝났다. 바로 2차로. 첫 줄: "1차 위에 상태 화면을 더할게요. 10분쯤 걸려요."
  • out/screens.json이 없으면(PRD를 받음) → 첫 줄: "처음부터 끝까지 만들게요. 25분쯤 걸려요." 그리고 1차 지시문(go/SKILL.md)을 그대로 따른다 — 단, 1차의 "끝 — 마지막 메시지"는 쓰지 않고(중간에 [[DONE]] 금지) 2차로 이어 간다. 1차에서 PRD 요구사항 확인([[ASK]])이 필요하면 그때는 턴을 끝내고, 답을 받으면 1차 → 2차를 이어 간다.
  • "stage": "max"면 이미 끝났다 — 캔버스 경로만 알려 주고, 고칠 곳은 캔버스에서 '의견'으로 남겨 '의견 복사'해 붙여넣으면 된다고 안내한다.

1. 상태 펼치기 (1분)

  • python3 $SK/scripts/expand_states.py out --stage max → 오류(error)·확인 대화상자(confirm)·빈 상태(empty)·진행 중(progress)·규칙 상태가 screens.json에 추가된다. 화면당 상태 2개 초과 오류가 나면 해당 규칙을 정책 문구(policy)로 내리고 다시.
  • 새로 생긴 상태 화면 목록(state_of·state·rules)을 흐름(group)별로 묶는다.

2. 병렬 빌드 (5분)

  • 빌드 서브에이전트 ceil(상태 화면 수 / 5)개(최대 8)를 한 메시지에. 같은 흐름끼리 묶는다.
  • 각 에이전트에게: $SK/references/principles.md 전문, $SK/foundation/COMPONENTS.md 전문, out/journey.md의 사람 카드·사실 표, 맡은 상태 항목(규칙 원문 인용 포함), 그리고 아래 규칙:
    • 기본 화면 파일을 복사해 바뀐 부분만 고친다. 구조(제목 위치·블록 묶음·사진)는 그대로.
    • 상태가 바뀌면 그 상태와 모순되는 정보는 지운다(예: 이미 시작돼 취소할 수 없는데 "취소하면 7회→6회" 안내가 남아 있으면 안 된다).
    • 오류 이유는 첫 화면(스크롤 없이)에 보인다 — 문제 칸 바로 아래 또는 맨 위. 해결 행동이 주 버튼, 같은 목적 버튼을 하나 더 붙이지 않는다.
    • error: 같은 요소에서 문제 칸만 바뀐다(경고 아이콘 + 문구). confirm: 바텀시트 대화상자 — 되돌릴 수 없는 행동·중복 경고에만, 위험한 확인은 오류 색 글자. empty: 첫 사용 — 다음 행동 하나. progress: 진행률·남은 개수·취소/백그라운드 안내.
    • 1차 화면은 고치지 않는다(사용자가 이미 봤다). 상태 화면으로 가는 링크가 필요하면 그 한 줄만 추가한다.

3. 검증·수정 (3분)

한 메시지에서 동시에(포그라운드): build_canvas.py out · selfcheck.py out · audit.py out --shots out/.shots + 사실 대조 서브에이전트 1개. 비평 체크리스트는 $SK/references/checklist.md. 수정은 1회, 상태 화면 위주로 흐름별 병렬.

끝 — 마지막 메시지

  • 무엇을 더했는지 2줄(상태 화면 수, 대표적인 예외 순간 2~3개)
  • (1차부터 했다면) 1차 마지막 메시지의 내용(핵심 한 문장, 화면 수, 기본 색과 이유, 뺀 것은 캔버스 맨 위)도 함께
  • 남은 ❌ 항목(있으면)
  • 마지막 줄: [[DONE out/index.html]]

Sponsors

Details

Marketplace
vmc-inner-circle/k-style-ui-ux
Source
plugins/k-style-ui-ux
Category
Community