본문 바로가기
v2.0
운영 — 거버넌스

거버넌스
(UX Writing Governance)

규칙만으로는 부족하다 — 체계가 일관성을 만든다

좋은 글쓰기 원칙은 문서 속에 머물러서는 안 됩니다. 조직의 도구·프로세스·문화에 내재화되어야 비로소 일관된 시민 경험이 만들어집니다. 6가지 운영 조건에 더해 대표 사이트 순회, 사례 승격, 새 실화면 10분 판정, UX/UI 검수 질문을 같은 운영 체계로 묶습니다.

개요

UX Writing 거버넌스는 "좋은 글쓰기를 위한 조직적 인프라"입니다. 개인의 노력이 아니라 시스템이 일관성을 보장합니다.

#조건핵심 목표주요 담당
단일 진실 공급원 마스터 문서 1개 — 부서별 사본 금지 UX Writer PM
Figma 컴포넌트 결합 버튼·폼 기본 텍스트를 규칙 예시로 세팅 디자이너 UX Writer
Living Glossary 금지어·대체어 DB화, 개발 상태값 동기화 UX Writer 개발
UX Writing QA 의무화 배포 전 텍스트 검수 프로세스 강제화 PM UX Writer
라이팅 자동화 (Linting) 주관 부사·이중 피동 자동 경고 도구 개발 UX Writer
철학 내재화 교육 규칙 암기 전 "왜" 먼저 — 정기 교육 PM UX Writer
왜 6가지 조건인가? UX Writing 실패의 90%는 나쁜 글쓰기가 아니라 나쁜 운영 구조에서 비롯됩니다. 가이드라인이 문서로만 존재하면, 담당자가 바뀌는 순간 규칙도 사라집니다. 6가지 조건은 사람이 아닌 시스템이 일관성을 유지하도록 만듭니다.

① 단일 진실 공급원 (Single Source of Truth)

UX Writing 기준은 반드시 한 곳에만 존재해야 합니다. 부서마다 "우리 버전"의 가이드라인이 생기면, 조직 전체가 다른 기준으로 글을 씁니다.

🚫 분산 구조 (현실의 함정)
기획팀 가이드라인.xlsx (2023년 버전)
개발팀 UX Writing 정리.notion
디자인팀 Figma 코멘트 모음
마케팅팀 캐치카피 규칙.pptx
✅ 단일 진실 공급원
KRDS UX Writing 가이드라인 (이 사이트)
→ 모든 팀이 이 URL을 기준으로 참조
→ 변경은 이 사이트에만 반영
→ 각 팀은 사본 없이 링크만 공유
운영 규칙
항목규칙
마스터 문서이 가이드라인 사이트 1개 — 버전 관리는 GitHub
부서별 사본 금지팀 내부 문서에 규칙을 복사하지 않음. 필요하면 URL을 링크
변경 권한UX Writer(초안) → UX Researcher·디자이너 검토 → 배포
변경 이력git commit 메시지로 추적 — 날짜·이유·담당자 명시
주기적 검토분기 1회 — 실제 서비스와 가이드라인 간 간극 점검
사본이 생기는 신호: "우리 서비스는 조금 달라서요"라는 말이 나오면 파생 가이드 문제입니다. 기관별 파생 가이드를 참고하여 오버라이드 방식으로 처리하고, 사본은 만들지 않습니다.

② Figma 컴포넌트 결합

디자이너가 버튼 컴포넌트를 가져다 쓰는 순간, 올바른 기본 텍스트가 자동으로 따라와야 합니다. 규칙을 읽지 않아도 규칙이 적용됩니다.

