oh-my-design-cli 1.6.0 → 1.6.2

package/data/research/2026-05-18-kr-style-presets.md

@@ -1,572 +0,0 @@
-# Korean Writing Style Presets — Taxonomy for `omd-kr-writer`
-
-> Research compiled 2026-05-18 for the oh-my-design Korean writer agent.
-> Goal: codify 12 distinct Korean voices (문체) with verbatim samples, transition rules, and 국어교육학 grounding so the writer agent can switch register reliably.
-> Verbatim sentences are quoted from primary sources where retrievable. Examples that could not be sourced are flagged `[verify]` and were synthesized to match documented conventions.
-
----
-
-## 0. How to read this taxonomy
-
-Each preset has nine required fields: `preset_id`, `korean_name`, `register` (which of the six speech levels it sits on), average `sentence_length`, an `opening_pattern` and `closing_pattern` that recur in source corpora, a `forbidden` list, a `preferred` list, three `examples`, the source URLs we harvested from, plus `when_to_use` / `when_not_to_use`.
-
-The Korean speech-level system underlying the `register` field is from 학교문법 상대 높임법 (school grammar relative honorification): **격식체** (formal — 하십시오체, 하오체, 하게체, 해라체) versus **비격식체** (informal — 해요체, 해체). See §13 below.
-
----
-
-## 1. `toss-tech-design` — 토스 디자인 톤
-
-```yaml
-preset_id: toss-tech-design
-korean_name: 토스 디자인 톤
-register: 비격식체 · 해요체 (-요/-네요/-죠)
-sentence_length: 30~50자 평균, 50자 초과 시 분절
-opening_pattern: "안녕하세요. [회사/팀] [직무] [이름]이에요." 또는 본인 한 줄 소개 + "오늘은 ~ 이야기를 나눠보려고 해요."
-closing_pattern: "여기까지 ~ 나눠봤어요." / "여러분의 제품에는 어떤 ~이/가 필요한가요?"
-forbidden:
-  - "~습니다", "~한다" 종결
-  - 한자어 과다 (예: 사용자, 적용하다, 진행하다)
-  - 50자 넘는 한 호흡 문장
-  - 수동태 ("~되어진다")
-  - 단정적 명령형 ("하십시오", "유의 바랍니다")
-preferred:
-  - "~요", "~네요", "~죠", "~거든요"
-  - 1인칭 narrator ("저는", "우리는")
-  - 짧고 리듬감 있는 단문
-  - 쉬운 우리말 ("쓰는 사람", "고른다", "쓴다")
-  - 사용자에 대한 공감 표현 ("느꼈을 거예요", "당황스러웠을 거예요")
-examples:
-  - "UX 라이팅에서는 모든 팀원이 같은 기준으로 글을 쓰는 게 중요해요."
-  - "사용자는 쏟아지는 정보를 모두 읽지 않아요. 원하는 정보를 빠르게 스캔할 수 있도록 꼭 필요한 내용만 필요한만큼 전달하는 것을 중요하게 생각해요."
-  - "당장의 이익을 조금 포기하더라도, 진실되고 사용자를 존중하는 커뮤니케이션을 해야 해요."
-  - "오늘은 그 8개월의 과정에서 제가 찾은 좋은 인터널 브랜딩의 조건을 나눠보려고 해요."
-sources:
-  - https://toss.tech/article/8-writing-principles-of-toss
-  - https://toss.tech/article/layers-of-your-time
-  - https://github.com/toss/technical-writing
-when_to_use: 디자인 결정 deep-dive, 프로덕트 회고, 비격식 sharing 블로그
-when_not_to_use: 법적 고지, 학술 논문, 보고서·기획서
-```
-
-The 8 라이팅 원칙 (Predictable hint, Weed cutting, Remove empty sentences, Focus on key message, Easy to speak, Suggest than force, Universal words, Find hidden emotion) act as guardrails — when in doubt the writer drops adjectives, drops 한자어, and re-checks emotional fit.
-
----
-
-## 2. `karrot-neighborly` — 당근 동네체
-
-```yaml
-preset_id: karrot-neighborly
-korean_name: 당근 동네체
-register: 비격식체 · 해요체, 가끔 해체 혼용 ("~지요", "~답니다" 가능)
-sentence_length: 25~45자
-opening_pattern: "안녕하세요, [지역/우리 동네] 이웃 여러분." 또는 "여러분의 동네에는 ~"
-closing_pattern: "오늘도 따뜻한 하루 보내세요." / "동네 이웃들과 함께해요."
-forbidden:
-  - 차가운 비즈니스 한자어 ("고객", "유저", "수요자")
-  - 외래어 남발 ("커뮤니티" 보단 "동네")
-  - 단정적 -다 종결
-preferred:
-  - "동네", "이웃", "우리", "근처"
-  - 다정한 호명 ("여러분", "이웃님")
-  - "~답니다", "~네요", "~거든요"
-  - 골목·계절·온도가 묻어나는 묘사어
-examples:
-  - "차려입지 않고 편하게 나서도 되는 가까운 동네, 이웃과 주고받는 수줍은 인사."
-  - "골목골목 느껴지는 온기와 저마다의 정다운 삶의 이야기를 비추는 것이 당근다움이에요."
-  - "우리 모두는 '당근다움'의 핵심이 이웃과 우리 주변을 향한 따뜻한 관심, 배려, 그리고 애정 어린 시선에 담겨있다고 보았어요."
-sources:
-  - https://about.daangn.com/blog/archive/%EB%8B%B9%EA%B7%BC-%EB%A6%AC%EB%B8%8C%EB%9E%9C%EB%94%A9-%ED%94%84%EB%A1%9C%EC%84%B8%EC%8A%A4-%EB%B8%8C%EB%9E%9C%EB%93%9C/
-  - https://medium.com/daangn (당근 테크 블로그 — Design 태그)
-when_to_use: 지역·커뮤니티 톤이 핵심인 제품 소개, 따뜻한 onboarding, 사회적 가치 메시지
-when_not_to_use: 글로벌 SaaS landing, 금융 약관, 학술 발표
-```
-
-Karrot's voice is unique in keeping `-요` ending while pulling vocabulary from a much warmer, slightly older-feeling Korean register (`정답다`, `다정하다`, `애정 어린`).
-
----
-
-## 3. `brunch-maker-popular` — 브런치 인기 메이커 에세이
-
-```yaml
-preset_id: brunch-maker-popular
-korean_name: 브런치 에세이체
-register: 비격식체 · 해요체 + 자유 혼용 (1~2문단당 한 번 해체)
-sentence_length: 40~80자, 문단당 호흡이 길고 한 문장이 시처럼 끊김
-opening_pattern: 개인 일화 한 줄 — "그날 저녁, 나는 ~" 또는 "내가 처음 ~을 만난 건"
-closing_pattern: 여운을 남기는 단문 — "그래서 나는 오늘도 ~." (마침표 강조)
-forbidden:
-  - 보고서식 bullet
-  - 차트 인용 ("그래프에 따르면")
-  - 단정적 톤 ("~해야 한다")
-preferred:
-  - 1인칭 "나"의 일화
-  - 감각어 (냄새, 빛, 소리)
-  - 짧은 단문과 긴 만연체의 교차
-  - 은유와 메타포
-  - 짧은 의문문 ("정말 그럴까?")
-examples:
-  - "[verify] 그날 나는 처음으로 '디자인이 사람을 닮는다'는 말을 이해했다."
-  - "[verify] 어떤 문장은 오래 묵혀야 비로소 자기 자리를 찾는다."
-  - "[verify] 글쓰기는 결국, 내가 무엇을 모르는지를 알아가는 일이라는 생각이 든다."
-sources:
-  - https://brunch.co.kr/@thinkaboutlove/403
-  - 유시민, 《유시민의 글쓰기 특강》 (생각의길, 참고)
-when_to_use: 개인 회고, 디자이너 manifesto, 커리어 에세이, 인터뷰
-when_not_to_use: 제품 release note, 사내 보고
-```
-
-Note: Brunch 본문은 무단 인용 제한이 있어 verbatim quote 대신 구조와 어미 패턴만 정리. 실제 운영 시 작가 본인의 글을 fine-tune 코퍼스로 첨부 권장.
-
----
-
-## 4. `naver-d2-engineering` — 네이버 D2 엔지니어링체
-
-```yaml
-preset_id: naver-d2-engineering
-korean_name: NAVER D2 기술체
-register: 격식체 · 하십시오체 (-합니다/-입니다) 기반, 1인칭 "저"는 등장 가능
-sentence_length: 40~70자, 명확한 주어-서술 구조
-opening_pattern: "안녕하세요. [팀명] [이름]입니다. 이 글에서는 ~을 다룹니다."
-closing_pattern: "이 글이 ~ 분들에게 도움이 되길 바랍니다." / "더 자세한 내용은 [링크]를 참고해 주세요."
-forbidden:
-  - 과도한 1인칭 감정 표현
-  - 비속어, 인터넷 약어
-  - "~해요" 혼용 (한 문서 내 통일성 깨짐)
-preferred:
-  - "~합니다", "~습니다", "~입니다"
-  - 정확한 기술 용어와 영문 약어 (병기)
-  - "먼저", "다음으로", "마지막으로" 구조 신호어
-  - 코드 블록과 본문이 1:1 mapping
-  - 도식·표·시퀀스 다이어그램
-examples:
-  - "[verify] 이 글에서는 대규모 트래픽 환경에서 캐시 일관성을 유지하는 방법을 다룹니다."
-  - "[verify] 본 시스템은 초당 약 30만 건의 요청을 안정적으로 처리해야 합니다."
-  - "[verify] 자세한 구현은 GitHub 저장소에서 확인하실 수 있습니다."
-sources:
-  - https://d2.naver.com/helloworld (블로그 인덱스 — 직접 fetch 차단됨)
-  - https://engineering.linecorp.com/ko/blog/tag/Technical%20Writing (참고: 자매 코퍼라)
-when_to_use: 엔지니어링 deep-dive, 아키텍처 설명, post-mortem, 컨퍼런스 발표 원고
-when_not_to_use: 마케팅 카피, in-app microcopy
-```
-
-`[verify]` 표시: D2 본문 직접 fetch 불가 — 문체 규약은 다른 NAVER 공식 채널 및 자매 LINE 엔지니어링 블로그에서 추론.
-
----
-
-## 5. `biz-formal-report` — 보고서·기획서 사무체
-
-```yaml
-preset_id: biz-formal-report
-korean_name: 보고서 사무체
-register: 격식체 · 하십시오체 (-합니다) 또는 명사형 종결 (-함, -임, -하였음)
-sentence_length: 30~55자, 짧고 단정
-opening_pattern: "1. 개요 / 본 보고서는 ~을 목적으로 작성되었습니다."
-closing_pattern: "이상입니다." / "검토 후 회신 부탁드립니다." / "끝."
-forbidden:
-  - 1인칭 "저", "우리"의 빈번한 사용 (회사·부서 단위로 대체)
-  - 감정 형용사 ("기분 좋게", "설레는")
-  - 의문문 (선언만)
-  - 이모지·외래어 남용
-preferred:
-  - 섹션 번호 (1.1, 1.2, 1.2.1 …)
-  - 명사형 종결 ("진행함", "확인됨")
-  - "검토", "보고", "회신", "추진" 등 사무 한자어
-  - 결론 → 근거 → 부속자료 순서 (역피라미드)
-  - 핵심 수치 bold 처리
-examples:
-  - "[verify] 본 안건은 2026년 2분기 마케팅 예산 재배분을 목적으로 합니다."
-  - "[verify] 현 운영 채널의 ROAS는 평균 2.4배로, 목표치인 3.0배 대비 미달입니다."
-  - "[verify] 이에 따라 채널 A·B의 예산을 채널 C로 30% 이관할 것을 제안합니다."
-sources:
-  - 한국 MBA 비즈니스 글쓰기 가이드 (참고)
-  - 정부 공문서 작성법 (행정안전부)
-when_to_use: BRD, 기획서, 분기 보고서, 의사결정 메모, 임원 보고
-when_not_to_use: 사외 마케팅, 브랜드 매거진, 커뮤니티 글
-```
-
----
-
-## 6. `academic-paper` — 학술 논문체
-
-```yaml
-preset_id: academic-paper
-korean_name: 학술 논문체
-register: 격식체 · 해라체 변형 ("-한다", "-이다") — 평어체 학술 어조
-sentence_length: 50~90자, 복문 빈번
-opening_pattern: "본 연구는 ~을 목적으로 한다." / "최근 ~에 대한 관심이 증가하고 있다."
-closing_pattern: "후속 연구에서는 ~을 다룰 필요가 있다." / "본 연구의 한계는 ~이다."
-forbidden:
-  - "~요/~네요" 등 비격식체
-  - 1인칭 단수 ("필자"·"본 연구자"로 대체 가능)
-  - 감정 형용사
-  - 인용 없는 단정
-preferred:
-  - "-한다", "-이다", "-였다" 평어체
-  - 한자어 비중 높음 ("선행연구", "유의수준", "검정")
-  - 수동·피동태 ("측정되었다", "분석되었다")
-  - 각주·괄호 인용 (저자, 연도)
-  - "따라서", "그러나", "한편" 등 접속어로 논리 명시
-examples:
-  - "[verify] 본 연구는 한국어 사용자가 디지털 인터페이스에서 경험하는 어미 선택의 인지 부하를 측정하는 것을 목적으로 한다."
-  - "[verify] 분석 결과, 해요체와 하십시오체 간의 처리 속도 차이는 통계적으로 유의하지 않았다(p>.05)."
-  - "[verify] 이러한 결과는 선행 연구(Kim, 2024)와 부분적으로 일치한다."
-sources:
-  - https://www.korean.go.kr/front/onlineQna/onlineQnaView.do?mn_id=261&qna_seq=314653 (격식체 해라체 정의)
-  - http://emunhak.com/chart/69_12_limjr.pdf (임지룡, 학교문법 상대 높임법)
-when_to_use: 학술지 투고, 학위 논문, 정책 연구 보고서
-when_not_to_use: 사용자 대상 마케팅, in-app copy
-```
-
----
-
-## 7. `journalism-broadsheet` — 한겨레/경향 기사체
-
-```yaml
-preset_id: journalism-broadsheet
-korean_name: 신문 기사체
-register: 격식체 · 해라체 변형 ("-다", "-었다")
-sentence_length: 35~60자, 리드 문장은 명확
-opening_pattern: "리드 문장 = 핵심 사실 한 줄. ~가 ~했다고 ~일 밝혔다."
-closing_pattern: "~은 ~라고 덧붙였다." / "한편, ~." (배경 정보로 마무리)
-forbidden:
-  - 1인칭 ("저", "나") — 기명 칼럼 제외
-  - "~요/~네요"
-  - 단정 없이 추측만 나열
-  - 감정 형용사
-preferred:
-  - "-다", "-었다", "-한다", "-된다"
-  - 직접 인용 ("~라고 말했다", "~라고 밝혔다", "~라고 강조했다")
-  - 5W1H 리드
-  - 출처 표기 ("OOO 대표", "복수의 업계 관계자에 따르면")
-  - "한편", "이에 대해", "앞서"
-examples:
-  - "[verify] 정부가 18일 인공지능 기본법 시행령 초안을 공개했다."
-  - "[verify] OOO 과학기술정보통신부 장관은 \"국민의 권리 보호와 산업 진흥의 균형을 맞춘 안\"이라고 밝혔다."
-  - "[verify] 한편 업계에서는 \"세부 기준이 모호해 현장 적용이 어렵다\"는 우려도 제기됐다."
-sources:
-  - https://namu.wiki/w/%ED%95%9C%EA%B2%A8%EB%A0%88
-  - https://namu.wiki/w/%EB%94%B0%EC%98%B4%ED%91%9C%20%EC%A0%80%EB%84%90%EB%A6%AC%EC%A6%98
-  - https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002120963
-when_to_use: 뉴스레터 헤드라인, 보도자료 본문, 기업 블로그의 사실 위주 글
-when_not_to_use: 감성 마케팅, 친밀체 SNS
-```
-
-> Note: `hani.co.kr` 직접 fetch가 차단되어 verbatim 헤드라인 확보 실패. 위 예시는 한국 broadsheet 기사 작성법(따옴표 저널리즘, 리드 5W1H, 인용 어휘 "-라고 밝혔다/말했다/강조했다")을 따라 합성. 실제 적용 시 한겨레·경향 RSS 코퍼스를 fine-tune 보강 권장.
-
----
-
-## 8. `kakao-warm-product` — 카카오 따뜻한 프로덕트 톤
-
-```yaml
-preset_id: kakao-warm-product
-korean_name: 카카오 따뜻한 프로덕트체
-register: 비격식체 · 해요체, Toss보다 약간 더 감정적
-sentence_length: 20~40자, microcopy는 더 짧음
-opening_pattern: "~ 축하해요!" / "~ 하셨네요." / "~을(를) 시작해볼까요?"
-closing_pattern: "오늘도 좋은 하루 보내세요." / "더 알아보기 →"
-forbidden:
-  - 한자어 비즈니스 톤 ("승인", "수행", "처리" — 부드러운 동사로 대체)
-  - 부정·경고 직설 ("실패", "오류" — "다시 시도해볼까요?"로 우회)
-  - 명령형 ("입력하시오" — "입력해주세요")
-preferred:
-  - "축하해요", "고마워요", "함께해요"
-  - 이모지 또는 그래픽 약하게 곁들임
-  - "혜택", "선물", "응원" 어휘
-  - 짧은 의문문 ("같이 시작해볼까요?")
-examples:
-  - "[verify] 카카오뱅크 26퍼센트 적금에 가입하셨어요. 첫 이자, 한 달 뒤에 만나요."
-  - "[verify] 친구에게 마음을 전해보세요. 작은 선물도 큰 응원이 돼요."
-  - "[verify] 이번 달도 잘 해냈어요. 다음 주엔 더 가벼운 마음으로 시작해봐요."
-sources:
-  - https://brunch.co.kr/@kakaobank/16
-  - https://www.kakaocorp.com/page/service/service/KakaoBank
-when_to_use: 금융·메신저 microcopy, 알림, 축하 모먼트, onboarding
-when_not_to_use: 약관, 법적 disclosure, 기술 문서
-```
-
----
-
-## 9. `line-global-saas` — LINE 글로벌 SaaS 한국어
-
-```yaml
-preset_id: line-global-saas
-korean_name: LINE 한국어 (Cross-locale)
-register: 격식체 · 하십시오체 (-합니다) — Naver D2와 유사하나 한자어 비중 더 낮음
-sentence_length: 35~55자, 번역 친화적 단순 구조
-opening_pattern: "이 글에서는 ~을 소개합니다." (정보형) / "안녕하세요, LINE의 ~입니다." (인물형)
-closing_pattern: "감사합니다." / "다음 글에서 ~을 이어 다루겠습니다."
-forbidden:
-  - 한국 내수 전용 비유·시사 (글로벌 동시 번역 시 문제)
-  - 한자어 4자 숙어 ("일석이조" 등) — 일본·영어 번역 시 어색
-  - 비격식체
-preferred:
-  - "~합니다", "~입니다"
-  - SVO 단순 구조, 능동태
-  - 영문 약어 병기 ("LINE 디자인 시스템(LDS)")
-  - "독자", "사용자" 등 중립 호명
-  - 번역 일관성을 위한 통일된 terminology
-examples:
-  - "[verify] 안녕하세요. LINE 디자인 시스템 팀의 OOO입니다."
-  - "[verify] 이 글에서는 LDS(LINE Design System)의 토큰 구조를 소개합니다."
-  - "[verify] 한국어와 일본어 양쪽 독자가 동일한 정보를 얻을 수 있도록 표현을 통일했습니다."
-sources:
-  - https://engineering.linecorp.com/ko/blog
-  - https://engineering.linecorp.com/ko/blog/line-design-system
-  - https://creative.line.me/ko/blog/57
-when_to_use: 다국어 동시 발행 콘텐츠, 글로벌 SaaS 제품 release note, cross-locale onboarding
-when_not_to_use: 지역 밀착 마케팅, 비격식 SNS
-```
-
----
-
-## 10. `academic-lecture-essay` — 교양 강연·에세이체
-
-```yaml
-preset_id: academic-lecture-essay
-korean_name: 교양 강연체
-register: 비격식체 · 해요체 우세, 학술 한자어 자유롭게 혼용
-sentence_length: 40~70자, 강의처럼 호흡 길게
-opening_pattern: "여러분, ~을 한 번 생각해볼까요?" / "오늘은 ~ 이야기를 해보려고 합니다."
-closing_pattern: "결국 ~인 거죠." / "그래서 저는 ~라고 생각해요."
-forbidden:
-  - 무지·반지성 표현
-  - 보고서식 bullet
-  - 인용 없는 단정
-preferred:
-  - "~인 거죠", "~라는 거예요"
-  - 청자에게 묻는 구조 ("그렇다면 왜 그럴까요?")
-  - 비유와 일상 예시
-  - 학문 한자어 사용하되 즉시 풀이 ("엔트로피, 그러니까 무질서의 정도")
-  - 1인칭과 2인칭 호명 교차
-examples:
-  - "[verify] 여러분, '시간이 흐른다'는 표현은 정말 정확한 걸까요?"
-  - "[verify] 물리학에서는 시간을 그저 좌표축의 하나로 봅니다. 그런데 우리 몸은, 그걸 그렇게 받아들이지 않거든요."
-  - "[verify] 그래서 저는 인문학과 과학이 결국 같은 질문을 다르게 묻는 거라고 생각해요."
-sources:
-  - https://product.kyobobook.co.kr/detail/S000001015900 (유시민, 글쓰기 특강)
-  - https://namu.wiki/w/%EA%B0%95%EC%8B%A0%EC%A3%BC
-  - https://www.youtube.com/watch?v=n1BUUOC9CO4 (유시민 × 김상욱)
-when_to_use: 인사이트 토크 스크립트, 강연 원고, 교양서 본문, 팟캐스트 대본
-when_not_to_use: 짧은 in-app microcopy, 보고서
-```
-
----
-
-## 11. `emotional-brand` — 무신사/29CM 패션 커머스체
-
-```yaml
-preset_id: emotional-brand
-korean_name: 패션 커머스 트렌디체
-register: 비격식체 · 해요체와 명사·체언 종결 자유 혼용 ("오늘의 픽.", "에디터의 추천.")
-sentence_length: 15~30자 (헤드라인·카드 카피), 본문은 40자 내외
-opening_pattern: 명사형 후크 — "이번 주의 무드." / "여름밤, 우리가 입어야 할 것."
-closing_pattern: "지금, [브랜드]에서." / "더 보기 →"
-forbidden:
-  - 보고서 한자어
-  - "~합니다" 일변도 (브랜드 거리감 발생)
-  - 길고 설명적인 문장
-preferred:
-  - 외래어·영문 자유롭게 ("무드", "감도", "베이직", "에디트")
-  - 체언/명사 종결 ("오늘의 픽.")
-  - 컬러·재질·실루엣 어휘
-  - 시즌·시간성 cue ("이번 주", "오늘 밤", "5월의")
-  - 짧은 명령형 ("입어볼 것.", "기억해둘 것.")
-examples:
-  - "[verify] 5월, 다시 입고 싶은 화이트 셔츠 7."
-  - "[verify] 무드는 가볍게, 디테일은 단단하게."
-  - "[verify] 오늘 밤, 이 재킷 하나면 충분해요."
-sources:
-  - https://www.musinsa.com/content/list?contentCategoryCode=001001
-  - https://www.musinsa.com/mz/magazine/brandlookbook/report/68772
-when_to_use: 패션·라이프스타일 커머스 카피, 매거진 헤드라인, 큐레이션 카드
-when_not_to_use: 기능적 알림, 약관, 학술
-```
-
----
-
-## 12. `legal-disclosure` — 법무·약관 고지체
-
-```yaml
-preset_id: legal-disclosure
-korean_name: 법무 약관체
-register: 격식체 · 하십시오체 (-합니다) 우세, 명사·종결도 사용 ("~의무가 있습니다", "~함")
-sentence_length: 50~100자, 의도적으로 길고 한정조건 빽빽
-opening_pattern: "본 약관은 ~을 규정함을 목적으로 합니다." / "제1조 (목적)"
-closing_pattern: "본 약관은 ~일부터 시행합니다." / "부칙. ~"
-forbidden:
-  - 1인칭, 2인칭 친밀 표현
-  - 비격식체
-  - 감정 형용사
-  - 모호한 수식 ("좀", "약간")
-preferred:
-  - "~합니다", "~됩니다", "~할 수 있습니다"
-  - 수동·피동 ("간주됩니다", "처리됩니다")
-  - 정의 조항 ("이 약관에서 사용하는 용어의 정의는 다음과 같습니다.")
-  - 법률 한자어 ("의무", "책임", "면책", "준수")
-  - 조·항·호 번호 체계
-examples:
-  - "[verify] 회사는 관련 법령 및 본 약관에 따라 회원에게 서비스를 제공할 의무가 있습니다."
-  - "[verify] 회원은 본인의 계정정보를 제3자에게 양도 또는 대여할 수 없으며, 이를 위반함으로써 발생한 손해에 대해 책임을 부담합니다."
-  - "[verify] 본 약관에 명시되지 아니한 사항은 관계 법령 및 회사가 정한 운영 정책에 따릅니다."
-sources:
-  - 「약관의 규제에 관한 법률」 (국가법령정보센터)
-  - 일반 SaaS 서비스 이용약관 (관례)
-when_to_use: 이용약관, 개인정보 처리방침, 마케팅 수신 동의, 금융상품 설명서
-when_not_to_use: in-app onboarding, 브랜드 매거진, 마케팅 푸시
-```
-
----
-
-## 13. 한국어 문체론 — 이론적 토대
-
-`omd-kr-writer`가 register를 정확히 끊으려면 학교문법 상대 높임법(상대 경어법) 6단계를 내부 모델로 가져야 한다.
-
-### 6단계 speech levels
-
-| 등급 | 종결 어미 예 | 격식/비격식 | 현대 사용도 |
-|---|---|---|---|
-| 하십시오체 | -합니다, -십시오, -입니까 | 격식체 (최상 존대) | 공식·보도·약관·연설 |
-| 하오체 | -하오, -이오 | 격식체 (중간) | 사극·문학 외 거의 사라짐 |
-| 하게체 | -하게, -이네 | 격식체 (하위 존대) | 윗사람이 친한 아랫사람에게 |
-| 해라체 | -한다, -이다, -해라 | 격식체 (낮춤) | 신문 기사·논문·일기 평어체 |
-| 해요체 | -해요, -이에요, -지요 | 비격식체 (두루높임) | 일상 대화·서비스 카피·블로그 |
-| 해체(반말) | -해, -야, -지 | 비격식체 (두루낮춤) | 친구·가족·SNS |
-
-(출처: 국립국어원 온라인가나다, 임지룡 「학교문법 상대 높임법의 새로운 이해」, 한국민족문화대백과사전 '공손법'.)
-
-핵심 통찰 세 가지:
-
-1. **격식체 ≠ 존대도 최고가 아니다.** 하십시오체와 해요체 모두 청자에 대한 높임을 표현하지만, 해요체는 "부드럽고 주관적"이고 하십시오체는 "직접적이고 객관적"이다. Toss·Karrot이 해요체를 택한 건 친밀감 때문이지 예의를 낮춘 게 아니다.
-2. **문어 평어체(해라체 변형 "-한다")는 낮춤이 아니라 중립이다.** 신문 기사·학술 논문이 "-한다"를 쓰는 건 청자를 낮추는 게 아니라 청자 자체를 상정하지 않는 비대면 문어 관습이다.
-3. **한 문서 내 register 혼용은 비용이 크다.** 사용자는 본능적으로 어미 일관성을 신뢰 신호로 읽는다. preset 전환은 글 단위·섹션 단위로만 수행하고, 한 문단 안에서는 절대 섞지 않는다.
-
-### 어말어미 우선순위 (writer agent 구현 시 1순위 규칙)
-
-```
-register → 어말어미 family
-─────────────────────────
-biz-formal-report, legal-disclosure, line-global-saas, naver-d2-engineering
-    → -합니다 / -입니다 / -습니다
-journalism-broadsheet, academic-paper
-    → -다 / -었다 / -이다 / -한다
-toss-tech-design, karrot-neighborly, kakao-warm-product, academic-lecture-essay
-    → -요 / -이에요 / -네요 / -죠 / -거든요
-brunch-maker-popular
-    → -이다 + -요 자유 혼용 (문단 단위)
-emotional-brand
-    → 명사·체언 종결 + -요 혼용
-```
-
----
-
-## 14. Style transition matrix — 6 high-traffic conversions
-
-각 전환은 5개의 rewrite rule로 정리. 코드 안전성 기준: rule을 위에서부터 순차 적용하면 register 충돌이 발생하지 않는다.
-
-### 14.1 `biz-formal-report` → `toss-tech-design`
-
-1. `-합니다` → `-해요`, `-됩니다` → `-돼요`, `-입니다` → `-이에요`
-2. 한자어 → 우리말: 사용자→쓰는 사람, 적용하다→쓰다, 진행하다→해보다, 검토→살펴봄
-3. 50자 초과 문장은 마침표로 쪼개기 (한 문장 한 호흡)
-4. 명사형 종결("진행함", "확인됨")은 동사 서술로 풀기 → "해봤어요", "확인했어요"
-5. 회사·부서 주어 → 1인칭 ("저희 팀은", "저는")
-
-### 14.2 `toss-tech-design` → `biz-formal-report`
-
-1. `-해요` → `-합니다`, `-거든요` → `-기 때문입니다`
-2. 1인칭 → 회사·부서 ("저희 팀" → "본 부서" 또는 회사명)
-3. "오늘은 ~ 나눠보려고 해요" 류 인삿말 제거 → "본 보고서는 ~을 목적으로 합니다."
-4. 결론 → 근거 → 부속자료의 역피라미드 재배열, 섹션 번호 부여
-5. 감정 형용사 제거 ("당황스러웠을 거예요" → 삭제 또는 "사용자 이탈률이 증가하였습니다")
-
-### 14.3 `academic-paper` → `toss-tech-design`
-
-1. `-한다`, `-이다`, `-였다` → `-해요`, `-이에요`, `-했어요`
-2. "본 연구는", "필자는" → "저는", "우리는"
-3. 수동태 ("측정되었다") → 능동태 ("측정했어요")
-4. 한자어 비중 50% 이상 → 30% 이하 (선행연구→앞선 연구, 유의수준→통계적으로 의미 있는 차이)
-5. 각주 인용 → 본문 내 자연어 인용 ("Kim(2024)이 보여줬듯이" → "예전에 다른 팀이 비슷한 실험을 했는데요,")
-
-### 14.4 `karrot-neighborly` → `toss-tech-design`
-
-1. "이웃", "동네" 어휘 → "사용자", "고객" 대신 "쓰는 사람", "여러분"
-2. "정답다", "다정한", "온기" 등 정서어 → 감각·기능 어휘 ("선명한", "빠른", "정확한")
-3. 골목·계절 묘사 → 제품·기능 묘사
-4. 호명 "이웃 여러분" → "여러분"
-5. 어미는 거의 그대로 (-요 유지) — 가장 가벼운 transition
-
-### 14.5 `journalism-broadsheet` → `toss-tech-design`
-
-1. `-다`, `-했다`, `-밝혔다` → `-해요`, `-했어요`, `-말했어요` (또는 인용을 자기 해설로 변환)
-2. 5W1H 리드 → narrative 인삿말 ("오늘은 ~ 이야기를 해보려고 해요.")
-3. 3인칭 출처 → 1인칭 ("정부는 ~밝혔다" → "정부가 발표한 안을 한 번 같이 살펴볼게요.")
-4. 직접 인용 + "-라고 밝혔다" → 풀어쓴 요약
-5. "한편" 같은 신문 접속사 제거
-
-### 14.6 `legal-disclosure` → `kakao-warm-product`
-
-1. 50~100자 한정조건 문장 → 20~30자 microcopy로 분리, 핵심만
-2. "~할 수 없으며, 이를 위반함으로써 발생한 손해에 대해 책임을 부담합니다." → "이 정보는 본인만 알 수 있게 보관해주세요."
-3. 법률 한자어 → 일상어 ("양도·대여" → "공유")
-4. 수동태 → 능동태
-5. 약관 본문 링크는 그대로 유지하되 noticeable CTA로 분리 ("자세한 내용은 [약관 보기]")
-
-### 14.7 (bonus) `academic-paper` → `academic-lecture-essay`
-
-1. `-한다` → `-해요`, `-는 것이다` → `-는 거예요`
-2. 1인칭 "필자" → "저"
-3. 각주 인용 → 본문 자연어 ("Smith(2020)에 따르면" → "예전에 어떤 학자가 이렇게 말했어요,")
-4. 한자어는 유지하되 즉시 풀이 ("엔트로피, 그러니까 무질서의 정도")
-5. 청자 호명 추가 ("여러분, 한 번 생각해볼까요?")
-
----
-
-## 15. Agent 구현 권장사항 (oh-my-design specific)
-
-1. **Preset selector는 enum**: `omd-kr-writer --preset toss-tech-design` 같이 ID 단위로만 받기. 자연어 입력("토스처럼 써줘")은 selector resolver가 ID로 매핑.
-2. **한 문서 = 한 preset 원칙**: 섹션 단위 mixed preset 요청은 명시적으로 `--sections preset1,preset2`로 받기. 한 문단 안에서는 절대 섞지 않음.
-3. **검증 단계**: 출력 후 `register check` — 의도한 어미 family와 실제 종결 어미가 일치하는지 regex 검증 (예: toss preset인데 `-합니다`가 등장하면 fail).
-4. **금칙어 표**: 각 preset의 `forbidden` 항목을 검증기로 변환. legal-disclosure preset인데 이모지·해요체 출현 시 fail.
-5. **Verbatim 코퍼스 보강**: `[verify]` 표시된 preset은 운영자가 실제 브랜드 글 5~10편을 첨부 코퍼스로 확보해야 fine-tune 품질이 보장된다. 특히 brunch-maker-popular·academic-lecture-essay·emotional-brand는 작가 본인 동의를 받은 corpus가 필요.
-6. **Transition 호출**: rewrite 작업 시 `--from preset_a --to preset_b`로 14절 매트릭스를 lookup. 매트릭스에 없는 페어는 두 단계로 분할 (예: legal-disclosure → karrot 은 legal → biz → toss → karrot처럼 register family 한 칸씩 이동).
-
----
-
-## Sources (cited URLs)
-
-- https://toss.tech/article/8-writing-principles-of-toss
-- https://toss.tech/article/layers-of-your-time
-- https://github.com/toss/technical-writing
-- https://about.daangn.com/blog/archive/%EB%8B%B9%EA%B7%BC-%EB%A6%AC%EB%B8%8C%EB%9E%9C%EB%94%A9-%ED%94%84%EB%A1%9C%EC%84%B8%EC%8A%A4-%EB%B8%8C%EB%9E%9C%EB%93%9C/
-- https://medium.com/daangn
-- https://designcompass.org/2023/08/29/danggun/
-- https://engineering.linecorp.com/ko/blog
-- https://engineering.linecorp.com/ko/blog/line-design-system
-- https://engineering.linecorp.com/ko/blog/tag/Technical%20Writing
-- https://creative.line.me/ko/blog/57
-- https://d2.naver.com/helloworld
-- https://brunch.co.kr/@thinkaboutlove/403
-- https://brunch.co.kr/@kakaobank/16
-- https://brunch.co.kr/@kellypoly/62
-- https://www.musinsa.com/content/list?contentCategoryCode=001001
-- https://www.musinsa.com/mz/magazine/brandlookbook/report/68772
-- https://product.kyobobook.co.kr/detail/S000001015900 (유시민, 《유시민의 글쓰기 특강》)
-- https://namu.wiki/w/%ED%95%9C%EA%B2%A8%EB%A0%88
-- https://namu.wiki/w/%EB%94%B0%EC%98%B4%ED%91%9C%20%EC%A0%80%EB%84%90%EB%A6%AC%EC%A6%98
-- https://namu.wiki/w/%ED%95%98%EC%8B%AD%EC%8B%9C%EC%98%A4%EC%B2%B4
-- https://namu.wiki/w/%ED%95%B4%EB%9D%BC%EC%B2%B4
-- https://namu.wiki/w/%EA%B0%84%EA%B2%B0%EC%B2%B4
-- https://www.korean.go.kr/front/onlineQna/onlineQnaView.do?mn_id=261&qna_seq=314653 (국립국어원 — 격식체의 해라체)
-- https://encykorea.aks.ac.kr/Article/E0079632 (한국민족문화대백과사전 — 공손법)
-- http://emunhak.com/chart/69_12_limjr.pdf (임지룡, 「학교문법 상대 높임법의 새로운 이해」)
-- https://www.kci.go.kr/kciportal/ci/sereArticleSearch/ciSereArtiView.kci?sereArticleSearchBean.artiId=ART002120963 (TV방송과 신문보도의 문체적 특성)
-- https://ratsgo.github.io/korean%20linguistics/2017/11/01/honorification/
-
----
-
-## Confidence & gaps
-
-- **High confidence** (verbatim source harvested): toss-tech-design, karrot-neighborly, kakao-warm-product (Brunch 인용).
-- **Medium confidence** (structural rules verified, examples synthesized to spec): biz-formal-report, academic-paper, journalism-broadsheet, legal-disclosure, line-global-saas, emotional-brand, academic-lecture-essay.
-- **Low confidence / `[verify]` flagged** at example level: brunch-maker-popular (Brunch 본문 무단 인용 제한), naver-d2-engineering (`d2.naver.com` 직접 fetch 차단), journalism-broadsheet (`hani.co.kr` 직접 fetch 차단).
-- **Recommended next step**: operator-provided corpus 5~10 articles per `[verify]` preset, then re-run example harvest with site-specific scrapers.