Skip to content

프로젝트 규칙 추가: 한국어 문체 규약(CLAUDE.md) - #7

Merged
midagedev merged 1 commit into
midagedev:mainfrom
dodaechega:docs/claude-md
Aug 28, 2026
Merged

프로젝트 규칙 추가: 한국어 문체 규약(CLAUDE.md)#7
midagedev merged 1 commit into
midagedev:mainfrom
dodaechega:docs/claude-md

Conversation

@dodaechega

Copy link
Copy Markdown
Contributor

배경

PR #4에서 번역체, 조어, 엠대시를 제거하는 대규모 교정 작업을 수행했습니다.
그런데 그 작업에서 적용한 기준이 저장소 안에 문서로 남아 있지 않기 때문에,
문항을 새로 추가할 때 같은 문제가 다시 누적될 수 있습니다.

이 PR은 해당 기준을 CLAUDE.md로 고정합니다.

무엇을 추가했나

저장소 최상위에 CLAUDE.md 한 파일을 추가했습니다. 문서의 출처는
snflkd/fluent-korean 출력 스타일이며,
PR #4가 실제로 적용한 규칙과 동일합니다.

  • 적용 대상 표: 문항 데이터와 오개념 서술, 문서, UI 문자열에는 적용하고,
    변수명과 코드 주석, 커밋 메시지, 로그 문자열, 인용문에는 적용하지 않습니다.
  • 8개 조항: 문장 성분 생략 금지, 서술어와 종결어미로 문장 완결, 조사와 어미 유지,
    한자어에 조사와 어미를 붙여 사용, 비유적 어휘 자제, 엠대시 금지, 신조어와 문어체
    한자어 금지, 번역투 금지를 규정했습니다.
  • 조항별 개선 예시: 각 조항마다 나쁜 표현과 좋은 표현을 나란히 제시해서,
    문구만 읽고 의도를 잘못 해석하는 상황을 방지했습니다.
  • 검증 절차: build.mjscheck-links.mjs 실행 순서를 명시했습니다.

기존 문서와의 관계

AUTHORING.md는 오답 설계와 난이도 배분을 다루고, CLAUDE.md는 문체만 다룹니다.
역할이 겹치지 않도록 CLAUDE.md 말미에서 AUTHORING.md를 상호 참조하도록 했습니다.

검토 요청 사항

  • 8개 조항 중에서 이 저장소의 실제 관행과 어긋나는 항목이 있는지 확인 부탁드립니다.
  • 적용 대상 표에서 assets/app.js의 UI 문자열을 포함한 판단이 적절한지 확인 부탁드립니다.

@midagedev

Copy link
Copy Markdown
Owner

완전 감사합니다!!!

@midagedev
midagedev merged commit f601b74 into midagedev:main Aug 28, 2026
@midagedev

Copy link
Copy Markdown
Owner

머지했습니다. 본문에서 요청하신 두 확인 사항에 답을 남깁니다.

  1. 실제 관행과 어긋나는 항목: 엠대시 금지 조항 하나가 걸렸습니다. 문항의 source 필드와 data/sources.jsonlabel출처명 — 문서 제목 표기를 관례로 쓰고 있고(각 64건, 99건), validate 게이트도 해설에서만 엠대시를 검사합니다. 후속 커밋 6ffbc11에서 이 두 필드를 미적용 표에 추가했습니다.
  2. assets/app.js UI 문자열을 적용 대상에 포함한 판단은 적절합니다. 사용자에게 노출되는 문자열이라 문항과 같은 기준을 받는 것이 맞습니다.

추가로, 문항 수가 바뀔 때 OG 카드 게이트 때문에 집계 갱신과 make-og.py를 build보다 먼저 돌려야 하는 순서도 검증 절차에 같은 커밋으로 보충했습니다. 기여 감사합니다.

@midagedev

Copy link
Copy Markdown
Owner

(이 코멘트는 리포 관리자를 대신해 Claude 에이전트가 작성했습니다.)

머지했습니다. 본문에서 요청하신 두 확인 사항에 답을 남깁니다.

  1. 실제 관행과 어긋나는 항목: 엠대시 금지 조항 하나가 걸렸습니다. 문항의 source 필드와 data/sources.jsonlabel출처명 — 문서 제목 표기를 관례로 쓰고 있고(각 64건, 99건), validate 게이트도 해설에서만 엠대시를 검사합니다. 후속 커밋 6ffbc11에서 이 두 필드를 미적용 표에 추가했습니다.
  2. assets/app.js UI 문자열을 적용 대상에 포함한 판단은 적절합니다. 사용자에게 노출되는 문자열이라 문항과 같은 기준을 받는 것이 맞습니다.

추가로, 문항 수가 바뀔 때 OG 카드 게이트 때문에 집계 갱신과 make-og.py를 build보다 먼저 돌려야 하는 순서도 검증 절차에 같은 커밋으로 보충했습니다. 기여 감사합니다.

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.

2 participants