컴포넌트 기본값 세팅 원칙
컴포넌트🚫 나쁜 기본값✅ 올바른 기본값
주요 버튼확인 / Button[대상 + 동사] 예: 지원금 신청하기
취소 버튼취소 / Cancel작성 내용 삭제하기
입력 레이블이름 / Label성명 (가장 보편적 명사)
플레이스홀더입력하세요 / Enter here하이픈(-) 제외, 숫자만 입력 (예: 01012345678)
오류 메시지오류가 발생했습니다[원인] + [해결 방법] 구조
빈 화면데이터 없음아직 신청한 [대상]이 없습니다. → [행동] 버튼
Figma 운영 가이드
FIGMA LIBRARY 규칙
컴포넌트 Description 필드 = UX Writing 규칙
Figma 컴포넌트의 Description에 해당 컴포넌트의 UX Writing 규칙 요약과 이 가이드라인 URL을 기재합니다.
디자이너가 컴포넌트를 선택하면 규칙이 바로 보입니다. 별도 문서를 열 필요가 없습니다.
승격된 사례를 KRDS/Figma 자산으로 넘기는 체크리스트
수집한 근거Figma/KRDS에 고정할 것같은 라운드 동기화 자산
메뉴·CTA 이름
민원 신청하기, 환급 계좌 등록하기처럼 버튼이 바로 행동을 말함
Button 기본 레이블, Description의 버튼 공식, 결과 뒤 CTA 예시2.3 버튼, 7.1 버튼, 사례 카드, Figma Button set
입력·검색 도움말
입력 범위, 형식 제한, 무검색 뒤 재검색 단서가 한 묶음으로 필요함
Text input/Search supporting text, placeholder 금지 예시, 결과 없음 기본 문구2.2 입력, 7장 Search, 사례 카드, Figma Input/Search set
상태·결과·후속 흐름
상태 1문장, 예정일, 다음 행동, 자동/별도, 이의 기한이 함께 보여야 함
Result page와 Structured list의 필수 슬롯, Notice banner 보조 문구, 상태 배지 예시3장 core-info, 4장 safety-net, 7장 Result page/Table, Figma Result/Status set
중대한 결정·비가역 경고
효력, 기한, 취소 불가, 대안 절차가 같은 첫 블록에 있어야 함
Notice banner severity, 경고 제목 공식, 보조 Link/Helper text 자리4장 safety-net, 7장 배너, CASE 52, Figma Banner/Alert set
접근성·숨은 텍스트
보이는 레이블과 스크린리더 레이블이 같은 목적·상태를 말해야 함
숨은 레이블 규칙, 새 창·토글·상태 안내 문장, QA 체크리스트 항목5장 표기, 7장 버튼·링크·아코디언, CASE 51, QA checklist
이번 라운드 KRDS/Figma 반영 예시
대표 사이트·화면KRDS 조합Description에 꼭 남길 문장기본 예시 문구숨은 레이블 메모
국민건강보험 질병명·병원 이름 검색, 피부양자·산정특례 안내, 보험료 산정Search + Auto-complete + Helper text + Accordion + Table + ButtonDescription에는 질병명 또는 병원 이름 입력 범위·재검색 단서와, 부양가족 등록·해제 대상, 중증질환 본인부담 감면 대상, 이번 달 보험료 계산 기준, 변동 신고·경감 신청·임의계속가입 CTA를 함께 적습니다.질병명 또는 병원 이름을 입력해 다시 찾아보세요 / 부양가족으로 등록하거나 해제할 가족인지 먼저 확인해 주세요 / 중증질환 본인부담 감면 대상인지 확인 / 이번 달 보험료 계산 기준 보기 / 변동 신고하기병원 이름이나 질병명으로 다시 검색하기 / 부양가족 등록·해제 대상 확인하기 / 중증질환 본인부담 감면 요건 보기 / 현재 보험료 계산 기준 보기 / 보험료 변동 신고하기 / 보험료 경감 신청 가능 여부 자가 진단하기 / 퇴직 뒤 예전 직장 보험료 계속 가입 확인하기
고용24 실업인정 인터넷 신청, 조기재취업수당 안내Notice banner + Structured list + Disclosure + ButtonDescription에는 실업급여를 확인하는 날, 이번 회차 재취업 활동, 취업한 날 기준, 조기재취업 대상 여부·확인 서류, 놓쳤을 때 결과와 다시 확인 경로를 함께 적습니다.실업급여를 확인하는 날까지 재취업 활동을 등록해 주세요 / 빨리 다시 취업했을 때 받는 수당 대상과 확인 서류 보기 / 놓쳤다면 다음 회차와 보완 경로 확인실업인정일까지 필요한 활동 보기 / 취업한 날 기준 확인하기 / 조기재취업수당 대상과 확인 서류 보기 / 실업인정일을 놓쳤을 때 다시 확인하기
서울특별시 응답소 질의응답·답변원문, 결과보기Result page + Status badge + Button + LinkDescription에는 답변 준비 상태, 답변 예정일, 나의 민원 재확인, 답변원문이 등록되면 민원 결과보기, 같은 건이 아니면 새 민원 신청 위계를 함께 적습니다.담당 기관에서 답변을 준비하고 있습니다 / 답변 예정일 2026.06.12 / 나의 민원에서 다시 확인 / 답변원문이 등록되면 민원 결과보기 / 같은 건이 아니면 새 민원 신청하기현재 답변 상태와 예정일 확인하기 / 나의 민원에서 다시 확인하기 / 기존 민원 결과 확인하기 / 같은 건이 아니면 새 민원 신청 시작하기
전자가족관계등록시스템 국적 회복 허가Result page + Notice banner + Checklist + ButtonDescription에는 한국 국적 다시 받기 같은 시민 언어 헤더와 공식 용어 병기, 1년 내 외국 국적 포기, 외국국적불행사서약 대상 여부, 외국 국적 포기 증명서 제출 경로, [요건 확인]·[신고 방법 보기] CTA를 함께 적습니다.한국 국적 다시 받기 허가 결과를 먼저 확인해 주세요 / 1년 내 외국 국적 포기와 외국국적불행사서약 대상 여부를 확인해 주세요 / 외국 국적 포기 증명서 제출 경로 확인 / 신고 방법 보기국적 회복 허가 결과 확인하기 / 외국 국적 포기 기한과 서약 대상 확인하기 / 외국 국적 포기 증명서 제출 경로 확인하기 / 국적 신고 방법 보기
정부24 전자증명서안내, 홈택스 부가가치세예정신고, 대한민국법원 가족관계등록부정정 허가Tab + Navigation + Card + LinkDescription에는 단어 경계, 행동 동사, 대상, 공식 용어 병기 기준을 함께 적습니다.무엇을 하는 메뉴인지 먼저 읽히게 하기 / 신고하기·발급하기 동사 분리전자증명서 안내 메뉴 열기 / 부가가치세 예정 신고 바로 가기 / 가족관계 기록 정정 허가 자세히 보기
정부24 긴급복지지원 신청, 홈택스 근로장려금 신청, 전자가족관계등록시스템 국적 이탈 신고Structured list + Notice banner + Badge + Helper text + ButtonDescription에는 조건 목록, 기준값, 탈락 시 영향, 자가 확인 CTA를 함께 적습니다.모든 조건을 먼저 확인해 주세요 / 소득·재산·기한 기준 보기 / 자가 확인 시작지원 요건 자가 확인하기 / 가구 유형별 기준 보기 / 국적 이탈 요건 확인하기
정부24 병적증명서 발급, 홈택스 세무대리인 수임 동의, 전자가족관계등록시스템 소송 대리인 등록Structured list + Helper text + Notice banner + ButtonDescription에는 대리 가능 대상, 증빙, 권한 범위, 해지·해임 경로를 함께 적습니다.누가 대신할 수 있는지 먼저 확인해 주세요 / 위임 범위와 종료 경로 보기 / 해지 또는 해임 확인대리 발급 요건 확인하기 / 위임 범위 자세히 보기 / 수임 해지 또는 해임 방법 보기
국민신문고 민원 유형 선택, 홈택스 휴업·폐업 신고, 대한민국법원 개인회생·파산Radio + Segmented control + Structured list + Helper text + Notice banner + LinkDescription에는 내 상황, 선택 기준, 오선택 위험, 비교·상담 CTA를 함께 적습니다.내 상황에 맞는 절차를 먼저 확인해 주세요 / 휴업·폐업·회생·파산 차이 보기 / 무료 상담 연결민원 유형 비교하기 / 휴업·폐업 차이 보기 / 개인회생·파산 비교하기
실행 규칙: 7장 컴포넌트 라이팅에서 대표 사이트 근거가 붙은 문장은 사례 카드나 화면 설명으로 끝내지 않습니다. Description, 기본 예시 문구, 숨은 레이블 메모까지 같은 라운드에서 같이 남겨야 KRDS/Figma 자산으로 바로 재사용할 수 있습니다.
Figma 컴포넌트 필드별 반영 규칙
필드무엇을 적는가대표 사이트 근거가 들어오는 자리
Description실패 패턴 1문장, 기본 공식, 금지 표현, 연결 URLCASE 번호, 대표 사이트 화면 이름, 연결 원칙
Variant / Property 이름default / warning / complete, has_deadline, has_next_action처럼 상태·정보 슬롯을 드러내는 이름상태·기한·다음 행동이 실제로 분리돼야 했던 화면 근거
기본 예시 문구디자이너가 바로 쓸 버튼, 도움말, 결과 문장 1세트사례 카드의 After 문구와 대표 사이트 원문 비교
보조·숨은 텍스트스크린리더용 목적, 새 창 여부, 토글 상태, 결과 재확인 경로접근성·숨은 텍스트 축에서 걸린 CASE와 QA 질문
실행 규칙: 사례 카드만 올라가고 Figma Description, 기본 예시 문구, 숨은 레이블 체크리스트가 비어 있으면 디자인 시스템 반영이 끝난 것으로 보지 않습니다.
기본값의 힘: 사람은 기본값을 바꾸지 않는 경향이 있습니다 (기본값 편향). 올바른 기본값을 설정하면, 규칙을 가르치지 않아도 대부분의 경우 올바른 텍스트가 나옵니다.

