에이전트에게 맡겼더니 바퀴를 다시 발명했다. 그래서 먼저 보게 했다.
20분 만에 시안 20개를 뽑는 건 쉬운 부분이었다. 이미 잘 돌아가는 걸 찾아보고 그게 왜 되는지 따지게 만드는 데는 이틀과 규칙 세 개가 들었다.
글쓴이 박상현
TL;DR에이전트한테 리디자인을 시키면 같은 부품을 이리저리 옮겨 놓기만 한다. 사람은 익숙한 패턴을 더 쉽게 쓴다. 그래서 내 에이전트는 뭘 그리기 전에 이미 잘 돌아가는 걸 찾아보고 그게 왜 되는지부터 따진다. 여기에 규칙이 분명한 디자인 시스템을 붙이면 이슈에서 머지까지 오후 한나절이면 간다. 그래도 얼마나 필요한지는 실제로 쓰는 사람이 정한다.
10월의 어느 화요일 오전 10시 52분, 나는 프론트엔드 채널에 어드민 화면이 공간을 낭비한다고 썼다. 캘린더는 날짜 한 칸을 보여 주기 전에 제목과 월 선택과 범례에 287픽셀을 쓰고 있었다.
우리 팀은 사내 슬랙 에이전트를 쓴다. Claude 기반이고 저장소를 읽고 헤드리스 브라우저를 돌리고 사내 페이지를 올릴 수 있다. 리디자인을 해 달라고 했으면 몇 분 만에 나왔을 텐데 바로 그게 문제였다. 에이전트한테 더 나은 레이아웃을 달라고 하면 새로워 보일 때까지 같은 부품을 이리저리 옮긴다.
어드민 도구에 필요한 건 새로움이 아니다. 제이콥 닐슨이 2000년에 이미 써 둔 얘기다. 사용자는 대부분의 시간을 다른 사이트에서 보내니까 내 사이트도 거기처럼 돌아가길 기대한다. 익숙한 패턴이 쓰기 쉽다. 그러니 할 일은 어떤 캘린더가 이미 잘 돌아가는지, 왜 그런지 알아내고 그 위에 우리 걸 짓는 거였다.
에이전트가 그렇게 일하게 만드는 데 이틀과 규칙 세 개가 들었다.
시안마다 뭘 따라 했는지 밝혀야 했다
내 메시지가 요구한 건 세 가지였다. 답 하나가 아니라 시안 여러 개, 취향이 아니라 비슷한 서비스의 레퍼런스, 그리고 우선순위. 페이지에서 제일 중요한 게 정말 제일 중요해 보이는가?
에이전트는 먼저 실제 앱을 캡처하고 문제를 쟀다. 캘린더 격자는 위에서 287px, 수업 빌더 본문은 640px쯤에서 시작했다.
그다음 시안을 그리기 전에 기반부터 깔았다. 지금 쓰는 토큰, 실제 사이드바를 그대로 옮긴 셸, 실제 타입 모양을 따른 목 데이터, 짧은 원칙 파일. 페이지마다 핵심 모듈은 하나. 그 위에는 56px 헤더와 많아야 48px 툴바 하나, 합쳐서 104px. 크기는 정해진 값만 쓴다. 채워진 버튼은 하나. 색은 의미가 있을 때만 쓴다.
그러고 나서야 하위 에이전트 여러 개를 동시에 돌렸다. 시안마다 실제 제품 하나, 구체적인 레이아웃, 꼭 동작해야 하는 인터랙션을 적어야 했다. 캘린더는 구글 캘린더, 사이드 레일이 붙은 노션 캘린더, Float 같은 타임라인으로 나왔다. 일곱 페이지에 클릭되는 시안 20개가 지금 화면 스크린숏 옆에 놓였다.
에이전트 여러 개가 따로 만든 시안 20개가 의견 20개가 아니라 디자인 시스템 하나처럼 보인 건 이 기반 덕이다. 그리고 287 → 104라는 숫자가 있으니 「더 깔끔해 보이냐」로 다툴 일이 없었다.
유저 스토리로 레드팀하기
보기 좋게 만드는 건 쉬운 부분이다. 그래서 유스케이스와 유저 스토리를 기준으로 한 번 더 보라고 했다.
에이전트는 제품 기획 문서에서 페르소나 다섯 명을 꺼내 와 시안마다 전체 흐름을 따라 걸어 봤다. 그리고 전부 1280×800에서 다시 돌렸다. 현장 교육에 실제로 들고 가는 노트북 크기다. 겉을 아무리 다듬어도 고치지 못했을 빈틈이 열 개 나왔다. 그중 몇 개만 꼽으면 이렇다.
- 아직 수업 계획이 없는 교육을 보여 주는 캘린더가 하나도 없었다.
- 당일 쓰는 QR 코드가 마우스를 올려야만 보이는 아이콘 뒤에 있었다. 현장의 터치스크린에서는 못 쓴다.
- 정산은 교육 단위, 월 단위로 하는데 표는 기관 단위였다. 할 일을 찾으려면 기관을 하나씩 열어 봐야 했다.
- 공용 사이드바에서 로그아웃, 테마, 글자 크기가 빠져 있었다. 없어지기 전까지는 아무도 모르는 것들이다.
필요한 페이지에는 네 번째 시안을 만들었다. 대부분 기존 시안들의 좋은 부분을 합친 거였다. 그리고 페이지마다 추천안 하나와 만들 순서를 정해 줬다. 두 번을 합쳐 35분쯤, 22달러쯤 들었다.
그날 저녁, 이 방식을 스킬로 남겨 두라고 했다. 이름과 트리거와 절차를 적은 마크다운 파일인데 조건이 맞는 세션이면 어디서든 불러온다.
리서치를 건너뛴 날
다음 날 상태 색이 너무 많은 목록 페이지에 이 스킬을 써 봤다. 3분 뒤 실제 프론트엔드 저장소에 풀 리퀘스트가 올라와 있었다. 상태가 전부 회색이 돼 있었다. 다른 안은 아직 아무도 보지 않았는데.
I didn’t want a PR yet. Close that. Show me your usual redesigned prototype designs.
새로 나온 시안은 나쁘지 않았다. 그런데 레퍼런스가 안 좋은 쪽으로 익숙했다. AI 모델이 제일 먼저 떠올릴 법한 제품들이었다. 그래서 물었다.
Did you really run my redesign skill?
돌아온 답은 「일부만요」였다. 레퍼런스는 기억에서 골랐고 레드팀은 건너뛰었다.
그러고 나서 리서치를 제대로 했다. 내가 제일 중요하게 보는 단계가 여기다. 에이전트는 이 페이지의 정보 구조를 한 줄로 적었다. 「내가 만든 것들의 목록, 공개 범위 설정, 검토 상태, 즐겨찾기와 ⋯ 메뉴」. 그리고 AI 쪽 제품이 아니라 이 정보 구조를 가진 제품을 찾았다. GitHub 저장소 목록에서 공개 범위는 회색 「Public」 배지고 색이 있는 건 언어 점 하나뿐이다. Hugging Face Spaces. App Store Connect에서 노란색은 처리 중, 빨간색은 내가 뭔가 해야 한다는 뜻이다. YouTube 스튜디오. 반례로는 색 배지를 실제로 쓰는 Shopify Polaris.
이 리서치에서 우리 제품의 진짜 버그가 하나 나왔다. 소유자가 꼭 알아야 하는 상태 하나가 소유자에게 아예 안 보였다. 비슷한 제품은 전부 그 상태를 보여 준다. 우리 레이아웃만 이리저리 옮겼다면 절대 못 찾았을 거다. 다른 제품이 같은 상태를 어떻게 다루는지 읽어 보니까 찾았다.
건너뛸 수 없는 규칙 세 개
스킬을 단단하게 고치라고 했다. 이제 스킬은 규칙 세 개로 시작한다. 하나같이 한 번씩 빠뜨린 적이 있어서 생긴 규칙이다.
- 리디자인 요청은 PR이 아니라 시안을 뜻한다. 누가 시안을 고르기 전에는 저장소를 건드리지 않는다.
- 컴포넌트 하나라도 모든 단계를 돈다. 개수는 줄여도 단계는 줄이지 않는다. 건너뛴 단계가 있으면 답장 첫 줄에 쓴다.
- 레퍼런스는 기억이 아니라 리서치에서 온다. 정보 구조를 한 줄로 적는다. 같은 정보 구조를 가진 제품을 우리 분야 밖까지 넓혀 여섯에서 여덟 개 찾고 반례도 하나 넣는다. 시안마다 그 목록을 가리켜야 한다.
규칙마다 날짜와 이유를 달아 뒀다. 나중에 누가 「간단하게」 줄여 버리지 못하게.
세 번째 규칙은 제이콥의 법칙을 에이전트가 건너뛸 수 없는 단계로 바꿔 놓은 거다. 우리가 내놓는 것도 대부분 이렇게 만들었다. 듀오링고처럼 돌아가는 학습 플랫폼, 앱스토어처럼 돌아가는 스토어, ChatGPT처럼 돌아가는 스튜디오, Lovable처럼 돌아가는 바이브 코딩, 다른 클라우드 플랫폼 대시보드처럼 돌아가는 어드민 화면.
이슈에서 머지까지 오후 한나절
페이지가 뭐여야 하는지는 리서치가 정한다. 그 페이지가 뭘로 만들어지는지는 디자인 시스템이 정한다.
우리 디자인 시스템에는 컴포넌트와 함께 에이전트가 확인할 수 있는 규칙이 있다. 테마가 크기를 못 박아 둔다. 헤더 56px, 컨트롤 32px, 사이드바 220px, 글자 크기는 12, 13, 14, 16, 20, 모서리는 6과 8. 어드민에는 무엇을 요청받았고 어떻게 확인하는지 적은 짧은 스킬이 따로 있고 제품 결정마다 그 결정이 나온 슬랙 메시지를 링크해 둔 결정 기록도 있다.
리디자인안이 정해졌을 때는 더 정할 게 거의 없었다. 팀원 한 명이 그날 오후 에이전트와 함께 고른 시안을 만들었다. 풀 리퀘스트 일곱 개. 첫 번째가 13시 43분에 올라왔고 18시 25분에 전부 머지됐다. 11.4k줄 추가, 3.0k줄 삭제. 시안이 코드와 같은 토큰을 썼으니 작업 대부분은 옮겨 적기였다.
빈틈도 하나 있었다. 간격 단계와 44px 행 높이는 첫 풀 리퀘스트에서 미뤄졌고 끝내 테마에 들어가지 못했다.
이틀 동안 실제로 쓰고 나서 남은 것
그다음 사람들이 쓰기 시작했고 48시간 안에 절반쯤이 바뀌었다.
- 정해 둔 크기: 헤더, 컨트롤, 글자
- 캘린더 구조
- 대시보드: 그날 바로 되돌림
- 기관 서랍: 표 하나로
- 계정: 사람 목록 표 하나로 축소
- 기관 상세: 이틀 뒤 한 번 더 축소
다시 만든 넷 중 셋은 덜어 내는 쪽이었다. 기반은 버텼다. 바뀐 건 그 위에 얼마나 얹느냐였다.
레드팀에는 페르소나가 다섯 명 있었지만 페르소나는 반박하지 않는다. 페이지마다 어떻게 돌아가야 하는지는 리서치가 알려 줬다. 그중 얼마나 필요한지는 쓰는 사람만 알려 줄 수 있었다.
[Sean: 절반이 줄어든 걸 알고 난 지금, 다음엔 뭘 다르게 할지.]
써 보기
이 스킬은 공개돼 있다. 우리 도구에만 해당하는 내용은 빼고 다시 썼다. Claude Code, Codex, Cursor, 그리고 skills CLI가 지원하는 다른 에이전트에서 쓸 수 있다.
npx skills add spark33/spark33.github.io --skill ui-redesign-variants
토큰, 셸, 캡처와 점검 스크립트, 인덱스 빌더가 든 킷까지 포함한 소스는 GitHub에 있다.
내 초고와 인터뷰를 바탕으로 에이전트와 초안을 쓰고, 내가 고쳤다.