기능정의 — 번호표가 개발 질문을 줄인다
스크린샷만 넘기면 완성된 순간만 보입니다. 번호표를 붙이면 개발 질문이 「이게 뭐예요」에서 「이 번호의 예외는요」로 바뀝니다. 공개 열람에는 패널이 없습니다.
스크린샷만 넘기면 개발자는 완성된 순간만 봅니다. 번호표를 붙이면 질문이 「이게 뭐예요」에서 「이 번호의 예외는요」로 바뀝니다. 클라비의 기능정의는 화면 왼쪽 UI 위에 번호를 붙이고, 오른쪽에서 [n]으로 화면·동작·유효성을 적는 산출물입니다.
공개 열람에서는 이 패널이 안 보입니다. 2026년 9월, 화면설계 갤러리에서 중고 거래 앱 열람하기를 열면 헤더에 「6개 화면」「읽기 전용」이 있고, 점 격자 캔버스 위에 iframe 화면만 붙어 있습니다. 홈, 글 목록, 글 상세, 글 올리기, 채팅, 내 글. 각 360 × 780. 기능정의를 쓰려면 로그인한 내 화면이 필요합니다.
이 글은 갤러리 입구 소개가 아닙니다. 번호표를 어떻게 달고 세 칸을 어떻게 쓰는지, 개발 질문을 줄이는 쪽을 남깁니다.
스크린샷 더미와 번호표
캡처는 한 장면을 고정합니다. 개발은 빈 목록, 잘못된 입력, 다음 화면을 매일 만납니다. 화살표를 그어 넘기면 그린 사람의 의도만 남고, 타깃 이름이 흔들립니다. 번호표는 화면에 보이는 문구를 그대로 가리키고, 오른쪽 [n]이 그 다음 동작을 적습니다.
| 넘기는 것 | 개발자가 보는 것 | 돌아오는 질문 |
|---|---|---|
| 캡처 PNG | 완성된 한 장면 | 이 버튼은 뭐가 나와요? |
| 화살표 메모 | 그린 사람의 의도 | 빈 목록은요? |
| 번호표와 [n] | 타깃과 다음 동작 | 이 번호의 에러 문구는요? |
세 칸만 씁니다
기능정의의 허용 섹션은 화면, 동작, 유효성뿐입니다. 화면 개요, UI 구성요소, 클릭 동작 정의 같은 제목은 쓰지 않습니다. 제목이 늘면 같은 말을 세 번 쓰게 됩니다.
화면
이 화면이 하는 일 한 줄입니다. 중고 거래 홈이면 「한 동네 글을 보고 카테고리를 고른다」면 충분해요. 번호마다 화면 설명을 늘리지 마세요. 한 줄이 안 나오면 그 화면의 목적이 아직 없는 겁니다.
동작
각 줄은 「번호. 타깃 | 설명」입니다. 타깃은 화면에 보이는 버튼·링크·카드 문구 그대로. 번호표를 그 위에 붙입니다. 화면에 점이 없는 규칙(권한, 리다이렉트)은 타깃을 - 로 둡니다. 설명은 클릭·입력 뒤 무엇이 일어나는지 한두 문장이고, 동사로 끝냅니다.
홈에서 예를 들면 이렇습니다.
1. 전체 | 카테고리를 누르면 그 분류의 글만 보여 준다.
2. 글 카드 | 카드를 누르면 글 상세로 간다.
글 상세를 열면 하단에 「채팅하기」가 있습니다. 타깃은 그 네 글자입니다. 「문의 버튼」으로 바꾸면 번호표와 화면이 어긋납니다. 화면에 적힌 말을 그대로 쓰세요.
유효성
입력·에러 메시지가 있을 때만 적습니다. 없으면 이 칸을 생략합니다. 형식은 필드명: 사용자에게 보이는 메시지. 홈처럼 읽기 위주 화면은 유효성 칸이 비는 게 정상입니다. 글 올리기처럼 입력이 있는 화면에서만 엽니다. 화면에 없는 에러 문구를 지어 내지 마세요.
번호표를 다는 기준
번호를 많이 다는 일이 목적이 아닙니다. 아래 세 가지를 통과한 것만 붙입니다.
- 화면에 있는 것만. 없는 기능을 만들지 않습니다. 캡처에 없는 알림을 동작에 넣으면 그 순간부터 스펙이 거짓말입니다.
- 반복은 번호 하나. 같은 카드·리스트가 여러 장이면 하나로 묶습니다. 중고 거래 홈의 글 카드가 두 장이어도 번호는 하나입니다.
- 헤더·푸터는 홈만. 공통 컴포넌트는 홈을 제외한 화면에서 번호표로 잡지 않습니다. 글 목록에서 다시 하단 탭을 적지 마세요.
되는 것 vs 안 되는 것
- 되는 것. 로그인 뒤 왼쪽 번호표와 오른쪽 화면·동작·유효성을 쓴다. 개발 패키지 ZIP에 화면 HTML, 기능정의 MD, README가 묶인다. README는 screens/ HTML을 기획 화면이라 부르고, 같은 화면과 동작을 운영 앱으로 다시 구현하라고 적는다. 스펙이 비면 「기능정의가 아직 없습니다」 한 줄이다. 무료 플랜은 프로젝트 1개, 화면 20장이다.
- 안 되는 것. 공개 열람 캔버스에서 기능정의를 쓰거나 편집한다. 게스트 14일 쿠키로 화면을 그린다. 화면 편집은 로그인이 필요하다. ZIP HTML을 그대로 배포한다. 스크린샷 더미를 기능정의 대신 넘긴다.
공개 링크는 비로그인 열람 전용입니다. 번호표를 다는 작업은 계정에 붙습니다.
자주 묻는 질문
공개 열람에서 기능정의가 안 보여요
안 보이는 게 맞습니다. 중고 거래 열람은 읽기 전용 iframe 화면입니다. 오른쪽 패널은 로그인한 내 화면설계에 있습니다. 남의 와이어를 보는 일과 내 화면에 번호를 다는 일을 같은 주소에 넣지 않은 겁니다.
스크린샷에 화살표만 그려 넘기면 안 되나요
장면은 전달됩니다. 타깃 이름과 예외는 전달되지 않습니다. 개발사에 넘길 최소 패키지는 화면 목록·목적·상태·예외·용어입니다. 번호표는 그 패키지를 화면 위에 붙인 형태예요. 화살표 메모는 그린 사람만 알아봅니다.
지금 화면설계에서 중고 거래 와이어를 먼저 보세요. 내 화면에 번호표를 붙이려면 로그인한 뒤입니다. 아이디어가 한 줄이면 기획 인터뷰로 이어지고, 갤러리 입구는 화면설계 갤러리에, 넘기기 직전 점검은 개발사 기획서 전달에 있습니다. 질문은 상담에서 이어집니다. 이 글은 성공담 모음이 아니라 정찰 기록입니다. 아이디어 한 줄이면 시작됩니다.
