> ## Content Index
> Fetch the complete content index at: https://zerodraftlab.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# 유저 플로우 그리는 법: 행복 경로 먼저, 에러 경로로 닫는다 (도형 7가지·회원가입 예시)
- URL: https://zerodraftlab.com/user-flow-diagram-guide/
- Published: 2026-11-14T00:00:00.000Z
- Updated: 2026-11-14T00:00:00.000Z
- Description: 유저 플로우는 어느 화면에서 무엇을 누르면 어디로 가는지 그린다. 도형 7가지, 흐름의 세 종류, 행복 경로와 에러 경로를 그리는 순서를 user-flow-diagram 스킬 원문 순서대로 정리했다.
- Author: JooMong
- Tags: 무료

웹사이트의 루트 URL에서 시작해 사용자가 어느 화면을 거쳐 어디에 도착하는지 그린 그림을 유저 플로우(user flow)라고 부른다. 페이지의 계층만 보여 주는 사이트맵과 달리, 유저 플로우는 이동의 순서와 갈림길을 보여 준다. Owl-Listener/designer-skills 저장소의 user-flow-diagram 스킬은 AI 에이전트가 이 그림을 정해진 규칙으로 그리게 하는 짧은 지침이다.

원문은 아래 SKILL.md 파일이다. 이 글은 2026년 9월 28일 main 브랜치의 내용을 원문 순서대로 설명한다.

