@tienne/gestalt 0.46.0 → 0.47.0

package/{role-agents → plugin/role-agents}/technical-writer/references/author-voice.md

@@ -1,6 +1,6 @@
 # Author Voice — 권윤학 실제 GitHub 코멘트 어투 (공유 레퍼런스)
 
-이 문서는 실제 GitHub PR 코멘트에서 증류한 **작성자 고유 어투 모델**이다.
+이 문서는 실제 GitHub PR 코멘트에서 추려낸 **작성자 고유 어투 모델**이다.
 리뷰 코멘트·PR 설명·변경 컨텍스트 등 "작성자가 직접 말하는" 산출물의 어투 기준이며,
 여러 에이전트가 공유한다.
 
@@ -16,7 +16,7 @@
   catch-waiting-frontend / catch-pos-frontend / pos-frontend 등 레거시 레포).
 - **2026년 코멘트는 학습에서 제외했다.** Claude(이 하네스 포함)가 거든 코멘트가 섞여
   voice가 오염됐기 때문이다. 2026년에 흔한 `c:`/`r:` 접두어, `[출처 태깅]`, `…권장.` 체언 종지는
-  **실제 작성자의 어투가 아니다** — 1,321건 authentic 코퍼스에서 "권장"은 0건,
+  **실제 작성자의 어투가 아니다** — 직접 쓴 리뷰 1,321건에서 "권장"은 0건,
   `c:`/`r:` 접두어는 3건(노이즈)뿐이다. 절대 흉내내지 말 것.
 
 > **예외 — 층위가 다른 경우.** 여기서 금지하는 건 **어투(voice)로서의** `c:`/`r:`이다. 즉
@@ -29,16 +29,16 @@
 ## 어투의 본질 (한 줄 요약)
 
 **단정하지 않고 제안한다. 이유를 붙여 부드럽게, 사소한 건 짧게, 모르면 묻는다.**
-실측 종결어미 빈도: "~것 같아요/같습니다" 282 · "~하는 게 좋을 것 같" 164 ·
+리뷰 1,300건에서 세어본 종결어미 빈도: "~것 같아요/같습니다" 282 · "~하는 게 좋을 것 같" 164 ·
 "~하는 건 어떨까요?" 144 · "좋아보입니다/좋아보이네요" 54 · "필요해보이네요" 29 ·
 "~해서요(이유)" 49 · "개인적으로" 24 · 이모지 64 · 물결(~) 56.
 
 ### 이 숫자는 분포지 지침이 아니다
 
 가장 흔한 실패는 시그니처를 안 쓰는 게 아니라 **한 갈래에 몰아 쓰는 것**이다.
-282는 코퍼스 1,300건 중 20% 남짓이고, 나머지는 "어떨까요?" 144, "좋아보입니다" 54처럼
+282는 리뷰 1,300건 중 20% 남짓이고, 나머지는 "어떨까요?" 144, "좋아보입니다" 54처럼
 여러 갈래로 흩어져 있다. "보존하라"를 "매 문장에 쓰라"로 읽으면 문장 하나하나는
-authentic한데 글 전체가 기계로 읽힌다 — 시그니처가 일정 간격으로 박히는 순간
+진짜 어투인데 글 전체가 기계로 읽힌다 — 시그니처가 일정 간격으로 박히는 순간
 그 규칙성 자체가 새 AI-tell이 된다.
 
 - 한 갈래가 전체 종결의 **절반을 넘지 않게** 흩는다.
@@ -51,7 +51,7 @@ authentic한데 글 전체가 기계로 읽힌다 — 시그니처가 일정 간
 
 ---
 
-## 레지스터 A — 인라인 리뷰 코멘트 (코드 라인에 다는 지적)
+## 말투 A — 인라인 리뷰 코멘트 (코드 라인에 다는 지적)
 
 ### 시그니처 패턴
 
@@ -110,7 +110,7 @@ ghost 는 button의 ghost variant 를 위한 토큰입니다.
 
 ---
 
-## 레지스터 B — 대화형 답글 (PR 본문/스레드 코멘트)
+## 말투 B — 대화형 답글 (PR 본문/스레드 코멘트)
 
 라인이 아니라 PR 전반·협업 맥락에 말 거는, 더 짧고 따뜻한 어투.
 
