# 한국어 윤문 standard — 설계 (Phase 3)

> 작성: 2026-06-02 · 상태: 구현됨 · 선행: [Phase 2 검증 강화](2026-06-02-validation-strengthening-design.md)

## 1. 범위 (G4)

요구사항 4f("이해 쉬우면서 자세")·4g("blog/면접/포폴 한국어 윤문 최적화")·3("구조적·쉬운 답변")을 충족.

| 산출물 | 변경 |
|---|---|
| `rules/prose-style.md` | **신규** — 윤문 + "쉬운 설명" 기준 |
| `.claude/commands/interviewize.md` | 규칙에 prose-style 참조 추가 |
| `.claude/commands/blogify.md` | 본문 작성 시 prose-style 참조 추가 |
| `CLAUDE.md` §9 + rules 목록 | prose-style 등록 |

## 2. 사용자 지정 취향 (고정값)

| 항목 | 결정 |
|---|---|
| 문체 | 존댓말 (blog/portfolio `합니다체`, interview 말하듯 존댓말) |
| 길이 | 적당히 길게 — 주장→이유→예시 한 묶음. 반복·수식 늘리기 금지 |
| 용어 | 개발 용어만 영어(`connection pool`, `idempotent` 등), 나머지 한국어. 억지 한글화 금지 |

## 3. "쉬운 설명" 5원칙

쉬운 요약 먼저 → 전문 용어 첫 등장 시 한 줄 풀이 → 추상→구체 → 맥락부터 → 쉬움과 자세함 양립(깊이 유지).

## 4. 사실 경계 (중요)

윤문은 표현만 다듬고 **사실 등급을 바꾸지 않음**(CLAUDE.md §6, §11). `POLISHED_OVERCLAIM` 실패 모드로 명시 — 미검증 사실을 매끄러운 문장으로 포장 금지.

## 5. 명명된 실패 모드

`TONE_INCONSISTENT` · `OVER_TRANSLATED` · `JARGON_WALL` · `NO_PLAIN_SUMMARY` · `BLOATED` · `TOO_TERSE` · `POLISHED_OVERCLAIM`.

## 6. 적용 방식

자동 린터 검사는 하지 않음(윤문은 정성적). interviewize/blogify가 본문 작성 시 참조하는 **가이드 규칙**. canonical(concepts/projects)은 권고로만.

## 7. 요구사항 충족 (3개 phase 종합)

| 요구사항 | 충족 phase |
|---|---|
| 1 체계적 관리 | P1 입력 계약 |
| 2 비효율 x | P1 자동조사 + P2 fix-plan |
| 3 구조적·쉬운 답변 | P1 명령 요약 + P3 쉬운 설명 기준 |
| 4a 매번 검증 | P2 hook C1/C3 조건부 |
| 4b webfetch 조사 | P1 자동조사 |
| 4c 개수 아닌 근거 | 기존 R1 + P1 |
| 4d 대안비교+언제 | 기존 표(체크리스트 G3는 보류) |
| 4e wiki 문서화 기준 | 기존 /ingest |
| 4f 쉬우면서 자세 | P3 쉬운 설명 5원칙 |
| 4g 한국어 윤문 | P3 prose-style |
| 4h 전체 자동화 | P1 /branch-spec 오케스트레이션 |
</content>