Skip to content

docs(glossary): 기술 용어 표기의 외래어 및 일상어 대체 - #112

Merged
LivingLikeKrillin merged 1 commit into
mainfrom
docs/glossary-loanwords
Oct 17, 2026
Merged

LivingLikeKrillin merged 1 commit into
mainfrom
docs/glossary-loanwords

Conversation

@LivingLikeKrillin

Copy link
Copy Markdown
Owner

개요

2026년 10월 18일 결정에 따라 개발자가 직관적으로 이해할 수 있도록 기술 용어의 인위적인 한국어 번역어를 외래어와 일상어로 교체합니다.
용어집(docs/glossary.md) 대응표와 표제어를 정비하고, 현재 유효한 20개 문서 파일 및 다이어그램의 용어 표기와 조사를 일괄 수정합니다.
아울러 승인 호스트 표제어 검증을 위한 일부 비문서 문자열 수정과 설계 기록 추가 및 스탬프 갱신을 함께 진행합니다.

주요 변경 사항

1. 용어집(docs/glossary.md) 개정 및 표제어 정비

  • §8 대응표에 14개 대응 행 추가 및 §8 도입 문장 갱신
  • 기존 표제어 5건 명칭 변경(승인 호스트, 미확정, 단위의 기체 바인딩, 발행 게이트, ExplainedBoolean)
  • 신규 표제어 4건(리빌드, 종결, 이빅션, 결함 수용) 추가
  • 리빌드 표제어를 작업 지시와 판단 기록 기반의 메모리 유실 실행 재생성 과정(Middleware.resume, rebuildFrom)으로 정의하고 기동 복원 및 재부착과의 연계 명시

2. 현재 문서 및 다이어그램 내 용어 교체와 조사 정비

  • 현재 유효 문서(20개 파일, 230개소, ADR 포함), README.md, picasso/README.md 내 용어 교체
  • 교체 대상 14개 용어 반영: 다시 짓기 → 리빌드, 관문 → 게이트, 자취 → 트레이스, 묘비 → 툼스톤, 승인 창구 → 승인 호스트, 기체 묶음 → 기체 바인딩, 설명된 불리언 → ExplainedBoolean, 막음 → 차단, 도는 실행 → 진행 중인 실행, 다시 돎 → 재실행, 정착 → 종결, 결함 감수 → 수용, 놓기 → 이빅션, 접수 불명 → 미확정
  • 최근 문서에 재유입된 대응표 용어 4건 교정: 사슬 → 연쇄, 종착 → 종료, 도장 → 스탬프, 대장 → 레지스터
  • 변경된 용어에 맞추어 한국어 조사 일괄 정비
  • docs/diagrams 내 runtime-flow 및 task-states(라이트 및 다크) 다이어그램 텍스트와 생성 도구 tools/diagram-gen/task-states.mjs 수정
  • 변경 제외 범위 유지: 코드 식별자, 코드 주석 및 KDoc, 테스트 이름 및 테스트 검증 리터럴 문구, 스탬프 라인 필드, docs/superpowers(설계 사양서 및 이전 설계 기록), handoff/ 디렉터리 보존

3. 게이트 테스트 검증용 비문서 문자열 수정

  • 게이트 테스트의 승인 호스트 표제어 노출 검증 조건을 충족하기 위한 비문서 문자열 3곳 수정
  • picasso/build.gradle.kts 내 Gradle 태스크 설명 문구 수정
  • ScenarioHost 시작 배너 문구 수정
  • CLAUDE.md 내 명령어 설명 1행 수정

4. 설계 기록 추가 및 스탬프 문서 갱신

  • 설계 기록 §15.232 추가(명칭만 변경, 의미 변경 없음 명시)
  • docs/limits.md 이력 번호 갱신(231에서 232로 변경)
  • 스탬프 대상 문서 21개 파일에 대해 CRLF 줄바꿈을 유지하며 재스탬프 적용

검증 결과

  • ./gradlew :gate:test :picasso:test 빌드 및 테스트 통과
  • gate 277개 및 picasso 505개 테스트 전건 성공(0 failures, GroundTruthTest, DocumentClaimsTest, CompletionCriterionTest 포함)
  • 전체 테스트 수 2,148개 유지(테스트 수 변경 없음)

🤖 Generated with Claude Code

- docs/glossary.md §8 대응표 14개 행 추가 및 리빌드, 종결, 이빅션, 결함 수용 신규 표제어 정의
- 현재 유효 문서 20개 파일 및 다이어그램 내 `다시 짓기`, `관문` 등 18개 용어의 외래어 및 일상어 대체와 조사 정비
- 승인 호스트 표제어 검증 통과를 위한 빌드 스크립트, 시작 배너, CLAUDE.md 내 비문서 문자열 수정
- 설계 기록 §15.232 추가, docs/limits.md 이력 갱신(231에서 232로 변경) 및 21개 스탬프 문서 재스탬프 반영

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@LivingLikeKrillin
LivingLikeKrillin merged commit 5917022 into main Oct 17, 2026
1 check passed
@LivingLikeKrillin
LivingLikeKrillin deleted the docs/glossary-loanwords branch October 17, 2026 16:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant