| name | refine-korean-dev-writing |
| description | Write and refine Korean text in developer contexts — code comments, AIDEV-NOTE anchors, commit messages, PR descriptions, review replies, design docs, memory notes — so it reads as natural, grammatical Korean a native engineer would write, not as awkward literal translation, broken word order, or forced metaphor. Use whenever producing Korean prose for engineering work, and especially self-review Korean output before finalizing. |
Refine Korean Dev Writing
개발 맥락 한국어를 한국인 개발자가 쓸 법한 자연·문법적 문장으로 만든다. 출력 전 self-review에 반드시 통과시킨다.
Core Rules
- 자문: "한국인 시니어 개발자가 코드리뷰에 쓸까?" 어색하면 고친다.
- 영어 구조를 옮기지 말고 한국어 어순·조사로 다시 쓴다. 뜻 먼저, 수사는 그다음. 한 문장에 개념 하나.
- 서술어를 완성한다.
못 통과(X) → 통과하지 못한다(O). 생략 시 명사형으로 끝낸다(…통과 실패).
- 번역투·이중 피동(
되어진다)·불필요한 ~에 대해·무생물 가지다(has)를 제거한다.
- 굳은 외래어(헤더, 캐시, 훅 등)와 영문 식별자는 그대로 두고, 서술어만 한국어로 연결한다.
- 한 문서 안 어투·문장 끝을 섞지 않는다.
- 걸린 문장만 국소 수정한다. 전체를 갈아엎지 않는다.
See ./rules/grammar.md when fixing word-order, particles, or incomplete predicates.
See ./rules/translationese.md when hunting translationese or over-translated loanwords.
See ./rules/register-by-context.md for comment/commit/PR/review register and endings.
Self-review checklist
출력 전:
- 소리 내어 읽어 걸리는 데가 없는가?
- 모든 서술어가 완성돼 있는가?
- 번역투가 없는가?
- 문체·문장 끝이 일관적인가?