③ Living Glossary (살아있는 용어집)

용어는 살아있습니다. 새로운 행정 용어가 생기고, 금지어가 추가되고, 개발 상태값이 바뀝니다. 용어집은 '문서'가 아니라 '데이터베이스'여야 합니다.

용어집 4대 항목
항목내용업데이트 주기
금지어주관 부사, 과도한 행정어, 이중 피동형 등 사용하면 안 되는 단어수시 (새 오류 발견 시)
대체어금지어에 대한 올바른 표현 1~3가지금지어 등록 시 동시
행정 용어 번역행정 전문어 → 일상어 매핑 (예: 과오납 → 잘못 낸 돈)월 1회 또는 신규 용어 등장 시
개발 상태값API·DB의 status 코드 → 사용자 표시 텍스트 매핑개발 스프린트마다
🚫 고정된 용어 목록 (죽은 문서)
UX Writing 금지어 목록.xlsx
최종수정: 2024-03-15
담당자가 바뀌면 아무도 업데이트 안 함
✅ 살아있는 용어 DB
GitHub 저장소 또는 Notion 데이터베이스
→ PR로 변경 이력 추적
→ 개발 상태값 코드와 연동
→ 린터 도구가 이 DB를 참조
개발 상태값 연동 예시
API status 값🚫 나쁜 표시 텍스트✅ UX Writing 표시 텍스트
PENDINGPENDING / 대기중접수됨 — 담당자가 확인 중입니다
IN_REVIEW검토중심사 중 (영업일 기준 3~5일 소요)
SUPPLEMENTAL_REQUIRED보완 필요서류 보완 필요 — [보완 내용 확인하기]
APPROVED승인됨승인 완료 — [결과 확인하기]
REJECTED반려반려됨 — 이유를 확인하고 재신청할 수 있습니다
전 원칙 재점검 결과

최근 라운드에서 전체 가이드라인을 다시 훑어본 결과, 남은 일은 새 원칙 번호를 늘리는 것보다 각 원칙 축에 어떤 대표 사이트 근거와 KRDS 컴포넌트 연결을 더 붙여야 하는지를 선명하게 유지하는 데 있습니다. 이 표를 보고 바로 아래 순회 운영법으로 내려가면, 다음 라운드에서 무엇을 먼저 채워야 할지 빠르게 판단할 수 있습니다.

원칙 축현재 판단다음 순회에서 먼저 채울 슬롯대표 사이트KRDS 우선 축
무번역대표 행정어·제도어 사전은 넓게 채워져 있습니다복지·고용 복합 제도어, 동의·본인확인 핵심어, 세무·법원 고빈도 메뉴어를 계속 일반화합니다복지로, 고용24, 홈택스, 대한민국법원Helper text, Accordion, Disclosure, Agreement
정보핵심화결론 우선과 상태 요약 구조는 견고합니다민원·환급·심사 결과 화면의 상태 1문장 + 예정일 + 다음 행동과 완료 뒤 후속 흐름 근거를 더 쌓습니다국민신문고, 서울특별시 응답소, 홈택스, 정부24Status badge, Timeline, Result page, Table
심리적안전망오류·완료·대안 경로 기준은 살아 있습니다세션 종료, 기한 임박, 비가역 결정, 지연 상태처럼 불안이 큰 흐름을 계속 보강합니다정부24, 홈택스, 대한민국법원, 고용24Modal, Notice banner, Button, Link
표기법·맞춤법숫자·기호·복합 명사 규칙은 안정적입니다표 헤더, 상태 배지, 메뉴명에서 반복되는 기호·띄어쓰기·단위 표기를 린트 규칙과 연결합니다정부24, 홈택스, 국민신문고Table, Badge, Search, Linter
컴포넌트 라이팅주요 KRDS 컴포넌트 공식은 대부분 마련됐습니다Button/Search/Modal/Table/Structured list/Result page에서 대표 사이트 근거를 더 직접 연결합니다정부24, 홈택스, 국민신문고, 전자가족관계등록시스템Button, Search, Modal, Structured list, Table, Result page
거버넌스·부록 D순회·승격·동기화 규칙은 정리됐습니다전 원칙 재점검 결과, 다음 라운드 우선 슬롯, 테스트·코퍼스 동기화를 공개 문서에 계속 맞춥니다대표 사이트 8종 전체Corpus sync, QA checklist, Test sync
핵심 판단: 다음 라운드 우선순위는 "새 용어 몇 개를 더 찾는가"보다 "어느 원칙 축을 어떤 화면 단계와 KRDS 컴포넌트로 더 증명할 것인가"입니다. 무번역은 자격·동의·메뉴, 정보핵심화는 상태·결과·완료 뒤 후속 흐름, 심리적안전망은 오류·기한·비가역 행동을 먼저 봅니다.
대표 서비스 관찰 — 승격된 사례는 사전·사례 카드·원칙·컴포넌트를 함께 갱신한다

최근 라운드에서 확정일자, 상속포기, 지급명령 신청, 이행권고결정, 장기요양인정, 국적 회복, 협의이혼 의사확인, 개명 허가, 진정·청원·제안·신고, 휴업·폐업, 개인회생·파산을 다시 보면, 새 용어 1개를 사전에 추가하는 것만으로는 운영이 끝나지 않았습니다. 같은 실패 패턴이 반복될 때는 사전 후보 등록, 사례 카드 작성, 관련 원칙 보강, KRDS 컴포넌트 연결을 같은 묶음으로 갱신해야 다음 팀도 같은 기준으로 판단할 수 있습니다.

