llm-wiki/docs/superpowers/specs/2026-06-02-korean-prose-style-design.md

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

작성: 2026-06-02 · 상태: 구현됨 · 선행: Phase 2 검증 강화

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 오케스트레이션