[Owl-Listener/designer-skills — user-flow-diagram/SKILL.md](https://github.com/owl-listener/designer-skills/blob/main/prototyping-testing/skills/user-flow-diagram/SKILL.md?ref=zerodraftlab.com)

저장소 README는 이 묶음을 "33개 플러그인, 5개 컬렉션에 걸친 스킬 273개와 명령 76개"로 소개한다. Claude Code와 Gemini CLI를 대상으로 하고 MIT 라이선스다. user-flow-diagram은 그중 프로토타이핑·테스트(prototyping-testing) 컬렉션에 들어 있다. 9월 28일 조회 기준으로 저장소 스타는 2,777개, skills.sh 설치 수는 약 2,000회다. SKILL.md 본문은 41줄이다.

## 무엇을 그리고, 무엇을 그리지 않나

원문의 설명은 한 줄이다. 화면 단위의 경로, 결정 지점, 분기 논리를 그린다. 기능을 사용자가 어떻게 지나가는지 명세할 때 쓴다. 처음부터 끝까지의 감정 흐름은 같은 저장소 design-research 컬렉션의 `journey-map` 스킬로 넘긴다.

그러니 이 스킬이 답하는 질문은 "어느 화면에서 무엇을 누르면 어디로 가나"다. "그때 사용자가 어떤 기분인가"는 범위 밖이다.

## 도형 일곱 가지

원문은 흐름도의 요소를 도형과 짝지어 정한다.

| 요소                     | 뜻               | 도형               |
| ---------------------- | --------------- | ---------------- |
| 진입점(Entry point)       | 사용자가 흐름에 들어오는 곳 | 원 또는 타원          |
| 화면·페이지(Screen/page)    | 사용자가 보는 화면      | 직사각형             |
| 결정(Decision)           | 갈림길             | 마름모              |
| 행동(Action)             | 사용자가 하는 일       | 모서리가 둥근 직사각형     |
| 시스템 처리(System process) | 백엔드에서 일어나는 일    | 양옆에 세로줄이 있는 직사각형 |
| 종료점(End point)         | 흐름이 끝나는 곳       | 테두리가 있는 원        |
| 연결선(Connector)         | 흐름의 방향          | 화살표              |

## 흐름의 세 종류

- **태스크 플로우(Task flow)**: 특정 과업 하나를 위한 한 줄짜리 경로.
- **유저 플로우(User flow)**: 사용자 유형이나 선택에 따라 여러 갈래로 나뉘는 경로.
- **와이어 플로우(Wire flow)**: 흐름에 와이어프레임 축소 화면을 붙인 것.

## 그리는 순서

1. 이 흐름이 이루려는 목표를 정한다.
2. 진입점을 찾는다.
3. 행복 경로(happy path), 곧 아무 문제 없이 목표에 닿는 경로부터 그린다.
4. 결정 지점과 분기를 더한다.
5. 에러 경로와 복구 경로를 그린다.
6. 이탈 지점을 표시한다.
7. 뒤에서 일어나는 시스템 동작을 적는다.

그림에는 주석을 단다. 화면 이름과 핵심 내용, 분기마다의 결정 기준, 에러 조건과 처리 방식, 시스템 이벤트와 알림, 시간 지연이나 비동기 처리가 주석 대상이다.

## 원문의 모범 사례

- 사용자 목표 하나에 흐름도 하나를 그린다.
- 행복 경로로 시작하고 복잡함은 나중에 더한다.
- 에러와 예외 경로를 넣는다.
- 한 그림에 분기를 너무 많이 넣지 않는다.
- 표기법을 일관되게 쓴다.
- 모든 화살표에 그 이동을 일으키는 계기나 행동을 적는다.

## 예시: 회원가입 흐름에 적용하면

아래는 원문 절차를 가상의 회원가입 기능에 적용한 ZDL의 예시다. 원문에 있는 예시가 아니다.

1. 진입점: 랜딩 페이지 `/`의 "무료로 시작" 버튼.
2. 화면: 가입 폼 `/signup`.
3. 행동: 이메일과 비밀번호를 입력하고 제출한다.
4. 시스템 처리: 이메일 중복을 확인한다.
5. 결정: 이미 가입한 이메일인가? 예이면 "이미 가입된 이메일입니다"라는 안내와 함께 `/login`으로 보낸다. 아니오이면 인증 메일을 보낸다.
6. 화면: 인증 대기 `/verify`.
7. 에러 경로: 인증 링크가 만료됐으면 재발송 버튼을 눌러 인증 메일 발송 단계로 돌아간다.
8. 종료점: 인증을 마치면 `/dashboard`.

모든 화살표에 계기를 적으라는 규칙을 따르면, 5에서 6으로 가는 화살표에는 "인증 메일 발송 완료"가, 7의 화살표에는 "링크 만료"라는 조건이 붙는다. 이렇게 적다 보면 "만료된 링크를 누른 사용자는 정확히 어느 화면을 보나" 같은, 아직 설계하지 않은 화면이 드러난다.

![가상의 회원가입 흐름을 진입점·화면·행동·시스템 처리·결정·종료점 도형으로 그리고, 링크 만료 에러 경로가 인증 메일 발송 단계로 돌아가는 모습을 보여 주는 유저 플로우 도식.](https://storage.ghost.io/c/da/13/da13bbbc-4992-4354-bf2c-1426bcf8788c/content/images/2026/11/user-flow-diagram-skill.png)

## 해석: 짧은 지침이 맡는 일

여기부터는 ZDL의 해석이다. 이 스킬은 표기법과 순서를 정하는 41줄짜리 지침이다. 사이트를 크롤하거나 실제 URL을 모으는 기능은 없다. 에이전트에게 기능 설명이나 경로 목록을 주면, 그것을 규칙에 맞는 흐름도로 정리하는 역할이다. 이미 운영 중인 사이트의 동선을 그리려면 라우트 목록이나 사이트 탐색 결과를 먼저 마련해 넘겨야 한다.

원문은 결과물을 어떤 도구로 그릴지도 정하지 않는다. Mermaid 코드로 나올 수도, 글로 된 목록이나 도형 설명으로 나올 수도 있다. 쓸 때 "Mermaid flowchart로" 또는 "화이트보드 도구에 옮길 수 있게 노드와 화살표 목록으로"처럼 출력 형식을 함께 지정해야 결과를 예측하기 쉽다.

가장 쓸모 있는 규칙은 "행복 경로 먼저, 그다음 에러 경로"와 "모든 화살표에 계기"다. 이 두 규칙은 설계자가 행복 경로만 그리고 멈추지 못하게 한다. 위 예시에서 만료된 인증 링크처럼, 행복 경로만 그렸다면 보이지 않았을 화면이 그림 위에 올라온다.

## 읽을 때 유의할 것

이 글은 SKILL.md 원문을 설명한 것이다. 스킬을 실제 기능에 돌려 결과물의 품질을 확인하지는 않았다. 스타 수와 설치 수는 9월 28일 조회 값이다.

설치 방법은 두 가지다. README는 Claude Code 안에서 `/plugin marketplace add Owl-Listener/designer-skills`로 저장소를 등록한 뒤 `/plugin` 화면에서 필요한 컬렉션을 고르는 방법을 안내한다. 이 스킬 하나만 필요하면 skills CLI로 `npx skills add owl-listener/designer-skills -g -a claude-code -s user-flow-diagram --full-depth -y`를 쓸 수 있다. `-s`로 스킬 이름을 지정하지 않으면 저장소의 다른 스킬까지 함께 설치될 수 있는데, 이 저장소에는 스킬이 273개 있다.