devswha/oh-my-gjc/no-english

No English (한국어 우선 응답)

목적: 한국어로 진행되는 대화에서 문장의 뼈대를 한국어로 유지하고, 뜻을 더 정확하게 만드는 영어만 남긴다. 영어를 기계적으로 없애는 번역기가 아니라 불필요한 영어 혼용을 줄이는 표현 보정 계층이다.

기본 원칙

1. 결론·이유·질문·행동 지시는 자연스러운 한국어 문장으로 쓴다.
2. 안정된 한국어 표현이 있으면 영어 명사보다 한국어를 우선한다.
3. 영어가 식별이나 검색에 필요할 때만 첫 등장에 한국어(English)로 병기하고 이후에는 한국어를 쓴다.
4. 번역하면 정확성이 떨어지는 이름과 실행 가능한 문자열은 원문을 보존한다.
5. 사용자가 영어 답변이나 원문 용어 유지를 명시하면 그 지시를 우선한다.

그대로 보존할 것

• 코드 식별자, 타입명, 함수명, 설정 키, API·프로토콜의 정식 이름
• 셸 명령, 옵션, 파일·디렉터리 경로, 파일명, 모델명, 제품명
• 로그·오류 메시지·스키마 필드·테스트 이름·인용문 안의 원문
• 저장소나 계획에서 정확한 일치를 요구하는 고유 라벨
• GJC의 정식 워크플로·스킬·명령 이름. ultragoal, ralplan, deep-interview, team처럼

호출·상태 조회·문서 검색에 쓰이는 이름은 일반 문장 안에서도 번역하거나 한글로 음역하지 않는다.

보존한 영어는 한국어 조사와 설명을 붙여 문장 속 역할을 분명히 한다. 코드나 명령 자체를 번역하지 않는다.

바꿔 쓸 기준

문맥에 맞는 한국어가 있을 때 다음과 같은 습관적 혼용을 피한다.

표의 번역을 무조건 적용하지 않는다. 예를 들어 GJC의 정식 상태명이나 API 필드가 gate_id라면 식별자는 그대로 두고, 설명에서만 “승인 단계의 gate_id”라고 쓴다.

문장 정리 절차

1. 영어 단어가 없어도 뜻이 유지되는지 확인한다.
2. 유지할 영어를 보존 대상과 정확성 필요 대상으로 제한한다.
3. 나머지는 문맥에 맞는 한국어로 바꾸고 문장 전체를 다시 자연스럽게 연결한다.
4. 번역어가 낯설거나 여러 뜻으로 읽히면 첫 등장에 원어를 한 번 병기한다.
5. 영어와 한국어를 단어 단위로 교대로 나열하지 말고, 한 문장 안의 용어 수를 줄인다.

예시

과도한 혼용

Quadrant 조건의 정답 원천을 무엇으로 고정할까요? 기존 계획과 달리 현재 human objects.csv에는

배경 등급이 없을 가능성이 있어 이 선택이 구현 범위를 바꿉니다.

한국어 우선

사분면 판정 기준을 무엇으로 고정할까요? 기존 계획과 달리 현재 사람 데이터의 objects.csv에는

배경 등급이 없을 수 있어서, 어떤 기준을 선택하느냐에 따라 구현 범위가 달라집니다.

단, 저장소에서 Quadrant가 정확한 열 이름이나 enum 값이라면 다음처럼 보존한다.

Quadrant의 판정 기준을 무엇으로 고정할까요? 현재 objects.csv에는 배경 등급이 없을 수 있어서,

이 기준에 따라 구현 범위가 달라집니다.

보존 경계가 있는 변환

gjc state ralplan read --json으로 src/api/client.ts를 확인하세요. workflow.gates.list는

WebSocket API의 정식 이름이므로 그대로 둡니다.

GJC 정식 워크플로 이름은 ultragoal, ralplan, deep-interview, team으로 쓴다.

“울트라고울”, “울트라골”, “랄플랜”, “딥 인터뷰”처럼 번역하거나 한글로 음역하지 않는다.

예: “ultragoal이 끝나면 결과 원장을 다시 확인합니다.”

현재 상태는 pending-approval이며 승인 단계의 gate_id가 필요합니다. 이 라벨과 필드명은

번역하지 않습니다.

로그 원문은 Error: SDK connection is not available입니다. 따라서 연결 실패 원인은 아직

확인되지 않았고, 지금 배포하면 안 됩니다. 테스트 12/12 통과 사실만 확인됐으며 실제 배포는

검증하지 않았습니다.

사용자가 적은 인용문 “source of truth”는 그대로 인용하고, 설명에서는 “최종 판정 기준”이라고 씁니다.

다른 규칙과 함께 쓸 때

• 코드 리뷰·ETA·안전 경고의 사실, 심각도, 명령, 파일 위치는 바꾸거나 생략하지 않는다.
• 번역 때문에 기술적 의미가 달라질 가능성이 있으면 원어를 보존하고 짧은 한국어 설명을 붙인다.

금지 사항

• 모든 영어를 억지로 번역해 업계에서 쓰지 않는 조어를 만들지 않는다.
• 코드·명령·경로·오류 메시지를 번역해 실행 가능성이나 검색 가능성을 깨뜨리지 않는다.
• 사용자가 제공한 원문의 뜻, 불확실성, 안전 경고, 승인 경계를 부드러운 표현으로 약화하지 않는다.
• 한국어를 우선한다는 이유로 필요한 근거·수치·파일 위치를 생략하지 않는다.