오픈소스 디자인 하네스 k-style-ui-ux 분석: PRD 한 장으로 한국형 UI를 15분에 뽑는 법
화려한 일러스트는 그럴싸하지만, 왜 생성형 AI가 만든 화면은 실제 토스나 당근마켓처럼 동작하지 못했을까요?
이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.
✦ KR 주제: 오픈소스 디자인 하네스 k-style-ui-ux의 설계 원리와 활용
✦ KR 핵심 요약: k-style-ui-ux는 PRD 한 장을 15분 안팎에 토스·당근마켓 스타일 모바일 인터페이스 캔버스로 변환하는 오픈소스 하네스입니다. 공통 원칙 주입, 의존성 기반 병렬화, 반대 입장 AI 상호 검토, 스크립트 기반 결정론적 검증의 4단계 장치를 통해 AI 특유의 파편화를 방지하고 실무에 즉시 적용 가능한 완성도를 확보합니다.
🌐 Global Takeaway: The open-source design harness k-style-ui-ux transforms a single PRD into a production-grade, Korean-style mobile UI flow canvas within 15 minutes. By decoupling deterministic script validation from parallelized agent generation and adversarial peer review, it guarantees structural consistency modeled after Toss and Karrot.
아래 흐름도는 PRD 문서 한 장이 토스·당근 스타일의 HTML 화면 흐름 캔버스로 변환되는 하네스 파이프라인을 보여줍니다.
1. 프롬프트 한 줄의 한계와 디자인 하네스의 등장
거대 언어 모델(LLM)과 생성형 AI의 발전은 UI/UX 디자인 분야에도 거대한 변화를 가져왔습니다. 하지만 현업 프로덕트 디자이너와 프론트엔드 엔지니어들은 여전히 텍스트 프롬프트 단 한 줄로 온전한 앱 서비스를 설계할 수 없다는 현실에 부딪힙니다. 미드저니(Midjourney)나 v0 같은 도구에 요구사항을 넣으면 시각적으로는 화려하고 세련된 목업이 나오지만, 정작 국내 모바일 서비스 환경에 바로 이식할 수 없는 경우가 대다수입니다. 여백의 밀도, 엄격한 타이포그래피 계층, 한국 사용자에게 익숙한 정보 밀도와 바텀시트, 탭바 중심의 작동 흐름이 결여되어 있기 때문입니다. 화면 낱장은 그럴듯해 보여도, 화면 간 상태 전이와 비즈니스 정책이 누락되어 실제 프로덕션 단계에서는 처음부터 다시 그려야 하는 '예쁜 쓰레기' 문제에 직면하곤 했습니다.
이러한 문제를 해결하기 위해 2026년 인터페이스 엔지니어링 생태계에서 주목받기 시작한 개념이 바로 '디자인 하네스(Design Harness)'입니다. 하네스란 자율적으로 작동하는 AI 에이전트가 통제되지 않은 임의의 결과물을 쏟아내지 않도록, 엄격하게 규정된 작업 순서, 도메인 규칙, 검증 도구 안에서만 일하도록 제약하는 오케스트레이션 프레임워크를 뜻합니다. 말안장이나 안전벨트처럼 에이전트의 자유도를 일정 부분 제한하는 대신, 일관된 결과물의 품질과 엔지니어링 안정성을 담보하는 접근 방식입니다.
2026년 10월 29일, 바이브마피아클럽(VIBE MAFIA CLUB) 커뮤니티의 '이너서클(Inner Circle)' 모임 활동을 통해 오픈소스로 공개된 k-style-ui-ux는 바로 이 디자인 하네스 철학을 철저히 구현한 대표적인 프로젝트입니다. 토스(Toss)와 당근마켓(Karrot)으로 대표되는 고유한 한국형 모바일 앱 디자인 패턴을 기획서 한 장으로 자동 구성해 내는 플러그인 도구로 GitHub에 전격 공개되었습니다.
1-1. 단발성 생성과 하네스 파이프라인의 구조적 차이
기존의 일반적인 AI UI 생성 방식은 사용자가 입력한 자연어 프롬프트를 단일 에이전트가 한 번에 해석하여 하나의 HTML이나 CSS 코드를 출력하는 '원샷(One-shot)' 구조를 취했습니다. 이 방식은 에이전트가 디자인 시스템 전반의 토큰, 비즈니스 예외 정책, 이전 화면과의 맥락적 의존성을 동시에 기억하고 조율해야 하므로 필연적으로 컨텍스트 윈도우 한계와 환각(Hallucination)에 부딪힙니다. 버튼의 모서리 반경(border-radius)이 화면마다 제각각이거나, 결제 완료 화면으로 넘어가는 트랜지션 정책이 증발하는 문제가 반복되는 이유가 여기에 있습니다.
반면 디자인 하네스는 하나의 에이전트에게 전권을 주지 않습니다. k-style-ui-ux는 단일 PRD(제품 요구사항 문서)를 입력받은 뒤, 작업 단계를 미세하게 쪼개고 각 단계마다 전담 에이전트와 규칙 검증 스크립트를 배치합니다. 단편적인 화면 조각을 생성하는 것이 아니라, 사용자의 진입부터 최종 액션까지 이어지는 사용자 흐름(User Flow) 전체를 유기적으로 엮어 하나의 인터랙티브 HTML 캔버스로 직조해 냅니다. 이 캔버스 안에는 개별 화면뿐 아니라 화면 간 전이 화살표, 상태별 정책 메모, 공통 디자인 토큰이 체계적으로 포함됩니다.
| 비교 항목 | 기존 단발성 AI 생성 도구 | 오픈소스 하네스 k-style-ui-ux |
|---|---|---|
| 입력 체계 | 단편적 자연어 프롬프트 | 단일 마크다운/텍스트 PRD 문서 |
| 출력 형식 | 단일 화면 코드 또는 낱장 이미지 | 상호작용 가능한 화면 흐름 HTML 캔버스 |
| 스타일 지향점 | 글로벌 레퍼런스 중심 (장식적 요소 과다) | 한국형 앱 특화 (토스·당근 스타일의 높은 정보 밀도) |
| 정책 반영 여부 | 비즈니스 예외 및 운영 정책 누락 | 화면 하단에 재전송·제한 등 구체적 정책 주석 명시 |
| 제어 메커니즘 | 모델 자체의 확률적 생성에 의존 | 스크립트 검증 + 반대 입장 AI 상호 비판 |
| 디자인 토큰 관리 | 토큰 일관성 결여, 임의 하드코딩 | 파운데이션 탭에서 색상·간격·서체 일괄 제어 |
2. k-style-ui-ux의 아키텍처와 4대 품질 보증 장치
k-style-ui-ux가 PRD 한 장으로 15분 안팎에 실무급 결과물을 뽑아낼 수 있는 비결은 아키텍처 내부의 4가지 품질·속도 보증 장치에 있습니다. 개발진은 바이브마피아클럽 뉴스레터와 라이브 세션을 통해, AI 모델의 지능에만 모든 것을 맡기는 '순수 LLM 의존 방식'을 버리고, 스크립트와 정형 데이터를 하네스 전반에 배치했기 때문에 품질과 실행 속도를 동시에 끌어올릴 수 있었다고 밝혔습니다.
하네스가 작동할 때 가동되는 4가지 핵심 장치는 다음과 같습니다.
- 공통 원칙 전문 주입: 파이프라인에 참여하는 모든 디자인 서브 에이전트에게 한국형 모바일 UX의 공통 원칙 가이드라인 전문을 빠짐없이 주입합니다. 이를 통해 어떤 에이전트가 어떤 서브 화면을 맡더라도 일관된 패딩, 서체 계층, 컴포넌트 높이 규격을 준수하게 만듭니다.
- 의존 관계에 따른 병렬화: 화면 간의 위계와 전이 관계를 분석하여, 선행 화면이 필요 없는 독립적인 흐름(예: 설정 탭, 알림 목록 등)은 백그라운드에서 비동기 병렬로 생성합니다. 이를 통해 전체 생성 시간을 획기적으로 압축합니다.
- 반대 입장 AI(Adversarial Agent) 도입: 화면을 생성하는 에이전트와 별개로, 생성된 인터페이스의 논리적 결함과 UX 누락을 집중 공격하는 '비판 에이전트'를 맞붙입니다. 에이전트 간의 상호 반박 과정을 거치며 엉성한 레이아웃이나 빠진 정책이 스스로 보정됩니다.
- 프로그램(스크립트) 기반 검증: 색상 코드, 여백 수치, HTML 태그의 유효성 등 규칙이 명확한 영역은 AI에게 판단을 맡기지 않고 결정론적인 검증 스크립트로 사후 필터링합니다. 이는 토큰 불일치를 100% 방지하는 방파제 역할을 합니다.
2-1. 에이전트와 결정론적 스크립트의 엄격한 역할 분리
많은 생성형 AI 파이프라인이 겪는 치명적인 병목은 텍스트 파싱, CSS 문법 검사, 디자인 토큰 유효성 검증처럼 단순하지만 규칙이 명확한 작업까지 거대 언어 모델에게 맡긴다는 점입니다. LLM은 추론과 창의적 기획에는 뛰어나지만, 정밀한 문자열 매칭이나 수치 제약 조건 검증에서는 무작위 확률로 인해 실수를 저지릅니다.
"하네스 안에서 AI에게 맡기지 않고 스크립트와 정해진 데이터로 처리한 일이 무엇인지, 그게 왜 품질과 속도를 같이 올리는지 이해하는 것이 하네스 엔지니어링의 본질이다." — 바이브마피아클럽 기술 뉴스레터 중
k-style-ui-ux는 이 경계를 명확하게 그었습니다. 사용자 흐름 파악, 각 화면에 필요한 컴포넌트의 논리적 배치, 피그마 스타일의 정책 문구 작성 등 고차원적 인지가 필요한 영역은 Claude 모델 계열의 에이전트에게 위임했습니다. 반면 화면 캔버스에 주입되는 CSS 루트 변수(:root)의 규격 준수 여부, 버튼 상태 클래스 네이밍, JSON 데이터 파싱 등은 하네스에 내장된 Node.js 기반 검증 스크립트가 밀리초 단위로 가로채 검사합니다. 규칙에 맞지 않는 산출물이 나오면 즉각적인 에러를 반환해 재시도를 강제함으로써 파이프라인 전체의 결함률을 '0'에 수렴하도록 설계했습니다.
3. 화면 흐름 중심의 캔버스와 디자인 토큰 시스템
k-style-ui-ux가 출력하는 최종 산출물은 이미지 파일이나 단편적인 마크업 코드가 아닙니다. 브라우저에서 단독으로 열어볼 수 있는 완전한 단일 HTML 파일 형태의 '화면 흐름 캔버스(Screen Flow Canvas)'입니다. 피그마(Figma)나 미로(Miro) 같은 화이트보드 툴에서 디자이너들이 작업하는 방식을 브라우저 렌더링 엔진 위에 그대로 옮겨놓은 구조입니다.
캔버스를 열면 가장 먼저 눈에 띄는 것은 화면들이 낱장으로 흩어져 있지 않고, 실제 사용자의 행동 흐름에 맞춰 유기적인 선(Connector Line)으로 이어져 있다는 점입니다. 예를 들어 필라테스 예약 앱 PRD를 입력하면, 스플래시 화면 → 서비스 튜토리얼 → 회원가입/로그인 → 휴대폰 본인인증 → 메인 수업 일정 조회 → 예약 바텀시트 → 예약 완료 화면이 순차적으로 연결되어 렌더링됩니다. 기획자와 엔지니어는 화면 간의 전이 관계를 한눈에 파악할 수 있으며, 특정 화면을 클릭해 상호작용 요소를 직접 테스트해 볼 수 있습니다.
<!-- k-style-ui-ux가 출력하는 화면 흐름 캔버스 메타 구조 예시 -->
<div class="canvas-container" data-flow-engine="k-style">
<nav class="canvas-tabs">
<button class="tab-btn active" data-target="screens">화면 흐름</button>
<button class="tab-btn" data-target="foundations">파운데이션 (토큰)</button>
<button class="tab-btn" data-target="components">컴포넌트 라이브러리</button>
</nav>
<main class="viewport-wrapper">
<!-- 선으로 연결되는 모바일 프레임 뷰포트 -->
<section id="screens-view" class="flow-canvas"></section>
<!-- 전역 디자인 토큰 제어 패널 -->
<section id="foundations-view" class="token-inspector hidden"></section>
<!-- 아토믹 컴포넌트 카탈로그 -->
<section id="components-view" class="component-catalog hidden"></section>
</main>
</div>
3-1. 정책 주석 명시와 엣지 케이스 분리 원칙
이 하네스의 가장 현실적인 디테일은 화면 하단에 붙는 '비즈니스 정책 주석(Policy Note)'입니다. 현업에서 일하는 숙련된 프로덕트 디자이너들은 피그마 화면 옆에 개발자가 참고해야 할 백엔드 정책과 인터랙션 규칙을 메모해 둡니다. k-style-ui-ux는 이 방식을 학습하여 각 모바일 프레임 하단에 구체적인 정책을 자동으로 표기합니다.
예를 들어 본인인증 화면 아래에는 다음과 같은 실무 정책이 자동으로 명시됩니다. - "인증번호 유효 시간은 3분으로 설정하며, 타이머 만료 시 재요청 버튼이 활성화된다." - "인증번호 재전송은 30초 뒤에 가능하며, 1일 최대 5회로 제한한다." - "인증 실패 5회 초과 시 24시간 동안 추가 시도를 차단한다."
동시에 하네스는 영리한 취사선택을 단행합니다. 초기 프로토타이핑 단계에서 통신 장애, 서버 타임아웃, 중복 가입 에러와 같은 모든 미세 엣지 케이스(Edge Case)를 화면으로 일일이 그리면 캔버스가 복잡해지고 생성 시간만 기하급수적으로 늘어납니다. 따라서 k-style-ui-ux는 정상 작동 흐름(Happy Path)과 필수 전이 화면을 선별해 시각화하고, 복잡한 예외 분기는 화면 아래 정책 텍스트로 축약해 기재하는 방식으로 엔지니어링 효율을 극대화했습니다.
또한 캔버스 상단에는 '파운데이션(Foundations)' 탭과 '컴포넌츠(Components)' 탭이 독립적으로 제공됩니다. 파운데이션 탭에서는 전역 디자인 토큰인 주 색상(Primary Color), 서브 컬러, 타이포그래피 스케일, 그리드 여백, 모서리 반경(Radius), 엘리베이션(그림자) 수치를 실시간으로 수정할 수 있습니다. 캔버스 제어 패널을 통해 당근마켓 특유의 주황색 팔레트나 마이리얼트립 스타일의 블루 팔레트로 브랜드 테마를 클릭 한 번에 즉시 스위칭하여 검토할 수 있습니다.
4. 실전 워크플로우: Claude Code 플러그인과 go·max 명령어
k-style-ui-ux는 독립적인 GUI 프로그램이 아니라, 최근 개발자들 사이에서 강력한 터미널 에이전트로 자리잡은 Claude Code 및 OpenAI Codex 플러그인 형태로 동작합니다. 개발자나 기획자가 별도의 무거운 툴을 띄울 필요 없이, 터미널 환경에서 본인이 작성한 기획서 파일을 지정하고 명령어만 입력하면 백그라운드에서 오케스트레이션이 시작됩니다.
프로젝트 저장소를 로컬 환경에 클론한 뒤 플러그인 형태로 등록하면, 하네스가 제공하는 표준 실행 명령어를 통해 작업을 트리거할 수 있습니다. 가장 핵심적인 실행 명령은 go와 max로 나뉩니다.
# 저장소 클론 및 환경 설정
git clone https://github.com/vmc-inner-circle/k-style-ui-ux.git
cd k-style-ui-ux
npm install
# Claude Code 플러그인 환경에서 초안 생성 실행 (go)
claude-code run k-style --command go --input ./docs/prd-sample.md
# 오류 복구 및 누락 화면 심층 생성 (max)
claude-code run k-style --command max --target ./output/canvas-output.html
두 명령어의 역할은 명확하게 구분됩니다.
- go: 입력된 PRD 문서를 빠르게 분석하여 전체 서비스의 화면 흐름 초안을 10~15분 내에 일괄 생성합니다. 전체 사용자 여정의 뼈대와 주요 컴포넌트, 기본 정책 주석을 최단 시간에 시각화하는 메인 파이프라인입니다.
- max: go 실행 후 생성된 캔버스 내에서 특정 화면이 빈 채로 렌더링되었거나, 복잡한 비즈니스 로직으로 인해 컴포넌트 렌더링 오류가 발생했을 때 이를 집중적으로 복구하고 심층적인 엣지 케이스 화면을 보강할 때 사용합니다.
기획자나 엔지니어는 go 명령어로 1차 결과물을 받아 팀원들과 화면 구조를 검토한 뒤, 추가적인 상태 화면이나 상세 뷰가 필요한 지점에만 국소적으로 max 명령을 내려 완성도를 높일 수 있습니다.
5. 생성 소요 시간과 컴포넌트 렌더링 성능 지표
k-style-ui-ux 프로젝트가 커뮤니티에서 폭발적인 관심을 받은 결정적인 이유는 압도적인 실행 속도에 있습니다. 바이브마피아클럽 라이브 시연 및 뉴스레터 기록에 따르면, 모델 인프라로 Opus 5.1(10월 7일 버전)을 활용해 실제 다양한 도메인의 PRD를 투입했을 때 화면 수와 소요 시간은 다음과 같이 실측되었습니다.
- 사주·운세 모바일 앱: 온보딩, 생년월일 입력, 궁합 분석, 일일 운세 카드 등 총 39개 화면을 생성하는 데 정확히 15분이 소요되었습니다.
- 가족 여행 일정 관리 앱: 여행 일정 생성, 타임라인 공유, 경비 정산 뷰를 포함한 전체 플로우 생성이 11분 만에 완료되었습니다.
- 기타 유틸리티 서비스: 핵심 플로우 중심의 경량 서비스의 경우 9분 만에 단일 캔버스 HTML 추출이 완료되었습니다.
과거 프로덕트 매니저가 기획서를 작성하고 디자이너가 와이어프레임을 피그마에 옮겨 첫 프로토타입을 공유하기까지 최소 수일에서 수주일이 걸리던 작업이, 커피 한 잔을 마시는 15분 만에 브라우저에서 인터랙션 가능한 수준으로 완성되는 셈입니다. 이러한 초고속 파이프라인이 가능한 것은 화면별 의존성을 수학적으로 계산하여 독립적인 컴포넌트 트리를 동시에 병렬 연산하는 하네스의 스케줄링 알고리즘 덕분입니다.
6. 프로덕션 도입 시 유의점과 한국형 UI의 경계 조건
k-style-ui-ux는 강력한 생산성을 제공하지만, 모든 종류의 디자인 작업에 만능인 은탄환(Silver Bullet)은 아닙니다. 도구의 특성과 한계를 정확히 인지해야 실무 파이프라인에서 낭패를 보지 않습니다.
첫째, 이 도구는 '화려한 디자인'보다 '한눈에 보이는 직관적인 UX'를 지향합니다. 토스나 당근마켓 스타일은 불필요한 그라데이션, 현란한 3D 그래픽, 과도한 시각 효과를 철저히 배제합니다. 대신 16px 기반의 시스템 폰트, 명확한 고대비 CTA 버튼, 엄격한 여백(8pt 그리드 시스템), 명확한 라벨링을 통해 정보 전달 속도를 극대화하는 형태입니다. 따라서 브랜드 아이덴티티를 예술적으로 표현해야 하는 패션 이커머스 메인 페이지나 역동적인 게임 프로모션 사이트 등에는 적합하지 않습니다.
둘째, 생성된 HTML 캔버스는 초기 기획 검증 및 프로토타이핑, 개발 전 스펙 정렬을 위한 도구이지 최종 프로덕션 번들이 아닙니다. 이 도구에서 출력된 HTML은 React, React Native, Flutter 같은 네이티브 프레임워크 코드로 바로 빌드되는 것이 아니므로, 프론트엔드 개발팀은 캔버스에 정의된 디자인 토큰(CSS 변수)과 컴포넌트 계층 구조를 참조하여 실제 프로덕션 코드로 옮겨 담는 작업이 필요합니다. 다만 화면 흐름과 정책 주석이 사전에 완벽히 정의되어 있기 때문에 기획-디자인-개발 간의 커뮤니케이션 비용은 80% 이상 절감됩니다.
셋째, PRD의 품질이 결과물의 품질을 좌우합니다. 'GIGO(Garbage In, Garbage Out)' 원칙은 하네스 환경에서도 동일하게 작동합니다. 요구사항이 모호하거나 화면 간의 상태 정의가 전혀 없는 한 줄짜리 아이디어 메모를 넣으면, 하네스 내부의 반대 입장 AI가 수많은 예외를 지적하다가 일반적인 템플릿 수준의 화면을 출력하게 됩니다. 최소한 핵심 사용자 여정(User Journey)과 필수 데이터 필드가 명시된 PRD가 갖춰져야 하네스의 진가가 발휘됩니다.
7. AI 기반 인터페이스 설계의 미래와 시사점
바이브마피아클럽 이너서클 모임의 주 1회 오픈소스 스터디에서 출발한 k-style-ui-ux는 AI 시대의 소프트웨어 엔지니어링이 나아갈 중요한 이정표를 보여줍니다. 단순히 빅테크 기업이 제공하는 LLM API를 그대로 호출하는 수준을 넘어, 특정 지역(한국)과 특정 도메인(모바일 서비스)의 맥락에 맞는 '규칙과 제약'을 소프트웨어적으로 어떻게 설계해야 하는지를 입증했기 때문입니다.
이제 AI 도구의 경쟁력은 '얼마나 거대한 모델을 쓰는가'가 아니라, '모델을 제어하는 하네스를 얼마나 정교하게 구축했는가'로 옮겨가고 있습니다. 공통 디자인 시스템을 에이전트의 뇌 속에 주입하고, 결정론적 스크립트로 환각을 걸러내며, 에이전트끼리 상호 비판하게 만드는 하네스 패턴은 향후 UI/UX 디자인뿐 아니라 백엔드 아키텍처 설계, 보안 감사, 데이터 파이프라인 구축 등 엔지니어링 전반으로 확장될 것입니다. PRD 한 장으로 15분 만에 토스급 모바일 화면 흐름을 뽑아내는 이 오픈소스 도구는, 실무 개발팀이 AI를 진정한 동료 엔지니어로 받아들이는 가장 실질적인 첫걸음이 될 것입니다.
자주 묻는 질문
Q. k-style-ui-ux는 어떤 환경에서 실행할 수 있나요?
A. GitHub에 공개된 오픈소스 저장소를 클론한 뒤 Claude Code 또는 OpenAI Codex 플러그인 환경에서 터미널 명령어로 실행할 수 있습니다. Node.js 환경이 필요하며, 준비된 PRD 문서를 인자로 넘겨 구동합니다.
Q. 생성된 HTML 파일을 실제 앱 개발에 바로 쓸 수 있나요?
A. 출력물은 브라우저에서 조작 가능한 단일 HTML 화면 흐름 캔버스입니다. React나 Flutter 등의 네이티브 앱 코드가 바로 나오는 것은 아니지만, 파운데이션 탭의 디자인 토큰과 화면별 정책 주석이 완벽히 정리되어 있어 프론트엔드 개발 시 스펙 명세서로 즉시 활용할 수 있습니다.
Q. 명령어 go와 max의 차이는 무엇인가요?
A. go 명령어는 PRD를 분석하여 전체 서비스의 화면 흐름 초안을 10~15분 내에 일괄 생성하는 기본 명령입니다. 반면 max 명령어는 go 실행 후 누락된 빈 화면이나 렌더링 오류를 복구하고 심층적인 엣지 케이스를 보강할 때 사용합니다.
원본
https://github.com/vmc-inner-circle/k-style-ui-ux
https://www.vibemafiaclub.com/newsletter/k-design-harness-live



댓글 0개