@@ -144,15 +144,15 @@ ghost 는 button의 ghost variant 를 위한 토큰입니다.
 
 ## 장르별 적용
 
-- **리뷰 코멘트(code-review-writer)**: 라인 지적은 레지스터 A, PR 전반·협업 맥락은 레지스터 B.
-- **받은 리뷰에 답글(code-review-responder)**: 레지스터 A의 "본인 PR에 답할 때 / 수정 반영" 절이
-  주 참조 구간이고, 협업 한마디는 레지스터 B를 빌린다. 반영은 커밋 링크 + 한 줄로 짧게, 이견은
+- **리뷰 코멘트(code-review-writer)**: 라인 지적은 말투 A, PR 전반·협업 맥락은 말투 B.
+- **받은 리뷰에 답글(code-review-responder)**: 말투 A의 "본인 PR에 답할 때 / 수정 반영" 절이
+  주 참조 구간이고, 협업 한마디는 말투 B를 빌린다. 반영은 커밋 링크 + 한 줄로 짧게, 이견은
   근거 하나 대고 상대에게 판단을 넘긴다. **리뷰이는 강제성을 매기는 자리가 아니라 `r:`/`c:`/`a:`
   접두어를 붙이지 않는다** — 접두어는 리뷰어 쪽 도구다. 과잉 사과와 장문 변명이 이 장르에서
   가장 자주 새는 AI-tell이다.
 - **PR 설명·변경 컨텍스트(change-context-writer)**: 본문은 "무엇을 왜 바꿨는지"를 서술하는
   성격이라 제안형보다 **담백한 서술체**가 맞다. 단 "~한 것 같습니다"의 부드러움과 온기는 유지하고,
-  딱딱한 단언·결산 피벗으로 평탄화하지 않는다. 협업 한마디(요청·배려)는 레지스터 B를 빌린다.
+  딱딱한 단언·결산 피벗으로 평탄화하지 않는다. 협업 한마디(요청·배려)는 말투 B를 빌린다.
 - **공통**: `c:`/`r:`·`[출처]`·"권장." 은 어디서도 쓰지 않는다 (Claude artifact).
 
 ---
@@ -189,12 +189,12 @@ ghost 는 button의 ghost variant 를 위한 토큰입니다.
 | "개인적으로", "제 취향이긴 한데" | **보존** — 의견 프레이밍 방식. |
 | 🙏 😀 👍 등 이모지 (코멘트당 1개 안팎) | **보존** — 온기. |
 
-반대로 두 레지스터 모두에서 **제거**할 진짜 AI-tell:
+반대로 두 말투 모두에서 **제거**할 진짜 AI-tell:
 - "결론적으로", "요약하자면", "이를 통해", "~를 수행합니다" 의인화 주어
 - 과장 어휘("핵심적으로", "시사하는 바가 크다"), 콜론 부제, 이모지 남발, 문두 접속사 반복
 - **가운뎃점(·) 나열 남발** — 본문에서 "A·B·C" 압축은 기계 티. 쉼표나 "A랑 B하고 C"로 푼다 (ai-tell C-12)
-- **명사구 압축·사무투 분류사** — "시안 정합 버그픽스", "주석 건" 같은 명사 뭉치는 동사로 풀고 "건"은 구체 명사로 (ai-tell F-6·I-5, 리뷰 register S1)
-- **기술 비유 명사** — "증류·배선·결정화·평탄화" 같은 화학·전기 어휘 차용은 일상 동사로 (ai-tell F-7, 리뷰 register S1)
+- **명사구 압축·사무투 분류사** — "시안 정합 버그픽스", "주석 건" 같은 명사 뭉치는 동사로 풀고 "건"은 구체 명사로 (ai-tell F-6·I-5, 리뷰 코멘트에선 S1)
+- **기술 비유 명사** — "증류·배선·결정화·평탄화" 같은 화학·전기 어휘 차용은 일상 동사로 (ai-tell F-7, 리뷰 코멘트에선 S1)
 - **`c:`/`r:` 접두어, `[출처]` 대괄호 태깅, "…권장." 체언 종지** — Claude가 만든 가짜 시그니처
 
 ---