bbulman/labeling

labeling은(는) 무엇을 하나요?

라벨은 사람들이 문을 열기 전에 문 뒤에 무엇이 있는지 알려주는 단어입니다. 이 스킬은 각 목적지, 섹션 또는 작업의 이름을 무엇으로 지을지, 그리고 각 레벨에서 어떤 명명 시스템을 사용할지를 결정하는 데 사용됩니다. 모든 라벨의 테스트 기준: 새로운 사용자가 그 뒤에 무엇이 있는지 예측할 수 있는가?

시작하기 전에

필요한 것	없을 경우
현재 라벨과 각 라벨의 뒤에 있는 내용 및 표시 위치	네비게이션을 읽거나 요청하세요. 아직 아무것도 없다면, 빈 labels.csv와 테스트 계획을 전달하세요.
라벨을 읽는 사람과 그들이 하려는 작업	물어보세요. 답변이 없으면, 상단에 가정을 명시하세요.
사용자 자신의 언어: 검색 로그, 지원 질문, 카드 분류 그룹명, 인터뷰, 리뷰	유사한 제품의 콘텐츠와 관행에서 초안을 작성하고, 모든 라벨에 untested를 표시한 후, 단어를 확인할 수 있도록 테스트 계획을 전달하세요. 절대 추측을 사용자의 언어라고 제시하지 마세요.

방법

1. 컨텍스트 내 라벨 목록을 작성하세요. 각 라벨의 그룹(함께 표시되는 라벨), 목적지 및 그 뒤에 실제로 있는 내용을 기록하세요. 형제 라벨 없이 라벨을 판단하면 중복이 누락됩니다.

2. 사용자의 언어를 수집하세요. 사용자의 언어가 첫 번째 후보이며, 내부 용어는 그렇지 않습니다.

   출처	제공하는 것	주의할 점
   검색 로그	정확히 입력된 단어, 가장 강력한 트리거 단어	findability 스킬의 로그 보고서를 실행하고, 볼륨을 추정하지 마세요
   지원 질문	사람들이 필요를 설명하는 방식	어려움에 처한 사람들은 다르게 표현합니다
   카드 분류 그룹명	사람들이 클러스터를 부르는 이름	가장 일반적인 단어를 사용하세요
   인터뷰, 5~10명	어휘와 단어의 의미	그들이 자발적으로 사용하는 단어를 들어보세요
   유사한 제품	사람들이 이미 배운 단어	익숙함이 재치보다 낫습니다

3. 레벨당 하나의 라벨링 시스템을 선택하세요. 하나의 메뉴에서 시스템을 혼합하면 각 항목이 다른 질문에 답하게 되어 사람들이 비교할 수 없습니다.

   시스템	예시	작동하는 경우	작동하지 않는 경우
   작업	"주문 추적"	사람들이 할 일을 가지고 도착할 때	작업이 겹치거나 목록이 길어질 때
   대상	"개발자용"	그룹에 다른 콘텐츠가 필요하고 자신을 배치할 수 있을 때	누군가가 두 그룹에 속하거나 어느 그룹인지 모를 때
   주제	"결제"	주제가 사람들이 생각하는 방식일 때	주제가 조직의 것이지 사용자의 것이 아닐 때
   형식	"비디오", "템플릿"	사람들이 형식으로 선택할 때	그들이 먼저 주제에 관심이 있을 때
   A to Z	용어집, 디렉토리	사람들이 정확한 이름을 알 때	발견을 위해 탐색할 때

4. 다음 규칙에 따라 후보를 작성하세요.

   규칙	약함	더 강함
   구체적이고 익숙하며, 미스터리 미트 없음	리소스, 솔루션, 디스커버	가이드 및 템플릿
   형제 간 병렬 구조	가격, 시작하기, 팀용	가격, 설정, 팀
   구별하는 단어를 앞에 배치	보고서 설정, 보고서 기록	설정, 기록, 보고서 아래
   하나의 항목, 모든 곳에서 같은 이름	메뉴에서 "팀", 페이지에서 "사람"	하나를 선택하여 네비게이션, 제목 및 이동 경로에서 사용
   문과 방이 일치	"요금제"가 "구독 선택"을 엶	링크 텍스트와 페이지 제목이 일치
   링크 텍스트가 얻는 것을 알려줌	더 알아보기	온보딩 체크리스트 다운로드

5. 내부 명칭에 대한 처리 방법을 결정하세요.

   명칭이	다음을 수행
   팀, 부서 또는 프로젝트 코드명	절대 표시하지 마세요. 사람들이 하러 온 작업의 이름을 지정하세요
   사람들이 배워야 하는 기능의 브랜드 이름	네비게이션에 사용되는 모든 곳에 일반 설명을 함께 제공하세요
   대상 사용자가 실제로 사용하는 전문 용어	유지하고, 외부인이 알지 못하더라도 해당 대상으로 테스트하세요
   법적 또는 규제 용어	정확한 용어를 유지하고 옆에 일반 설명을 추가하세요
   약어	대상 사용자가 약어를 단어보다 더 많이 검색하지 않는 한 전체를 표기하세요