용어 묶음같이 갱신할 자산우선 묻는 질문KRDS 연결
확정일자 / 상속포기2.1 사전, CASE 52, 3장 core-info, 4장 safety-net, 7장 컴포넌트효력·기한·취소 불가·대안 절차가 첫 화면에서 보이는가?Notice banner, Structured list, Helper text, Link
지급명령 신청 / 이행권고결정CASE 52, 3장 core-info, 4장 safety-net, 7장 컴포넌트확정 효력, 2주 이의 기간, 소송 전환 또는 강제집행 가능성이 첫 화면에서 보이는가?Notice banner, Structured list, Helper text, Link
장기요양인정 / 개명 허가2.1 사전, CASE 55, 3장 core-info, 4장 safety-net, 7장 컴포넌트판정 기준·단계·결과 뒤 행동이 한 흐름으로 이어지는가?Step indicator, Structured list, Notice banner, Button
국적 회복 / 국적 이탈2.1 사전, CASE 32·45·46·57, 3장 core-info, 4장 safety-net, 7장 컴포넌트허가 뒤 1년 내 외국 국적 포기, 외국국적불행사서약 대상 여부, 외국 국적 포기 증명서 제출 경로, 복수 국적·병역 조건이 같은 화면 묶음으로 보이는가?Result page, Notice banner, Checklist, Button
전입신고 완료 / 장애 정도 결정 / 지급명령 이의신청CASE 31·32·33, 3장 core-info, 4장 safety-net, 7장 컴포넌트결과 직후 후속 행동·자동/별도·이의 기한이 한 블록에서 함께 보이는가?Result page, Structured list, Notice banner, Link, Button
협의이혼 의사확인2.1 사전, CASE 57·18, 4장 safety-net, 7장 컴포넌트모두 충족 조건·필수 서류·기한이 체크리스트로 먼저 보이는가?Structured list, Helper text, File upload, Button
민원 유형 / 휴업·폐업 / 개인회생·파산 / 후견 유형CASE 60, 3장 core-info, 4장 safety-net, 7장 컴포넌트어떤 상황에 맞는 절차, 선택 기준, 잘못 고를 때 재판단해야 하는 비용이 먼저 보이는가?Radio, Segmented control, Structured list, Helper text, Notice banner, Link
운영 규칙: 용어 1개 = 사전 1행이 아닙니다. 세 대표 사이트에서 같은 UX Writing 문제로 묶이면 사전 등록 → 사례 카드 → 관련 원칙·컴포넌트 보강 → QA 반영을 같은 PR이나 같은 스프린트 묶음으로 처리합니다.

흡수 규칙: 부동산 거래 신고, 공동사업장 등록, 협의이혼 의사확인처럼 공동 신청 주체가 핵심인 화면은 새 규칙 번호보다 신청인 유형별 추가 서류, 복수 조건 체크리스트 보강 대상으로 먼저 분류합니다. KRDS에서는 Fieldset/Radio + Helper text + Structured list + Notice banner 조합을 우선 검토합니다.

결합 규칙: 전입신고, 사업자 등록 사항 정정 신청, 가족관계등록부 정정처럼 온라인 가능 여부와 관할 기관이 함께 갈리는 화면은 새 규칙 번호보다 온라인/방문 분기, 담당 기관·관할 보강 대상으로 먼저 분류합니다. KRDS에서는 Radio + Helper text + Structured list + Badge + Button 조합을 우선 검토합니다.
라운드 종료 동기화 체크리스트
  • 코퍼스 상태표를 실제 산출물 기준으로 갱신했다.
  • 승격된 항목은 사전·사례 카드·원칙·컴포넌트를 같은 라운드에서 함께 반영했다.
  • 관련 테스트(tests/principles-pages-content.test.js)를 함께 갱신했다.
  • 이번 라운드에서 Layer 2 공통 패턴인지 Layer 3 기관 특화인지 판정 근거를 기록했다.
  • 사례 카드까지 올라간 항목인데 코퍼스 상태가 아직 원칙·웹·사전 반영 완료라면 라운드 종료로 보지 않는다.
Living Glossary 실패 패턴: 용어집이 특정 담당자의 개인 파일에 있으면 그 사람이 퇴사하는 순간 사라집니다. 반드시 조직이 소유하는 공용 저장소에 관리합니다.
대표 사이트 순회 운영법

대표 사이트 조사는 생각날 때 한 번 보는 방식이 아니라, 같은 순서로 반복하는 라운드 로빈 순회로 운영합니다. 한 라운드에서는 사이트별로 깊게 파기보다 같은 과업 단계와 KRDS 컴포넌트를 맞춰 비교해야 공통 원칙 후보를 더 빨리 찾을 수 있습니다.

순서사이트이번 루프 우선 과업우선 확인 컴포넌트
1정부24신청 상세, 증명서 발급Structured list, Table, Button
2홈택스신고, 납부, 경고 메시지Form, Stepper, Modal
3복지로자격 판정, 모의계산Accordion, Helper text, Banner
4국민건강보험자격·급여 설명Table, Tooltip, Notice
5전자가족관계등록시스템발급, 대리인/관계인 안내Consent, Modal, Certificate flow
6국민신문고민원 상태, 답변 확인Status badge, Timeline, Table
7고용24수당·훈련 안내, 실업인정Card, Disclosure, Search
8서울특별시 응답소결과 안내, 민원 흐름Result page, Alert, Button
사법 영역 운영 메모: 대표 사이트 8종 목록은 전자가족관계등록시스템을 고정점으로 유지합니다. 다만 완료 뒤 후속 흐름처럼 결과 직후의 기한·권리구제 문구를 봐야 하는 라운드에서는 대한민국법원 화면 1개를 보조 표본으로 함께 기록합니다. 이번 라운드의 보조 표본은 지급명령 이의신청입니다.
대표 사이트 순회 캔버스

실제 사례 추가는 새 사이트를 끝까지 읽는 방식보다, 아래 다섯 접근 방식 중 하나로 먼저 묶는 편이 빠릅니다. 각 행에서 대표 사이트 시작점, 사전에서 먼저 채울 표현, UX/UI 질문, CASE·원칙 도착지, KRDS/Figma handoff를 한 줄로 같이 적습니다.

