[번역] 에이전트 시대의 Pure UI
에이전트가 코드를 작성할 때 UI 상태를 명시하는 일이 더 중요해지는 이유.
이 글은 원저자 Matt Rothenberg의 Pure UI in the Agentic Era를 허락을 받아 번역한 글입니다.
옮긴이 안내: 원문의 조작형 예제는 표와 텍스트로 옮겼습니다. 각 예제에 연결한 원문 링크에서 화면을 직접 조작할 수 있습니다.
기예르모 라우치(Guillermo Rauch)의 Pure UI는 프런트엔드 개발자인 제게 유용한 원칙을 알려 줬습니다. 가능하면 UI는 “애플리케이션 상태의 순수 함수”여야 한다는 것입니다.
저는 UI를 DOM을 바꾸는 이벤트 핸들러의 집합으로 보던 시각에서 벗어나, 특정 시점의 데이터를 담은 스냅샷으로 보기 시작했습니다.
ui = fn(state)
| 입력 | 선택할 수 있는 값 |
|---|---|
| 역할 | 소유자(Owner), 조회자(Viewer) |
| 요금제 | Pro, Free |
| 결제 상태 | 납부 완료(Paid), 연체(Past due) |
| 실시간 로그 베타 | 켜짐(On), 꺼짐(Off) |
설명을 위해 만든 이 예제에서는 계정마다 조금씩 다른 화면이 보입니다. 사람이든 에이전트든 이 화면을 수정하려면 어떤 상태에 영향을 주는지 알아야 합니다.
스토리북은 이미 이런 방식으로 동작합니다. 입력을 고르면 컴포넌트를 렌더링합니다. 프런트엔드 팀은 수년 전부터 이렇게 상태별 화면을 미리 보고 테스트해 왔습니다. 제가 이 방식을 계속 떠올리는 이유는, 이제 제가 리뷰하는 UI 코드 대부분을 에이전트가 작성하기 때문입니다.
조건에 따라 UI가 많이 달라지는 제품에서는 이 문제가 특히 중요합니다. 무료 계정과 기업용 계정, 소유자와 조회자 역할, 미납 청구서, 기능 플래그(feature flag), 지역별 규칙, 특정 고객만을 위한 예외까지. 모두 ui = fn(state)라는 단순한 식에 들어가는 입력입니다.
사람이 일하든 에이전트가 일하든, 대부분의 팀은 UI가 어떤 상태를 가질 수 있는지 온전히 파악하지 못합니다. 관련된 조합을 모두 손으로 클릭해 보는 사람은 없습니다. 에이전트가 구현 작업을 점점 더 많이 맡는 상황에서, 변경의 영향을 받을 상태를 빠짐없이 고려했는지 어떻게 알 수 있을까요?
상태는 여기저기 흩어져 있습니다
실제 제품에서는 화면을 결정하는 상태가 하나의 깔끔한 객체로 들어오는 경우가 드뭅니다. 역할은 쿼리에서, 요금제는 컨텍스트에서, 결제 상태는 조건에 따라 배너를 렌더링하는 레이아웃에서 가져올 수 있습니다.
기능을 만들 때 저는 먼저 그 화면이 어떤 상태를 가질 수 있는지 알고 싶습니다. 규모가 큰 리액트 앱에서는 컴포넌트만 봐서는 알기 어렵습니다. 훅, 프로바이더, 상위 레이아웃을 살펴보고 그 내용을 머릿속에 담아 두어야 합니다.
<FunctionsPage functions={functions} />
| 상태 | 읽는 곳 | 실제 출처 |
|---|---|---|
| 역할 | useSession() | 다섯 단계 위의 AccountProvider |
| 요금제 | usePlan() | 앱 루트에서 설정한 컨텍스트 |
| 결제 상태 | <BillingGate> | 네 단계 위의 레이아웃 래퍼 |
| 실시간 로그 베타 | isOn("live_logs") | 전역 플래그 클라이언트 |
원문에서 강조된 값들은 각각 이 컴포넌트보다 위에 있는 트리의 서로 다른 곳에서 옵니다.
제 컴퓨터에서는 잘 보이는데요
에이전트에게 함수 목록의 각 행에 삭제 기능을 추가해 달라고 요청합니다. 조회자 역할인 사람에게는 이 기능이 보이면 안 된다는 말을 깜빡합니다. 몇 분 뒤 에이전트가 보고합니다.
함수 목록의 각 행에 삭제 기능을 추가해 주세요.
| 작업 | 결과 |
|---|---|
FunctionsTable.tsx 수정 | +41 |
api/functions.ts 수정 | +12 |
npm run typecheck 실행 | 통과 |
localhost:5173/functions 열기 | 화면 확인 |
완료했습니다. 이제 함수 목록의 각 행에 삭제 기능이 있습니다. 함수를 삭제하면 목록을 새로 불러옵니다. 브라우저에서 확인했으며 화면도 올바르게 표시됩니다.
functions.png
네 단계 모두 성공했습니다. 스크린샷은 한 장입니다. 개발 서버에 이미 로그인되어 있던 계정으로 찍은 화면이죠.
어쨌든 에이전트가 테스트한 계정에서는 기능이 완성됐습니다. 제 로컬 개발 서버에서는 소유자 역할로 프로덕션 환경에 로그인한 상태였습니다. 같은 페이지를 조회자 역할로 보면 이렇습니다.
| 에이전트가 본 화면 · 소유자 | 같은 페이지를 조회자로 본 화면 |
|---|---|
각 행에 Delete 버튼이 보입니다. | 헤더에는 View only가 표시되는데, 각 행에는 여전히 Delete 버튼이 보입니다. |
페이지도 데이터도 같고 역할만 다릅니다. 헤더에는 ‘조회 전용(View only)’이라고 표시되지만, 표에는 여전히 ‘삭제(Delete)’ 버튼이 있습니다.
설명을 위해 만든 예제지만, 제가 일해 본 거의 모든 리액트 코드베이스에서 비슷한 상황을 봤습니다. 헤더는 역할을 알고 있습니다. “조회 전용” 배지를 표시하니까요. 하지만 표는 모릅니다. 애초에 역할을 확인하는 코드가 없었고, 제 프롬프트도 에이전트에게 그 컴포넌트만 수정해 달라고 했습니다.
에이전트에게 더 꼼꼼히 확인해 달라고 요청할 수는 있습니다. 다른 계정과 해당 데이터가 준비되어 있다면 브라우저를 조작하고, 다른 계정으로 로그인하고, 스크린샷을 비교할 수 있습니다. 하지만 구체적으로 지시하지 않으면, 우연히 처음 마주친 상태만 확인하고 성공했다고 할 수도 있습니다.
사람도 이런 경우를 놓칩니다. 차이가 있다면 에이전트는 상태를 하나만 확인했든 열여섯 개를 확인했든 똑같이 자신 있게 “완료”라고 보고할 수 있다는 점입니다. 반면 생성된 변경 사항 하나하나를 리뷰하는 데 쓰는 시간은 줄어들고 있습니다.
테스트는 골라 둔 상태만 확인합니다
테스트는 도움이 됩니다. 하지만 누군가 작성해 둔 경우만 확인합니다. 컴포넌트가 훅으로 상태를 읽는다면, 각 테스트에서 렌더링하기 전에 해당 훅을 모킹해야 할 수도 있습니다. 화면 표시에 필요한 상태를 명시적인 입력으로 받으면, 테스트에서 원하는 조합을 곧바로 렌더링할 수 있습니다.
Dashboard.test.tsx · Vitest Browser
import { expect, test } from "vitest";
import { render } from "vitest-browser-react";
import { Dashboard, type DashState } from "./Dashboard";
test("renders a Free viewer", async () => {
const state: DashState = {
role: "Viewer",
plan: "Free",
billing: "Paid",
beta: "Off",
};
const { getByText } = await render(
<Dashboard s={state} uid="viewer-free" />,
);
await expect.element(getByText("View only")).toBeInTheDocument();
await expect.element(getByText("Pro only")).toBeInTheDocument();
});
통과 — DOM 검증 2개. 조회자 · Free · 납부 완료 · 베타 꺼짐.
| 검증 | 결과 |
|---|---|
getByText("View only") | 통과 · 요소를 찾았습니다. |
getByText("Pro only") | 통과 · 요소를 찾았습니다. |
렌더링한 화면들
| 화면 | 결제 상태 · 베타 |
|---|---|
| 조회자 · Free | 납부 완료 · 베타 꺼짐 |
| 소유자 · Pro | 납부 완료 · 베타 켜짐 |
| 조회자 · 연체 | 연체 · 베타 꺼짐 |
| 조회자 · 베타 켜짐 | 납부 완료 · 베타 켜짐 |
어떤 상태든 골라 보세요
기예르모는 애플리케이션의 상태를 “아트보드(artboard)”로 렌더링해 나란히 배치했습니다.
애플리케이션이 동작할 수 있는 서로 다른 상태 20개를 구상해 전달했다면, 그 상태들이 화면에 HTML로 렌더링된 모습을 명확하게 볼 수 있어야 합니다.
화면 출력이 fn(state)에 가까우면, 원하는 입력 조합을 골라 렌더링하고 머지 전에 변경의 영향을 확인할 수 있습니다.
원문 맨 위의 대시보드는 역할, 요금제, 결제 상태, 실시간 로그 베타 플래그라는 네 가지 입력을 받습니다. 이 데모에서는 각 입력이 두 가지 값을 가지므로 화면은 열여섯 가지입니다. 원문의 격자는 에이전트가 만든 페이지로 그 화면을 모두 렌더링합니다. 앞서 에이전트가 확인한 것은 청록색 테두리가 있는 화면 하나뿐입니다.
원문에서 ‘에이전트가 확인한 화면(What the agent checked)’과 ‘모든 상태(Every state)’ 전환하기
에이전트가 만든 페이지를 열여섯 번 호출한 결과입니다. 에이전트는 첫 번째 화면만 확인했습니다. 주황색 화면 여덟 개는 조회자 역할입니다. 헤더에는 조회 전용이라고 표시되지만, 모든 행에 삭제 버튼이 있습니다. 원문에서 화면을 클릭하면 원래 크기로 볼 수 있습니다.
격자를 보면 앞서 나온 버그가 드러납니다. 주황색 테두리가 있는 화면 여덟 개는 조회자 역할입니다. 헤더와 표를 비교해 보세요.
이 화면에서는 계정 열여섯 개를 준비하는 것보다 상태 열여섯 가지를 렌더링하는 편이 비용이 적게 듭니다. 코드 변경 내역을 보는 것보다 화면을 격자로 나열해 훑는 편이 빠릅니다.
화면에 필요한 상태를 명시하세요
스토리북과 Playwright가 여기서 유용합니다. 두 도구는 Pure UI와 함께 사용할 수 있습니다. 스토리북은 선택한 컴포넌트 상태를 렌더링할 공간을 제공합니다. Playwright는 실제 앱에서 그 상태에 도달할 수 있는지 확인합니다. 어느 쪽이든 누군가는 역할, 결제 상태, 플래그, 데이터의 어떤 조합이 중요한지 정해야 합니다.
Pure UI도 그 결정을 대신해 주지는 않습니다. 다만 결정한 내용을 더 명확하게 기록할 자리를 마련해 줍니다. 화면 표시에 영향을 주는 상태를 명시적인 입력으로 받으면, 그 API는 출력을 바꿀 수 있는 요소의 목록이 됩니다. 그러면 그 상태들을 스토리, 테스트, 화면 격자로 옮기기도 쉬워집니다.
리팩터링할 때는 화면 표시에 필요한 상태를 페이지나 뷰의 명확한 경계로 모으고, 확인하려는 부분에 인자로 전달합니다. 페이지 전체로 보면 다음과 같은 모습입니다.
| 컴포넌트 | 선언된 프롭 |
|---|---|
FunctionsPage | functions |
PageHeader | title |
UsageCard | usage |
FunctionsTable | functions |
BulkBar | selected |
FunctionRow | fn |
RowMenu | fn |
원문 트리에 선언된 프롭은 일곱 개입니다. 원문 그림의 점선은 프롭에 드러나지 않은 읽기 15회를 나타냅니다.
그 확신의 근거를 물어보세요
기예르모는 디자이너가 모든 것이 잘되는 화면만 그리지 않기를 바랐습니다. Lorem Ipsum으로 채운 목업도 같은 문제가 있습니다. 사람들이 실제로 마주하는 조건 대신 이상적인 상태 하나만 보여 줍니다. 계정 하나만 확인하는 에이전트도 같은 부분을 놓칩니다.
머지하기 전에 에이전트가 실제로 무엇을 봤는지 물어보세요. 계정 하나는 경로 하나일 뿐, 그 화면의 모든 상태를 보여 주지는 않습니다. 중요한 상태들을 살펴본다고 모든 문제를 잡을 수는 없습니다. 그래도 더 확신을 갖고 배포할 수 있고, 고객이 마주하기 전에 곤란한 문제를 발견할 기회도 늘어납니다.
원저자 소개
Matt Rothenberg는 뉴욕에서 활동하는 디자이너이자 개발자입니다. Cloudflare에서 디자인 시스템을 관리하고 디자인 엔지니어링 팀을 이끌고 있습니다. 이전에는 GitHub Next에서 소프트웨어 개발의 미래를 탐구하며 Copilot 개발에 참여했습니다. 저자 웹사이트에서 더 많은 글과 작업을 볼 수 있습니다.
이전 글이 없습니다