6. 논쟁 중인 모든 라벨에 대해 두세 가지 옵션을 제시하고, 각각의 장단점을 설명한 후 하나를 추천하세요. 단일 답변은 결정을 숨깁니다.

7. 라벨 주변의 정보 스멜을 강화하세요. 짧은 설명, 항목 수, 이동 경로 및 활성 상태는 단어만으로 전달할 수 없는 것을 전달합니다. 라벨이 개별적으로는 괜찮지만 사람들이 계속 이탈할 때 references/information-scent.md를 읽어보세요.

8. 예측 가능성을 테스트하세요. 한 방향으로는 라벨만 보여주고 그 뒤에 무엇이 있을지 기대하는지 묻고, 다른 방향으로는 목표를 제시하고 어떤 라벨을 선택할지 물어보세요. 첫 번째 패스로 콜드 리드를 할 수 있습니다: 목적지를 가리고, 무엇을 예상하는지 쓰고, 비교하세요. 이를 자신의 판독으로 보고하고 연구로 보고하지 마세요. references/predictability-test.md에 계획과 채점 방법이 있습니다.

9. 다른 언어를 확인하세요. 라벨이 번역될 예정이라면, 확정하기 전에 references/locales.md를 읽어보세요. 단어 그대로가 아닌 의미로 번역하고, 해당 시장의 사람들과 다시 테스트하세요.

결과물

사용자가 다른 파일을 지정하지 않는 한 다음 파일을 작성하세요.

• labels.csv, 라벨당 한 행: group,label,destination,system,was,evidence,status. evidence는 단어의 출처(검색 로그, 지원, 가정)를 나타냅니다. status는 kept, renamed 또는 new이며, tested 또는 untested가 세미콜론으로 구분됩니다: renamed; untested.
• labels.md, 다음 순서로 작성: 권장 사항(두세 문장); 각 레벨에 대해 선택된 시스템; 논쟁 중인 라벨(옵션, 트레이드오프, 선택 및 이유); 내부 명칭 및 각각의 처리 방법; 테스트 방법; 가정 및 미해결 질문. 전체 목록은 labels.csv에만 있으므로 둘이 모순될 수 없습니다.

작업	반환
하나의 항목 이름 변경	트레이드오프가 있는 세 가지 옵션, 선택 및 하나의 테스트 질문을 답변에 포함
하나의 메뉴 검토	labels.csv 행과 변경 사항 요약 목록
전체 사이트 또는 앱	두 파일 모두

더 긴 문서가 더 철저한 문서는 아닙니다.

확인

기계적 검사를 실행하고 그 수치를 사용하세요:

node "${CLAUDE_SKILL_DIR}/scripts/label-check.mjs" labels.csv

이 검사는 모호한 단어, 그룹 내 중복, 같은 단어로 시작하는 형제, 문법 형태가 혼합된 그룹, 여러 목적지를 가진 하나의 라벨 및 여러 라벨을 가진 하나의 목적지를 찾습니다. 형식 검사는 명확한 패턴에서만 작동하므로, 각 그룹의 병렬 구성을 직접 확인하세요. 그런 다음 확인하세요:

• 모든 그룹이 하나의 라벨링 시스템을 사용하며, labels.md에 명시되어 있습니다.
• 모든 라벨이 tested 또는 untested로 표시되어 있습니다. 깨끗한 스크립트 실행은 이해를 증명하지 않습니다.
• 각 라벨의 evidence가 실제입니다. 가정인 경우, 행에 명시되어 있어야 합니다.

클로드가 여기서 할 수 없는 일

라벨을 직접 읽어서 실제 사람들이 무엇을 이해하는지 알 수 없으며, 조직의 전략, 브랜드 약속 또는 정치적 상황을 알려주지 않는 한 알 수 없습니다. 사용량 수치, 검색 볼륨, 테스트 결과 또는 인용을 절대 만들어내지 마세요. 대안을 장단점과 함께 제시하고, 하나를 추천하고 이유를 설명하세요. 결정은 인간이 내리며, 특히 이름에 브랜드 또는 법적 가중치가 있는 경우 더욱 그렇습니다.

인계 지점

다음 필요	스킬
그룹 자체가 잘못된 것 같음	card-sort, sitemaps
어떤 라벨이 어떤 메뉴에 들어갈지	navigation
태깅 및 필터 용어	taxonomies
이름이 변경된 섹션의 주소 변경	url-structure, redirect-maps
계층 구조 내 라벨 테스트	tree-tests
이름 변경으로도 '사람들이 찾을 수 없음'이 해결되지 않음	findability
먼저 무엇이 존재하는지 목록	content-inventory
템플릿 뒤의 필드	content-models
전체 사이트 재구성 또는 어디서부터 시작해야 할지 모름	information-architecture