접근 방식대표 사이트 시작점사전에서 먼저 채울 표현먼저 던질 UX/UI 질문먼저 붙일 CASE·원칙KRDS/Figma handoff
레이블·도움말 수집형국민건강보험 피부양자·산정특례 안내, 고용24 조기재취업수당 안내, 전자가족관계등록시스템 국적 이탈 신고부양가족 등록, 중증질환 본인부담 감면, 취업한 날, 1년 내 외국 국적 포기, 외국국적불행사서약 대상 여부첫 레이블과 도움말만 읽어도 대상, 기한, 준비 서류가 보이는가?CASE 2·6·57 / 2장 무번역Helper text + Notice banner + Structured list + Checklist
결과 첫 블록 재구성형서울특별시 응답소 질의응답·답변원문 / 결과보기, 국민건강보험 보험료 산정, 홈택스 국세 환급금 조회답변 예정일, 계산 기준, 예상 입금일, 민원 결과보기상태 또는 금액, 예정일, 다시 확인 CTA가 같은 첫 블록에 모이는가?CASE 3·42·56 / 3장 정보핵심화 + 7장 Result pageResult page + Status badge + Table + Button
후속 의무·권리구제형전자가족관계등록시스템 국적 회복 허가, 정부24 전입신고 완료, 대한민국법원 지급명령 이의신청1년 내 외국 국적 포기, 외국국적불행사서약 대상 여부, 자동 반영 / 별도 변경, 2주 이내 이의신청결과 뒤 남은 의무, 기한, 미이행 위험 또는 권리구제 경로가 한 흐름으로 이어지는가?CASE 31·32·33·46 / 3장 정보핵심화 + 4장 심리적안전망Notice banner + Structured list + Link + Button
검색·분기·재검색형국민건강보험 질병명·병원 이름 검색, 고용24 훈련 검색, 국민신문고 민원 유형 선택질병명 또는 병원 이름, 배우고 싶은 기술·자격증, 진정 / 청원 / 제안 / 신고입력 범위나 선택 기준, 잘못 고를 때 영향, 재검색 단서가 클릭 전에 보이는가?CASE 10·49·60 / 5장 표기법·맞춤법 + 7장 컴포넌트 라이팅Search + Radio + Segmented control + Helper text
기관 특화 보류형SeMA (Layer 3 확인용) 도슨트 예약, 오프닝 리셉션 신청, 소장품 검색도슨트, 오프닝 리셉션, 소장품 검색공통 문제를 걷어낸 뒤에도 기관 고유 과업 이름과 톤이 남는가?Layer 3 보류 / 6장 기관별 파생 가이드공통 KRDS 조합 유지 + 기관별 추가 사전
실행 규칙: 한 화면을 수집할 때도 먼저 이 다섯 행 가운데 어디에 들어가는지 고르고, 같은 줄의 사전 표현, UX/UI 질문, CASE·원칙, KRDS/Figma handoff를 같이 적습니다. 이렇게 해야 사전만 채우고 사례·원칙·컴포넌트를 나중으로 미루는 일을 줄일 수 있습니다.
이번 라운드에서 바로 다시 볼 실제 화면
사이트바로 다시 볼 화면이번 라운드에서 먼저 확인할 질문KRDS 연결
정부24전입신고 완료자동 반영과 별도 변경, 다음 기관, 체크리스트 CTA가 첫 블록에 함께 보이는가?Result page, Structured list, Link
홈택스국세 환급금 조회환급 결정 상태, 예상 입금일, 계좌 등록 또는 변경 CTA, 지연 시 확인 경로가 한 영역에 모이는가?Result page, Notice banner, Button
전자가족관계등록시스템전자 발급본 안내효력, 문서확인번호, 제출처 주의, 재출력·진위확인 경로가 첫 목록에 모이는가?Structured list, Notice banner, Button
대한민국법원 (보조 표본)지급명령 이의신청2주 기한, 제출처, 소송 전환 가능성, 다음 CTA가 첫 블록에서 함께 읽히는가?Result page, Notice banner, Link, Button
사례 카드 최소 기록 양식
필드설명
원문실제 노출 문구 또는 표 헤더
문제 패턴행정어 / 결론 후치 / 상태 모호 / CTA 모호 등
연결 원칙무번역 / 정보핵심화 / 심리적안전망 중 어느 축에 속하는가
KRDS 컴포넌트Search / Button / Table / Banner / Modal 등
개선 문구시민 언어로 다시 쓴 문장
이유왜 이 개선이 더 빠르게 이해되는가
화면 유형별 최소 기록 질문
화면 유형반드시 남길 판단 정보KRDS 연결
자격·조건대상 여부 / 기준값 / 탈락 조건 / 자가 확인 경로Structured list, Helper text, Banner
상태·결과현재 단계 / 예정일 또는 남은 기간 / 지연 시 문의 경로 / 다음 CTAStatus badge, Timeline, Result page
완료 뒤 후속 흐름후속 행동 / 자동 반영과 별도 신청·신고 / 이의·재심사 기한 / 권리구제 경로Result page, Structured list, Notice banner, Button
긴급·병행먼저 연결할 채널 / 같이 해야 할 외부 절차 / 복귀 경로 / 누락·중복 확인 경로Notice banner, Link, Structured list
대리·관할처리 기관 또는 관할 / 대리 가능 대상 / 권한 범위 / 해지·예외 경로Structured list, Helper text, Button
조회·발급·공개 범위포함 항목 / 빠지는 항목 / 효력 또는 유효기간 / 별도 확인 경로Table, Disclosure, Helper text
UX/UI 검수 보조 질문

문장만 따로 떼어 검수하지 않습니다. 같은 문장도 어디에 놓였는지, 무엇과 같이 묶였는지, 다음 행동이 바로 이어지는지에 따라 이해 속도가 달라집니다. 아래 5개 축을 같이 보면 텍스트 검수를 화면 검수와 같은 언어로 운영할 수 있습니다.

