거버넌스
(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 |
① 단일 진실 공급원 (Single Source of Truth)
UX Writing 기준은 반드시 한 곳에만 존재해야 합니다. 부서마다 "우리 버전"의 가이드라인이 생기면, 조직 전체가 다른 기준으로 글을 씁니다.
개발팀 UX Writing 정리.notion
디자인팀 Figma 코멘트 모음
마케팅팀 캐치카피 규칙.pptx
→ 모든 팀이 이 URL을 기준으로 참조
→ 변경은 이 사이트에만 반영
→ 각 팀은 사본 없이 링크만 공유
| 항목 | 규칙 |
|---|---|
| 마스터 문서 | 이 가이드라인 사이트 1개 — 버전 관리는 GitHub |
| 부서별 사본 금지 | 팀 내부 문서에 규칙을 복사하지 않음. 필요하면 URL을 링크 |
| 변경 권한 | UX Writer(초안) → UX Researcher·디자이너 검토 → 배포 |
| 변경 이력 | git commit 메시지로 추적 — 날짜·이유·담당자 명시 |
| 주기적 검토 | 분기 1회 — 실제 서비스와 가이드라인 간 간극 점검 |
② Figma 컴포넌트 결합
디자이너가 버튼 컴포넌트를 가져다 쓰는 순간, 올바른 기본 텍스트가 자동으로 따라와야 합니다. 규칙을 읽지 않아도 규칙이 적용됩니다.
| 컴포넌트 | 🚫 나쁜 기본값 | ✅ 올바른 기본값 |
|---|---|---|
| 주요 버튼 | 확인 / Button | [대상 + 동사] 예: 지원금 신청하기 |
| 취소 버튼 | 취소 / Cancel | 작성 내용 삭제하기 |
| 입력 레이블 | 이름 / Label | 성명 (가장 보편적 명사) |
| 플레이스홀더 | 입력하세요 / Enter here | 하이픈(-) 제외, 숫자만 입력 (예: 01012345678) |
| 오류 메시지 | 오류가 발생했습니다 | [원인] + [해결 방법] 구조 |
| 빈 화면 | 데이터 없음 | 아직 신청한 [대상]이 없습니다. → [행동] 버튼 |
디자이너가 컴포넌트를 선택하면 규칙이 바로 보입니다. 별도 문서를 열 필요가 없습니다.
| 수집한 근거 | 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 조합 | Description에 꼭 남길 문장 | 기본 예시 문구 | 숨은 레이블 메모 |
|---|---|---|---|---|
국민건강보험 질병명·병원 이름 검색, 피부양자·산정특례 안내, 보험료 산정 | Search + Auto-complete + Helper text + Accordion + Table + Button | Description에는 질병명 또는 병원 이름 입력 범위·재검색 단서와, 부양가족 등록·해제 대상, 중증질환 본인부담 감면 대상, 이번 달 보험료 계산 기준, 변동 신고·경감 신청·임의계속가입 CTA를 함께 적습니다. | 질병명 또는 병원 이름을 입력해 다시 찾아보세요 / 부양가족으로 등록하거나 해제할 가족인지 먼저 확인해 주세요 / 중증질환 본인부담 감면 대상인지 확인 / 이번 달 보험료 계산 기준 보기 / 변동 신고하기 | 병원 이름이나 질병명으로 다시 검색하기 / 부양가족 등록·해제 대상 확인하기 / 중증질환 본인부담 감면 요건 보기 / 현재 보험료 계산 기준 보기 / 보험료 변동 신고하기 / 보험료 경감 신청 가능 여부 자가 진단하기 / 퇴직 뒤 예전 직장 보험료 계속 가입 확인하기 |
고용24 실업인정 인터넷 신청, 조기재취업수당 안내 | Notice banner + Structured list + Disclosure + Button | Description에는 실업급여를 확인하는 날, 이번 회차 재취업 활동, 취업한 날 기준, 조기재취업 대상 여부·확인 서류, 놓쳤을 때 결과와 다시 확인 경로를 함께 적습니다. | 실업급여를 확인하는 날까지 재취업 활동을 등록해 주세요 / 빨리 다시 취업했을 때 받는 수당 대상과 확인 서류 보기 / 놓쳤다면 다음 회차와 보완 경로 확인 | 실업인정일까지 필요한 활동 보기 / 취업한 날 기준 확인하기 / 조기재취업수당 대상과 확인 서류 보기 / 실업인정일을 놓쳤을 때 다시 확인하기 |
서울특별시 응답소 질의응답·답변원문, 결과보기 | Result page + Status badge + Button + Link | Description에는 답변 준비 상태, 답변 예정일, 나의 민원 재확인, 답변원문이 등록되면 민원 결과보기, 같은 건이 아니면 새 민원 신청 위계를 함께 적습니다. | 담당 기관에서 답변을 준비하고 있습니다 / 답변 예정일 2026.06.12 / 나의 민원에서 다시 확인 / 답변원문이 등록되면 민원 결과보기 / 같은 건이 아니면 새 민원 신청하기 | 현재 답변 상태와 예정일 확인하기 / 나의 민원에서 다시 확인하기 / 기존 민원 결과 확인하기 / 같은 건이 아니면 새 민원 신청 시작하기 |
전자가족관계등록시스템 국적 회복 허가 | Result page + Notice banner + Checklist + Button | Description에는 한국 국적 다시 받기 같은 시민 언어 헤더와 공식 용어 병기, 1년 내 외국 국적 포기, 외국국적불행사서약 대상 여부, 외국 국적 포기 증명서 제출 경로, [요건 확인]·[신고 방법 보기] CTA를 함께 적습니다. | 한국 국적 다시 받기 허가 결과를 먼저 확인해 주세요 / 1년 내 외국 국적 포기와 외국국적불행사서약 대상 여부를 확인해 주세요 / 외국 국적 포기 증명서 제출 경로 확인 / 신고 방법 보기 | 국적 회복 허가 결과 확인하기 / 외국 국적 포기 기한과 서약 대상 확인하기 / 외국 국적 포기 증명서 제출 경로 확인하기 / 국적 신고 방법 보기 |
정부24 전자증명서안내, 홈택스 부가가치세예정신고, 대한민국법원 가족관계등록부정정 허가 | Tab + Navigation + Card + Link | Description에는 단어 경계, 행동 동사, 대상, 공식 용어 병기 기준을 함께 적습니다. | 무엇을 하는 메뉴인지 먼저 읽히게 하기 / 신고하기·발급하기 동사 분리 | 전자증명서 안내 메뉴 열기 / 부가가치세 예정 신고 바로 가기 / 가족관계 기록 정정 허가 자세히 보기 |
정부24 긴급복지지원 신청, 홈택스 근로장려금 신청, 전자가족관계등록시스템 국적 이탈 신고 | Structured list + Notice banner + Badge + Helper text + Button | Description에는 조건 목록, 기준값, 탈락 시 영향, 자가 확인 CTA를 함께 적습니다. | 모든 조건을 먼저 확인해 주세요 / 소득·재산·기한 기준 보기 / 자가 확인 시작 | 지원 요건 자가 확인하기 / 가구 유형별 기준 보기 / 국적 이탈 요건 확인하기 |
정부24 병적증명서 발급, 홈택스 세무대리인 수임 동의, 전자가족관계등록시스템 소송 대리인 등록 | Structured list + Helper text + Notice banner + Button | Description에는 대리 가능 대상, 증빙, 권한 범위, 해지·해임 경로를 함께 적습니다. | 누가 대신할 수 있는지 먼저 확인해 주세요 / 위임 범위와 종료 경로 보기 / 해지 또는 해임 확인 | 대리 발급 요건 확인하기 / 위임 범위 자세히 보기 / 수임 해지 또는 해임 방법 보기 |
국민신문고 민원 유형 선택, 홈택스 휴업·폐업 신고, 대한민국법원 개인회생·파산 | Radio + Segmented control + Structured list + Helper text + Notice banner + Link | Description에는 내 상황, 선택 기준, 오선택 위험, 비교·상담 CTA를 함께 적습니다. | 내 상황에 맞는 절차를 먼저 확인해 주세요 / 휴업·폐업·회생·파산 차이 보기 / 무료 상담 연결 | 민원 유형 비교하기 / 휴업·폐업 차이 보기 / 개인회생·파산 비교하기 |
Description, 기본 예시 문구, 숨은 레이블 메모까지 같은 라운드에서 같이 남겨야 KRDS/Figma 자산으로 바로 재사용할 수 있습니다.
| 필드 | 무엇을 적는가 | 대표 사이트 근거가 들어오는 자리 |
|---|---|---|
| Description | 실패 패턴 1문장, 기본 공식, 금지 표현, 연결 URL | CASE 번호, 대표 사이트 화면 이름, 연결 원칙 |
| Variant / Property 이름 | default / warning / complete, has_deadline, has_next_action처럼 상태·정보 슬롯을 드러내는 이름 | 상태·기한·다음 행동이 실제로 분리돼야 했던 화면 근거 |
| 기본 예시 문구 | 디자이너가 바로 쓸 버튼, 도움말, 결과 문장 1세트 | 사례 카드의 After 문구와 대표 사이트 원문 비교 |
| 보조·숨은 텍스트 | 스크린리더용 목적, 새 창 여부, 토글 상태, 결과 재확인 경로 | 접근성·숨은 텍스트 축에서 걸린 CASE와 QA 질문 |
③ Living Glossary (살아있는 용어집)
용어는 살아있습니다. 새로운 행정 용어가 생기고, 금지어가 추가되고, 개발 상태값이 바뀝니다. 용어집은 '문서'가 아니라 '데이터베이스'여야 합니다.
| 항목 | 내용 | 업데이트 주기 |
|---|---|---|
| 금지어 | 주관 부사, 과도한 행정어, 이중 피동형 등 사용하면 안 되는 단어 | 수시 (새 오류 발견 시) |
| 대체어 | 금지어에 대한 올바른 표현 1~3가지 | 금지어 등록 시 동시 |
| 행정 용어 번역 | 행정 전문어 → 일상어 매핑 (예: 과오납 → 잘못 낸 돈) | 월 1회 또는 신규 용어 등장 시 |
| 개발 상태값 | API·DB의 status 코드 → 사용자 표시 텍스트 매핑 | 개발 스프린트마다 |
최종수정: 2024-03-15
담당자가 바뀌면 아무도 업데이트 안 함
→ PR로 변경 이력 추적
→ 개발 상태값 코드와 연동
→ 린터 도구가 이 DB를 참조
| API status 값 | 🚫 나쁜 표시 텍스트 | ✅ UX Writing 표시 텍스트 |
|---|---|---|
PENDING | PENDING / 대기중 | 접수됨 — 담당자가 확인 중입니다 |
IN_REVIEW | 검토중 | 심사 중 (영업일 기준 3~5일 소요) |
SUPPLEMENTAL_REQUIRED | 보완 필요 | 서류 보완 필요 — [보완 내용 확인하기] |
APPROVED | 승인됨 | 승인 완료 — [결과 확인하기] |
REJECTED | 반려 | 반려됨 — 이유를 확인하고 재신청할 수 있습니다 |
최근 라운드에서 전체 가이드라인을 다시 훑어본 결과, 남은 일은 새 원칙 번호를 늘리는 것보다 각 원칙 축에 어떤 대표 사이트 근거와 KRDS 컴포넌트 연결을 더 붙여야 하는지를 선명하게 유지하는 데 있습니다. 이 표를 보고 바로 아래 순회 운영법으로 내려가면, 다음 라운드에서 무엇을 먼저 채워야 할지 빠르게 판단할 수 있습니다.
| 원칙 축 | 현재 판단 | 다음 순회에서 먼저 채울 슬롯 | 대표 사이트 | KRDS 우선 축 |
|---|---|---|---|---|
| 무번역 | 대표 행정어·제도어 사전은 넓게 채워져 있습니다 | 복지·고용 복합 제도어, 동의·본인확인 핵심어, 세무·법원 고빈도 메뉴어를 계속 일반화합니다 | 복지로, 고용24, 홈택스, 대한민국법원 | Helper text, Accordion, Disclosure, Agreement |
| 정보핵심화 | 결론 우선과 상태 요약 구조는 견고합니다 | 민원·환급·심사 결과 화면의 상태 1문장 + 예정일 + 다음 행동과 완료 뒤 후속 흐름 근거를 더 쌓습니다 | 국민신문고, 서울특별시 응답소, 홈택스, 정부24 | Status badge, Timeline, Result page, Table |
| 심리적안전망 | 오류·완료·대안 경로 기준은 살아 있습니다 | 세션 종료, 기한 임박, 비가역 결정, 지연 상태처럼 불안이 큰 흐름을 계속 보강합니다 | 정부24, 홈택스, 대한민국법원, 고용24 | Modal, 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 |
최근 라운드에서 확정일자, 상속포기, 지급명령 신청, 이행권고결정, 장기요양인정, 국적 회복, 협의이혼 의사확인, 개명 허가, 진정·청원·제안·신고, 휴업·폐업, 개인회생·파산을 다시 보면, 새 용어 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 |
사전 등록 → 사례 카드 → 관련 원칙·컴포넌트 보강 → 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 기관 특화인지 판정 근거를 기록했다.
-
사례 카드까지 올라간 항목인데 코퍼스 상태가 아직
원칙·웹·사전 반영 완료라면 라운드 종료로 보지 않는다.
대표 사이트 조사는 생각날 때 한 번 보는 방식이 아니라, 같은 순서로 반복하는 라운드 로빈 순회로 운영합니다. 한 라운드에서는 사이트별로 깊게 파기보다 같은 과업 단계와 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 |
전자가족관계등록시스템을 고정점으로 유지합니다. 다만 완료 뒤 후속 흐름처럼 결과 직후의 기한·권리구제 문구를 봐야 하는 라운드에서는 대한민국법원 화면 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 page | Result 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 |
| 상태·결과 | 현재 단계 / 예정일 또는 남은 기간 / 지연 시 문의 경로 / 다음 CTA | Status 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 |
문장만 따로 떼어 검수하지 않습니다. 같은 문장도 어디에 놓였는지, 무엇과 같이 묶였는지, 다음 행동이 바로 이어지는지에 따라 이해 속도가 달라집니다. 아래 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 |
기록 양식만 보면 실제로 무엇을 한 줄에 묶어야 하는지 감이 늦게 옵니다. 아래 예시는 이번 라운드에서 바로 다시 보는 실화면을 같은 형식으로 적은 것입니다. 한 행 안에 원문 3개, 화면 유형에 맞는 판단 정보, UX/UI 검수 축, 먼저 붙일 CASE, KRDS 조합, 같은 라운드에서 같이 갱신할 자산을 함께 남기면 수집 결과가 사전·사례·원칙·컴포넌트 갱신으로 바로 이어집니다.
| 사이트·화면 | 화면 유형 | 원문·판단 정보 묶음 | 실패 패턴 | UX/UI 검수 축 | 먼저 붙일 CASE | KRDS 조합 | 같은 라운드에서 같이 갱신할 자산 |
|---|---|---|---|---|---|---|---|
정부24 전입신고 완료 | 완료 뒤 후속 흐름 | 전입신고가 완료되었습니다 / 주소 변경이 완료됐습니다 / 자동 반영: 국민연금·건강보험 / 별도 변경: 자동차등록·금융기관 [변경 체크리스트] | 완료 사실만 먼저 보이고 자동 반영과 별도 변경, 다음 기관이 흩어짐 | 정보 위계 | CASE 31·32·33 | Result page + Structured list + Link | 사례 카드, 4.2 성공·완료 메시지, 7장 Result page, 부록 D, 코퍼스·테스트 |
홈택스 국세 환급금 조회 | 상태·결과 | 국세 환급금 조회 / 환급금 120,000원 — 연말정산 과납으로 발생 / 체납 세금 20,000원 먼저 충당 / 잔액 100,000원 입금 예정 / 환급 계좌가 없으면 [계좌 등록하기], 30일 넘게 지연되면 [환급 지연 이자 안내] | 숫자만 보이거나 계좌 등록·지연 대응이 결과와 떨어져 보임 | 상태·안심 | CASE 42·32·56 | Result page + Notice banner + Button | 사례 카드, 3장 결과 구조, 7장 Result page, 부록 D, 코퍼스·테스트 |
전자가족관계등록시스템 전자 발급본 안내 | 조회·발급·공개 범위 | 문서확인번호 / QR로 진위 확인 / 전자 발급본도 출력 시 원본과 동일 효력 / 공공 마이데이터 제출 또는 PDF 첨부 / 전자 발급본이 공문서와 동일한 효력 / 제출 전 증명서 진위확인 가능 | 발급 완료만 보이고 효력, 제출 경로, 진위확인이 흩어짐 | 정보 위계 | CASE 27 | Structured list + Notice banner + Link | 사례 카드, 2.1 사전, 7.12 표·결과, 부록 D, 코퍼스·테스트 |
대한민국법원 지급명령 이의신청 | 완료 뒤 후속 흐름 | 지급명령 이의신청 / 지급명령에 동의하지 않으면 2주 이내 이의신청하세요 / 이후 민사소송으로 전환되며 답변서 제출이 필요합니다. [이의신청 바로 가기] | 2주 기한, 제출처, 민사소송 전환, 바로 가기 CTA가 따로 놀음 | 정보 위계 | CASE 33 | Result page + Notice banner + Link | 사례 카드, 4장 결과 불복·재심사, 7장 Result page, 부록 D, 코퍼스·테스트 |
- 새 사전 후보 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 파생 가이드 | 공통 원칙 수정은 보류하고 기관별 파생 가이드로 넘긴다 |
처리 중, 승인처럼 짧은 상태값만 보인다 | 컴포넌트 규칙 후보 | 사전보다 상태 배지·도움말·결과 화면 규칙으로 먼저 검토한다 |
| 시점 | 바로 할 일 | 반드시 남길 기록 | 우선 도착지 |
|---|---|---|---|
| 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 또는 같은 스프린트 범위 |
화면 유형 + 실패 패턴 + 바꿀 문장 + KRDS 조합 + 다음 자산 다섯 칸이 비어 있으면 새 사례로 올리지 않습니다.
이슈 아카이브는 출발점이지 최종 승격 자산이 아닙니다. 대표 사이트 순회에서는 정부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 사전에 이미 승격했습니다.
④ UX Writing QA 의무화
개발 QA는 당연하게 여기면서 UX Writing QA는 생략합니다. 배포 전 텍스트 검수는 선택이 아닙니다.
| 시점 | 검수 항목 | 담당 |
|---|---|---|
| 디자인 완료 시 | 버튼 레이블, 폼 레이블, 오류 메시지, 빈 화면 텍스트 — 가이드라인 준수 여부 | UX Writer |
| 개발 완료 시 | 실제 구현된 텍스트가 디자인과 일치하는지, 동적 변수 [대괄호] 표시 정상 여부 | 개발 UX Writer |
| 배포 직전 | 최종 스테이징 환경에서 금지어·오타·일관성 체크 | PM UX Writer |
- 버튼 레이블이 [목적어+동사형] 구조인가? (예: 신청서 제출하기)
- 모든 오류 메시지가 [원인 + 해결 방법] 구조인가?
- 행정 전문어가 일상어로 번역되었는가? (Living Glossary 대조)
- 주관 부사(빠르게, 이미, 지금, 너무)가 없는가?
- 이중 피동(~되어졌습니다)이 없는가?
- 동적 변수가 [대괄호]로 시각 분리되었는가?
- 빈 화면에 원인과 대안 행동이 있는가?
- 선택지(체크박스·라디오)가 긍정문인가?
- 스크린 리더 오독 기호(★ ◆ →)가 없는가?
- 숫자 단위가 밀착 표기(15,000원, 30일)인가?
| 신호 | 바로 할 일 | 판정 |
|---|---|---|
| 세 대표 사이트에서 같은 실패 패턴 반복 | 사례 카드 2개 이상을 묶어 리뷰하고, 관련 원칙·컴포넌트 보강 QA를 엽니다 | 공통 원칙 승격 후보 |
| 특정 기관에서만 반복 | Layer 3 파생 가이드에 추가하고 공통 원칙 수정은 보류합니다 | 기관별 파생 가이드 |
| 비가역 결정·절차 선택·심사·복수 조건처럼 실패 비용이 큼 | 배너·체크리스트·단계 표시기·분기 선택지 등 KRDS 컴포넌트 연결까지 함께 검수합니다 | 고위험 공통 패턴 |
⑤ 라이팅 자동화 (Writing Linter)
코드는 린터가 검사합니다. 텍스트도 같은 원칙을 적용합니다. 사람이 매번 확인하는 것보다 자동화 도구가 더 일관성 있게 오류를 잡습니다.
| 오류 유형 | 감지 패턴 예시 | 심각도 |
|---|---|---|
| 이중 피동 | ~되어졌습니다, ~되어집니다, ~하여지다 | ERROR |
| 주관 부사 | 빠르게, 신속히, 이미, 지금 바로, 너무, 매우, 간편하게 | ERROR |
| 과도한 존칭 | ~하시기 바랍니다, ~하여 주시기 바랍니다, 양지하시기 바랍니다 | WARN |
| 금지 기호 | ★, ◆, ●, !!, →→ | WARN |
| 단위 분리 | 15,000 원, 30 일, 10 MB (숫자와 단위 사이 공백) | WARN |
| 행정 전문어 | Living Glossary 금지어 목록과 대조 | WARN |
구현 시간: 1~2일. 한국어 형태소 분석 없이도 대부분의 패턴을 감지합니다.
구현 시간: 1~2주. 오탐률이 낮고 복잡한 패턴도 감지 가능합니다.
⑥ 철학 내재화 교육
규칙을 외우게 하는 교육은 실패합니다. "왜 이렇게 써야 하는가?"를 먼저 이해해야 규칙을 스스로 확장할 수 있습니다.
"이중 피동은 금지입니다."
"주관 부사를 쓰지 마세요."
→ 기억에 남지 않고, 새 상황에 적용 불가
그렇기 때문에 무엇을 하는지 즉각 알 수 있어야 합니다."
→ 원리를 이해하면 새 컴포넌트에도 스스로 적용
| 구분 | 대상 | 내용 | 주기 |
|---|---|---|---|
| 온보딩 | 신규 입사자 전원 | KRDS UX Writing 3대 원칙 (왜 이렇게 쓰는가) + 실습 30분 | 입사 첫 주 |
| 정기 세션 | 개발·디자인·기획 팀 | 실제 서비스의 Before/After 사례 리뷰 — 월 1회 30분 | 월 1회 |
| 가이드라인 업데이트 | 전체 팀 | 규칙이 바뀌거나 추가될 때 변경 이유 공유 | 변경 시 |
| 심층 워크숍 | UX Writing 관련 직군 | 어려운 케이스 토론 — 판단 기준 내재화 | 분기 1회 |
"얼마나 잘 쓰는가"보다 "금지된 패턴이 얼마나 줄었는가"가 실질적 지표입니다.
도입 체크리스트 — 우선순위 순
한 번에 6가지를 모두 할 필요는 없습니다. 영향력이 큰 것부터 순서대로 도입합니다.
| 우선순위 | 조건 | 도입 난이도 | 영향 범위 |
|---|---|---|---|
| 1순위 | ③ Living Glossary 구축 | 낮음 (스프레드시트로 시작 가능) | 즉시 전 팀에 영향 |
| 2순위 | ④ UX Writing QA 의무화 | 중간 (프로세스 합의 필요) | 배포 품질 직접 개선 |
| 3순위 | ① 단일 진실 공급원 | 낮음 (기존 문서 정리) | 장기적 일관성 기반 |
| 4순위 | ② Figma 컴포넌트 결합 | 중간 (디자이너 협업 필요) | 디자인 단계에서 오류 예방 |
| 5순위 | ⑥ 철학 내재화 교육 | 중간 (콘텐츠 준비 필요) | 장기적 조직 역량 |
| 6순위 | ⑤ 라이팅 자동화 (Linting) | 높음 (개발 리소스 필요) | 반복 검수 비용 절감 |