검수 축바로 볼 질문KRDS 연결
정보 위계제목·상태·기한·다음 행동 가운데 지금 가장 먼저 봐야 할 1문장이 첫 블록에 올라와 있는가?Notice banner, Result page, Structured list
선택·분기라디오·탭·세그먼트만 읽어도 옵션 차이, 대상 조건, 잘못 고를 때 불이익이 보이는가?Radio, Segmented control, Tabs, Helper text
입력·첨부해당자만 필수인지, 형식·용량 제한이 무엇인지, 실패 뒤 어디서 다시 제출하는지가 입력 바로 옆에 붙어 있는가?Text input, File upload, Helper text, Button
상태·안심남은 시간, 처리 단계, 지연 시 문의 경로, 자동 로그아웃·자동 반영 여부가 한 흐름으로 이어지는가?Modal, Status badge, Timeline, Notice banner
접근성·숨은 텍스트버튼·링크·배너가 스크린리더에도 목적과 상태를 함께 읽어 주는가? 새 창·순번·토글 여부만 남지 않았는가?Button, Link, Accordion, Tooltip
검수 규칙: 텍스트가 좋아 보여도 첫 시선에서 결론이 안 잡히거나, CTA가 떨어져 있거나, 숨은 텍스트가 목적을 설명하지 못하면 UX/UI 검수에서 다시 엽니다. 반대로 표현 하나가 약해 보여도 위계·분기·복구 경로가 살아 있으면 사전 승격보다 컴포넌트 조합 개선으로 먼저 다룹니다.
순회 로그 한 행 예시

기록 양식만 보면 실제로 무엇을 한 줄에 묶어야 하는지 감이 늦게 옵니다. 아래 예시는 이번 라운드에서 바로 다시 보는 실화면을 같은 형식으로 적은 것입니다. 한 행 안에 원문 3개, 화면 유형에 맞는 판단 정보, UX/UI 검수 축, 먼저 붙일 CASE, KRDS 조합, 같은 라운드에서 같이 갱신할 자산을 함께 남기면 수집 결과가 사전·사례·원칙·컴포넌트 갱신으로 바로 이어집니다.

사이트·화면화면 유형원문·판단 정보 묶음실패 패턴UX/UI 검수 축먼저 붙일 CASEKRDS 조합같은 라운드에서 같이 갱신할 자산
정부24 전입신고 완료완료 뒤 후속 흐름전입신고가 완료되었습니다 / 주소 변경이 완료됐습니다 / 자동 반영: 국민연금·건강보험 / 별도 변경: 자동차등록·금융기관 [변경 체크리스트]완료 사실만 먼저 보이고 자동 반영과 별도 변경, 다음 기관이 흩어짐정보 위계CASE 31·32·33Result page + Structured list + Link사례 카드, 4.2 성공·완료 메시지, 7장 Result page, 부록 D, 코퍼스·테스트
홈택스 국세 환급금 조회상태·결과국세 환급금 조회 / 환급금 120,000원 — 연말정산 과납으로 발생 / 체납 세금 20,000원 먼저 충당 / 잔액 100,000원 입금 예정 / 환급 계좌가 없으면 [계좌 등록하기], 30일 넘게 지연되면 [환급 지연 이자 안내]숫자만 보이거나 계좌 등록·지연 대응이 결과와 떨어져 보임상태·안심CASE 42·32·56Result page + Notice banner + Button사례 카드, 3장 결과 구조, 7장 Result page, 부록 D, 코퍼스·테스트
전자가족관계등록시스템 전자 발급본 안내조회·발급·공개 범위문서확인번호 / QR로 진위 확인 / 전자 발급본도 출력 시 원본과 동일 효력 / 공공 마이데이터 제출 또는 PDF 첨부 / 전자 발급본이 공문서와 동일한 효력 / 제출 전 증명서 진위확인 가능발급 완료만 보이고 효력, 제출 경로, 진위확인이 흩어짐정보 위계CASE 27Structured list + Notice banner + Link사례 카드, 2.1 사전, 7.12 표·결과, 부록 D, 코퍼스·테스트
대한민국법원 지급명령 이의신청완료 뒤 후속 흐름지급명령 이의신청 / 지급명령에 동의하지 않으면 2주 이내 이의신청하세요 / 이후 민사소송으로 전환되며 답변서 제출이 필요합니다. [이의신청 바로 가기]2주 기한, 제출처, 민사소송 전환, 바로 가기 CTA가 따로 놀음정보 위계CASE 33Result page + Notice banner + Link사례 카드, 4장 결과 불복·재심사, 7장 Result page, 부록 D, 코퍼스·테스트
실행 규칙: 한 행을 다 채우지 못하면 새 CASE 번호부터 만들지 않습니다. 먼저 같은 행 안에서 실패 패턴, 바꿀 문장, KRDS 조합, 같은 라운드 동기화 자산을 확정합니다.
한 번의 순회 최소 산출물
  • 새 사전 후보 3개 이상
  • 사례 카드 후보 2개 이상
  • KRDS 컴포넌트 보강 포인트 1개 이상
  • 공통 원칙 승격 여부 또는 Layer 3 유지 판정 1개 이상
수집 직후 분류 표
수집한 근거우선 분류바로 할 일
금지 표현 1개와 대체어가 또렷하다2.1 사전 후보principles.md 2.1, jargon-dictionary, dictionary 초안을 먼저 만든다
Before/After 한 세트로 실패 패턴이 설명된다사례 카드 후보case-studies와 archive 카드 초안을 같은 라운드에서 만든다
세 대표 사이트에서 같은 실패 패턴이 반복된다공통 원칙 후보principles.md 본문 + principles/components + QA 기준까지 함께 보강한다
특정 기관의 제도·업무에만 강하게 묶인다Layer 3 파생 가이드공통 원칙 수정은 보류하고 기관별 파생 가이드로 넘긴다
처리 중, 승인처럼 짧은 상태값만 보인다컴포넌트 규칙 후보사전보다 상태 배지·도움말·결과 화면 규칙으로 먼저 검토한다
새 실화면을 받은 직후 10분 판정 루틴
시점바로 할 일반드시 남길 기록우선 도착지
1분화면 유형 1개를 먼저 고른다자격·조건 / 상태·결과 / 완료 뒤 후속 흐름 / 긴급·병행 / 대리·관할 / 조회·발급·공개 범위화면 유형별 최소 기록 질문
3분원문 3개와 CTA 1개를 적는다첫 블록 문장, 상태값, 버튼 이름처럼 판단을 멈추게 하는 텍스트사례 카드 최소 기록 양식
5분UX/UI 검수 축 1개를 고른다정보 위계 / 선택·분기 / 입력·첨부 / 상태·안심 / 접근성·숨은 텍스트 중 가장 크게 실패한 축 1개KRDS 조합 초안
7분우선 도착지를 고른다2.1 사전 후보 / 사례 카드 후보 / 공통 원칙 후보 / Layer 3 파생 가이드 가운데 하나수집 직후 분류 표
10분같은 라운드 동기화 자산을 확정한다사전 / CASE / principles.md / principles/components / 부록 D / 코퍼스·테스트 가운데 같이 움직일 묶음같은 PR 또는 같은 스프린트 범위
실행 규칙: 10분 안에 판단을 끝내지 못해도 괜찮지만 화면 유형 + 실패 패턴 + 바꿀 문장 + KRDS 조합 + 다음 자산 다섯 칸이 비어 있으면 새 사례로 올리지 않습니다.
아카이브에서 기존 CASE 묶음으로 넘어가는 운영 경로

이슈 아카이브는 출발점이지 최종 승격 자산이 아닙니다. 대표 사이트 순회에서는 정부24·홈택스·전자가족관계등록시스템 3개 기관 deep archive를 먼저 대조하고, 새 실화면에서도 같은 판단 근거를 다시 적은 뒤 기존 CASE 묶음과 원칙·KRDS 자산으로 이어 붙입니다.

단계바로 할 일같은 라운드에서 남길 근거
1. archive 대조이슈 아카이브에서 비슷한 실패를 먼저 찾고, 정부24·홈택스·전자가족관계등록시스템 3개 기관 deep archive를 기준점으로 같은 화면 단계 실패가 이미 있는지 본다대표 사이트 3기관 deep archive 기준점, 같은 화면 단계 여부
2. 새 화면 재기록새 화면에서도 원문 3개+CTA 1개, 상태·기한·관할 같은 판단 정보 1묶음, KRDS 조합 1개를 다시 적는다새 화면 원문, 판단 정보, KRDS 조합
3. 기존 CASE 우선새 CASE 번호부터 만들지 말고 기존 CASE 묶음에 먼저 붙인다. CASE 18·58, CASE 31·32·33, CASE 52·55·56처럼 현재 묶음에서 먼저 맞는 자리를 찾는다기존 CASE 번호, 실패 패턴, 바꿀 문장
4. 승격·동기화세 대표 사이트에서 반복되면 사전·원칙·7장·Figma·코퍼스·테스트를 같은 라운드에서 같이 갱신하고, 기관 고유 제도면 Layer 3 파생 가이드로 남긴다Layer 2 / Layer 3 판정, 같은 라운드 동기화 자산
실행 규칙: 아카이브에 비슷한 카드가 있어도 새 화면 원문 없이 바로 승격하지 않습니다. 승격 단위는 용어 1개가 아니라 화면 단계 묶음입니다.
사전 승격 보류 기준: 사전에 올리지 않는 이유를 세 가지로 나눠 먼저 공개합니다. 용어 하나만 떼어내지 않고, 사전 대신 먼저 둘 곳KRDS 우선 조합까지 같이 판단합니다.
분류대표 묶음왜 사전에 바로 올리지 않나우선 도착지
구조 규칙 우선전입신고 / 사업자 등록 사항 정정 신청 / 집행문 부여 신청, 전입신고 / 사업자 등록 사항 정정 신청 / 가족관계등록부 정정핵심 문제는 용어 자체보다 온라인/방문 분기담당 기관·관할이 첫 분기 영역에서 숨는 구조입니다.7.3 선택지, 담당 기관·관할, KRDS Radio + Helper text + Structured list + Badge + Button
일반화 후 재판정이메일 / 전자고지(송달) 신청 및 해지 / 민사 등 사건진행 알림서비스채널 이름만으로는 약하고 무엇이 오고, 언제 또는 언제부터 오고, 완료·상태가 어떻게 바뀌는지, 어디서 다시 확인하는지를 함께 봐야 오탐이 줄어듭니다.KRDS Checkbox/Radio + Helper text, Notice banner + Structured list, Result page + Link
긍정 사례·원칙 유지민원 신청하기 / 검색어 / 구조화 목록 / 비회원 이용 / 발급 보관 90일 / 기간 제한 / 유지 조건 / 기한 임박 / 예상·확정 차이 / 이용권·포인트이미 긍정 사례·원칙·컴포넌트 규칙으로 기능해 사전보다 사례 카드 가치가 큽니다.사례 카드 + KRDS 컴포넌트 보강, 사전 비대상
보류 규칙: 홍길동, 2026.01~2026.12, 30일처럼 사람 이름·기간·예시 수치가 들어간 개선안은 일반화 전에는 사전에 올리지 않습니다.
이번 라운드 승격 메모: 외국인등록번호 *, 영세율 신고해당자만 필수, 해당 거래만 필수가 드러나는 공통 문장으로 일반화해 2.1 사전에 이미 승격했습니다.
실무 원칙: 화면 전체를 복사하지 말고 과업 단계별로 끊어서 기록합니다. 모든 항목을 다 적으려 하지 말고 화면 유형에 맞는 판단 정보 4개만 남깁니다. 한 사례 카드에는 실패 패턴 1개만 남기고, 실제 Before/After 작성 예시는 사례 페이지와 함께 봅니다.

④ UX Writing QA 의무화

개발 QA는 당연하게 여기면서 UX Writing QA는 생략합니다. 배포 전 텍스트 검수는 선택이 아닙니다.

UX Writing QA 체크포인트
시점검수 항목담당
디자인 완료 시버튼 레이블, 폼 레이블, 오류 메시지, 빈 화면 텍스트 — 가이드라인 준수 여부UX Writer
개발 완료 시실제 구현된 텍스트가 디자인과 일치하는지, 동적 변수 [대괄호] 표시 정상 여부개발 UX Writer
배포 직전최종 스테이징 환경에서 금지어·오타·일관성 체크PM UX Writer
QA 체크리스트 항목
  • 버튼 레이블이 [목적어+동사형] 구조인가? (예: 신청서 제출하기)
  • 모든 오류 메시지가 [원인 + 해결 방법] 구조인가?
  • 행정 전문어가 일상어로 번역되었는가? (Living Glossary 대조)
  • 주관 부사(빠르게, 이미, 지금, 너무)가 없는가?
  • 이중 피동(~되어졌습니다)이 없는가?
  • 동적 변수가 [대괄호]로 시각 분리되었는가?
  • 빈 화면에 원인과 대안 행동이 있는가?
  • 선택지(체크박스·라디오)가 긍정문인가?
  • 스크린 리더 오독 기호(★ ◆ →)가 없는가?
  • 숫자 단위가 밀착 표기(15,000원, 30일)인가?
사례 승격 QA 발동 신호
신호바로 할 일판정
세 대표 사이트에서 같은 실패 패턴 반복사례 카드 2개 이상을 묶어 리뷰하고, 관련 원칙·컴포넌트 보강 QA를 엽니다공통 원칙 승격 후보
특정 기관에서만 반복Layer 3 파생 가이드에 추가하고 공통 원칙 수정은 보류합니다기관별 파생 가이드
비가역 결정·절차 선택·심사·복수 조건처럼 실패 비용이 큼배너·체크리스트·단계 표시기·분기 선택지 등 KRDS 컴포넌트 연결까지 함께 검수합니다고위험 공통 패턴
QA를 티켓으로 만들어라: UX Writing QA를 "담당자가 알아서"가 아니라 Jira/GitHub 이슈로 트래킹합니다. 배포 전 해결되지 않은 UX Writing 이슈는 P1 버그와 동등하게 취급합니다.

⑤ 라이팅 자동화 (Writing Linter)

코드는 린터가 검사합니다. 텍스트도 같은 원칙을 적용합니다. 사람이 매번 확인하는 것보다 자동화 도구가 더 일관성 있게 오류를 잡습니다.

자동 감지 대상 패턴
오류 유형감지 패턴 예시심각도
이중 피동 ~되어졌습니다, ~되어집니다, ~하여지다 ERROR
주관 부사 빠르게, 신속히, 이미, 지금 바로, 너무, 매우, 간편하게 ERROR
과도한 존칭 ~하시기 바랍니다, ~하여 주시기 바랍니다, 양지하시기 바랍니다 WARN
금지 기호 ★, ◆, ●, !!, →→ WARN
단위 분리 15,000 원, 30 일, 10 MB (숫자와 단위 사이 공백) WARN
행정 전문어 Living Glossary 금지어 목록과 대조 WARN
자동화 도입 방법
옵션 A — 간이 린터 (즉시 시작 가능)
정규식 기반 스크립트
Living Glossary의 금지어 목록을 정규식으로 변환하여, 배포 전 CI/CD 파이프라인에 텍스트 스캔 단계를 추가합니다.
구현 시간: 1~2일. 한국어 형태소 분석 없이도 대부분의 패턴을 감지합니다.
옵션 B — 형태소 분석 기반 (정밀 검사)
KoNLPy 또는 Kiwi 기반 분석
한국어 형태소 분석기를 사용해 더 정밀하게 이중 피동·존칭 패턴을 감지합니다.
구현 시간: 1~2주. 오탐률이 낮고 복잡한 패턴도 감지 가능합니다.
자동화의 한계: 린터는 "확실히 나쁜 것"만 잡습니다. 맥락에 따른 판단(어떤 피동형이 자연스러운지)은 여전히 UX Writer의 몫입니다. 자동화는 사람을 대체하는 것이 아니라, 반복 검수 부담을 줄이는 도구입니다.

⑥ 철학 내재화 교육

규칙을 외우게 하는 교육은 실패합니다. "왜 이렇게 써야 하는가?"를 먼저 이해해야 규칙을 스스로 확장할 수 있습니다.

교육 설계 원칙
🚫 규칙 전달 중심 교육
"버튼에는 목적어+동사 구조를 써야 합니다."
"이중 피동은 금지입니다."
"주관 부사를 쓰지 마세요."
→ 기억에 남지 않고, 새 상황에 적용 불가
✅ 철학 이해 중심 교육
"시민은 버튼을 읽지 않고 클릭합니다.
그렇기 때문에 무엇을 하는지 즉각 알 수 있어야 합니다."
→ 원리를 이해하면 새 컴포넌트에도 스스로 적용
교육 프로그램 구조
구분대상내용주기
온보딩 신규 입사자 전원 KRDS UX Writing 3대 원칙 (왜 이렇게 쓰는가) + 실습 30분 입사 첫 주
정기 세션 개발·디자인·기획 팀 실제 서비스의 Before/After 사례 리뷰 — 월 1회 30분 월 1회
가이드라인 업데이트 전체 팀 규칙이 바뀌거나 추가될 때 변경 이유 공유 변경 시
심층 워크숍 UX Writing 관련 직군 어려운 케이스 토론 — 판단 기준 내재화 분기 1회
교육 효과 측정
Before/After 비율로 측정
교육 전후 실제 서비스의 금지어 밀도, UX Writing QA 이슈 수, 린터 경고 수를 비교합니다.
"얼마나 잘 쓰는가"보다 "금지된 패턴이 얼마나 줄었는가"가 실질적 지표입니다.
최소 교육 단위: 조직의 상황이 어렵다면, 최소한 이것만 합니다. 월 1회 30분, 실제 서비스에서 발견한 나쁜 예시와 개선 사례를 팀 전체가 함께 봅니다. 이것만으로도 인식이 달라집니다.

도입 체크리스트 — 우선순위 순

한 번에 6가지를 모두 할 필요는 없습니다. 영향력이 큰 것부터 순서대로 도입합니다.

우선순위조건도입 난이도영향 범위
1순위 ③ Living Glossary 구축 낮음 (스프레드시트로 시작 가능) 즉시 전 팀에 영향
2순위 ④ UX Writing QA 의무화 중간 (프로세스 합의 필요) 배포 품질 직접 개선
3순위 ① 단일 진실 공급원 낮음 (기존 문서 정리) 장기적 일관성 기반
4순위 ② Figma 컴포넌트 결합 중간 (디자이너 협업 필요) 디자인 단계에서 오류 예방
5순위 ⑥ 철학 내재화 교육 중간 (콘텐츠 준비 필요) 장기적 조직 역량
6순위 ⑤ 라이팅 자동화 (Linting) 높음 (개발 리소스 필요) 반복 검수 비용 절감
완벽주의 함정: "다 준비되면 시작하자"는 생각으로 미루다 보면 아무것도 안 됩니다. Living Glossary 하나만 만들어도 팀의 UX Writing 수준이 달라집니다. 오늘 시작할 수 있는 가장 작은 단계부터 시작합니다.
다른 챕터 보기