@tienne/gestalt 0.41.0 → 0.41.1

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.41.0",
+  "version": "0.41.1",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "type": "module",
   "main": "./dist/src/index.js",

package/dist/role-agents/technical-writer/references/ai-tell-quick-rules.md

@@ -10,6 +10,8 @@
 
 **과윤문 가드:** 변경률 30% 초과 = 경고, 50% 초과 = 강제 중단·롤백.
 
+**register 감도 (중요):** 같은 명사화·번역투라도 **대화·리뷰 코멘트 register에서는 문서보다 훨씬 튄다.** 문서(칼럼·리포트) 기준 S2인 F-4·F-5·F-6·F-7·I-5·A-5 계열은 대화·리뷰 코멘트에서 **S1로 격상**해 교정한다. 사람은 대화에서 개념을 명사 덩어리로 뭉치지 않고 동사로 풀어 말하기 때문이다.
+
 ---
 
 ## A. 번역투 (Translation-ese)
@@ -79,6 +81,8 @@
 |---|---|---|---|
 | F-4 | 한자어 명사화 -성/-적/-화 + 영어 명사화 -tion/-ment/-ness/-ity 누적 (한 글 12회+) | S2 | 동사·형용사 어근으로 환원("the implementation of the policy" → "정책 시행" 또는 "정책을 시행하기") |
 | F-5 | "~적 N" 추상 체인 ("전략적 함의·실천적 기반") | S2 | 명사+명사 또는 풀어쓰기("전략 함의·실천의 기반") |
+| F-6 | 복합명사 압축 — 명사구를 조사·동사 없이 이어붙여 개념을 뭉침 ("시안 정합 버그픽스", "유지보수성 개선 작업", "권한 체크 로직") | S2 / **대화·리뷰 S1** | 동사·조사로 풀어 서술 ("디자인 시안과 다르게 렌더링되던 문제", "나중에 유지보수하기 편하게"). 사람은 압축 명사구 대신 무엇을 왜 했는지 풀어 말한다 |
+| F-7 | 기술·이공계 비유 명사를 일상 대화에 그대로 (증류·배선·결정화·평탄화·오케스트레이션·파이프라인화 등, 화학·전기·수학 어휘의 비유 차용) | S2 / **대화·리뷰 S1** | 일상 동사로 환원 (증류 → "추려내다/뽑아내다", 배선 → "연결하다/걸어두다", 결정화 → "정리하다", 평탄화 → "밋밋하게 만들다"). 문법은 멀쩡해 룰 매칭이 안 되지만 사람은 대화에서 안 쓴다. 도메인 정식 용어(코드의 "파이프라인" 자체 등)는 예외 |
 
 ## G. Hedging
 
@@ -104,6 +108,7 @@
 | I-2 | "X은 ~라는 점에 있다" | S2 | "X는 ~다" 직설로 |
 | I-3 | "~다는 뜻이다/~다는 의미다" 결말 | S2 | 본문에 풀어 쓰기 |
 | I-4 | 권고형 결말 "~해야 한다·~합니다" 반복 | S2 | 평서·단언으로 |
+| I-5 | 사무투 분류사 "~ 건/해당 건/이번 건/그 건", 코드·문서 용어를 대화에 그대로("주석 건") | S2 / **대화·리뷰 S1** | 구체 명사로 풀기("Copilot이 짚은 주석 건" → "Copilot이 남긴 코멘트"). "건"은 공문서투 분류사라 대화에서 어색하다 |
 
 ## J. 시각 장식
 
@@ -123,7 +128,7 @@
 2. **변경률**: 30% 이하인가 (50% 초과는 작업 중단)
 3. **장르 이탈 없음**: 칼럼이 에세이·문학으로 변하지 않았는가, 리포트가 블로그체로 떨어지지 않았는가
 4. **register 보존**: 원문 격식체면 결과도 격식체. 평어체로 떨어뜨리지 않는다
-5. **잔존 S1 패턴 0건**: D-1~D-7, A-7, A-8, A-16, B-3, C-5, C-10, C-11, C-12, H-1, I-1, J-2 핵심 S1이 남아있지 않은가
+5. **잔존 S1 패턴 0건**: D-1~D-7, A-7, A-8, A-16, B-3, C-5, C-10, C-11, C-12, H-1, I-1, J-2 핵심 S1이 남아있지 않은가 (대화·리뷰 register면 F-6·F-7·I-5·F-4·F-5·A-5도 S1로 포함)
 6. **인공 표현 자제**: 원문에 없던 비유·수사·문학적 표현을 윤문 과정에서 임의로 추가하지 않았는가
 
 위반 시: edit 롤백 → 다시 윤문 → 재점검. 자체 루프 최대 1회. 이상 미해결이면 결과를 그대로 출력하되 `summary.md`에 "자가검증 미통과 항목 N건" 표기.

package/dist/role-agents/technical-writer/references/author-voice.md

@@ -135,6 +135,26 @@ ghost 는 button의 ghost variant 를 위한 토큰입니다.
 
 ---
 
+## 명사로 뭉치지 말고 풀어 말하기 (자주 새는 사각지대)
+
+가장 티 나는 AI 흔적은 번역투나 헤징이 아니라 **개념을 명사 덩어리로 압축하는 습관**이다.
+사람은 대화·리뷰 코멘트에서 "무엇을 왜 했는지"를 동사로 풀어 말하지, 명사구를 이어붙여 뭉치지 않는다.
+아래 세 쌍은 실제 리뷰 코멘트에서 나온 교정 사례다. 그대로 학습한다.
+
+| AI가 쓴 것 (before) | 사람이 쓸 것 (after) | 원인 |
+|---|---|---|
+| 시안 정합 버그픽스 잘 확인했습니다 | 디자인 시안이랑 다르게 나오던 거 고친 거 잘 봤어요 | 명사구 압축(F-6) |
+| Copilot이 짚은 주석 건도 반영되셨네요 | Copilot이 남긴 코멘트도 반영하셨네요 | 사무투 분류사 "건"(I-5) + 코드 용어 "주석" |
+| 유지보수성 관련해서 한 가지만 작게 남겨요 | 나중에 유지보수할 때 생각해서 코멘트 하나만 남길게요 | 명사화 "-성"(F-4) + "관련해서"(A-5) + 목적어 생략 |
+| 규칙을 전 소비자에게 배선했습니다 | 규칙을 소비자 전부에 연결해뒀어요 | 기술 비유 명사 "배선"(F-7) |
+| 코멘트에서 지식을 증류해 반영했어요 | 코멘트에서 쓸 만한 걸 추려서 반영했어요 | 기술 비유 명사 "증류"(F-7) |
+
+**목적어를 생략하지 말 것.** "한 가지만 작게 남겨요"처럼 무엇을 남기는지(코멘트·의견)를 빼고
+형식 수량사("한 가지")와 어색한 부사("작게")로 때우면 붕 뜬다. "코멘트 하나 남길게요",
+"의견 하나만 보탤게요"처럼 목적 명사를 살린다.
+
+---
+
 ## humanize-monolith 와의 관계 (중요)
 
 `humanize-monolith`의 S1 규칙은 **AI-tell 제거용**이라, 이 voice와 충돌하는 부분이 있다.
@@ -151,6 +171,8 @@ ghost 는 button의 ghost variant 를 위한 토큰입니다.
 - "결론적으로", "요약하자면", "이를 통해", "~를 수행합니다" 의인화 주어
 - 과장 어휘("핵심적으로", "시사하는 바가 크다"), 콜론 부제, 이모지 남발, 문두 접속사 반복
 - **가운뎃점(·) 나열 남발** — 본문에서 "A·B·C" 압축은 기계 티. 쉼표나 "A랑 B하고 C"로 푼다 (ai-tell C-12)
+- **명사구 압축·사무투 분류사** — "시안 정합 버그픽스", "주석 건" 같은 명사 뭉치는 동사로 풀고 "건"은 구체 명사로 (ai-tell F-6·I-5, 리뷰 register S1)
+- **기술 비유 명사** — "증류·배선·결정화·평탄화" 같은 화학·전기 어휘 차용은 일상 동사로 (ai-tell F-7, 리뷰 register S1)
 - **`c:`/`r:` 접두어, `[출처]` 대괄호 태깅, "…권장." 체언 종지** — Claude가 만든 가짜 시그니처
 
 ---
@@ -164,3 +186,4 @@ ghost 는 button의 ghost variant 를 위한 토큰입니다.
 5. 수정 제안은 코드·토큰 값까지 구체적으로.
 6. 친근체·물결·이모지는 자연스럽게, 과하지 않게.
 7. `c:`/`r:`·`[출처]`·"권장." 은 쓰지 않는다 (Claude artifact).
+8. 개념을 명사로 뭉치지 말고 동사로 푼다("시안 정합 버그픽스" → "시안이랑 다르게 나오던 거"). "건" 같은 사무투 분류사와 생략된 목적어를 되살린다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.41.0",
+  "version": "0.41.1",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "type": "module",
   "main": "./dist/src/index.js",

package/role-agents/technical-writer/references/ai-tell-quick-rules.md

@@ -10,6 +10,8 @@
 
 **과윤문 가드:** 변경률 30% 초과 = 경고, 50% 초과 = 강제 중단·롤백.
 
+**register 감도 (중요):** 같은 명사화·번역투라도 **대화·리뷰 코멘트 register에서는 문서보다 훨씬 튄다.** 문서(칼럼·리포트) 기준 S2인 F-4·F-5·F-6·F-7·I-5·A-5 계열은 대화·리뷰 코멘트에서 **S1로 격상**해 교정한다. 사람은 대화에서 개념을 명사 덩어리로 뭉치지 않고 동사로 풀어 말하기 때문이다.
+
 ---
 
 ## A. 번역투 (Translation-ese)
@@ -79,6 +81,8 @@
 |---|---|---|---|
 | F-4 | 한자어 명사화 -성/-적/-화 + 영어 명사화 -tion/-ment/-ness/-ity 누적 (한 글 12회+) | S2 | 동사·형용사 어근으로 환원("the implementation of the policy" → "정책 시행" 또는 "정책을 시행하기") |
 | F-5 | "~적 N" 추상 체인 ("전략적 함의·실천적 기반") | S2 | 명사+명사 또는 풀어쓰기("전략 함의·실천의 기반") |
+| F-6 | 복합명사 압축 — 명사구를 조사·동사 없이 이어붙여 개념을 뭉침 ("시안 정합 버그픽스", "유지보수성 개선 작업", "권한 체크 로직") | S2 / **대화·리뷰 S1** | 동사·조사로 풀어 서술 ("디자인 시안과 다르게 렌더링되던 문제", "나중에 유지보수하기 편하게"). 사람은 압축 명사구 대신 무엇을 왜 했는지 풀어 말한다 |
+| F-7 | 기술·이공계 비유 명사를 일상 대화에 그대로 (증류·배선·결정화·평탄화·오케스트레이션·파이프라인화 등, 화학·전기·수학 어휘의 비유 차용) | S2 / **대화·리뷰 S1** | 일상 동사로 환원 (증류 → "추려내다/뽑아내다", 배선 → "연결하다/걸어두다", 결정화 → "정리하다", 평탄화 → "밋밋하게 만들다"). 문법은 멀쩡해 룰 매칭이 안 되지만 사람은 대화에서 안 쓴다. 도메인 정식 용어(코드의 "파이프라인" 자체 등)는 예외 |
 
 ## G. Hedging
 
@@ -104,6 +108,7 @@
 | I-2 | "X은 ~라는 점에 있다" | S2 | "X는 ~다" 직설로 |
 | I-3 | "~다는 뜻이다/~다는 의미다" 결말 | S2 | 본문에 풀어 쓰기 |
 | I-4 | 권고형 결말 "~해야 한다·~합니다" 반복 | S2 | 평서·단언으로 |
+| I-5 | 사무투 분류사 "~ 건/해당 건/이번 건/그 건", 코드·문서 용어를 대화에 그대로("주석 건") | S2 / **대화·리뷰 S1** | 구체 명사로 풀기("Copilot이 짚은 주석 건" → "Copilot이 남긴 코멘트"). "건"은 공문서투 분류사라 대화에서 어색하다 |
 
 ## J. 시각 장식
 
@@ -123,7 +128,7 @@
 2. **변경률**: 30% 이하인가 (50% 초과는 작업 중단)
 3. **장르 이탈 없음**: 칼럼이 에세이·문학으로 변하지 않았는가, 리포트가 블로그체로 떨어지지 않았는가
 4. **register 보존**: 원문 격식체면 결과도 격식체. 평어체로 떨어뜨리지 않는다
-5. **잔존 S1 패턴 0건**: D-1~D-7, A-7, A-8, A-16, B-3, C-5, C-10, C-11, C-12, H-1, I-1, J-2 핵심 S1이 남아있지 않은가
+5. **잔존 S1 패턴 0건**: D-1~D-7, A-7, A-8, A-16, B-3, C-5, C-10, C-11, C-12, H-1, I-1, J-2 핵심 S1이 남아있지 않은가 (대화·리뷰 register면 F-6·F-7·I-5·F-4·F-5·A-5도 S1로 포함)
 6. **인공 표현 자제**: 원문에 없던 비유·수사·문학적 표현을 윤문 과정에서 임의로 추가하지 않았는가
 
 위반 시: edit 롤백 → 다시 윤문 → 재점검. 자체 루프 최대 1회. 이상 미해결이면 결과를 그대로 출력하되 `summary.md`에 "자가검증 미통과 항목 N건" 표기.

package/role-agents/technical-writer/references/author-voice.md

@@ -135,6 +135,26 @@ ghost 는 button의 ghost variant 를 위한 토큰입니다.
 
 ---
 
+## 명사로 뭉치지 말고 풀어 말하기 (자주 새는 사각지대)
+
+가장 티 나는 AI 흔적은 번역투나 헤징이 아니라 **개념을 명사 덩어리로 압축하는 습관**이다.
+사람은 대화·리뷰 코멘트에서 "무엇을 왜 했는지"를 동사로 풀어 말하지, 명사구를 이어붙여 뭉치지 않는다.
+아래 세 쌍은 실제 리뷰 코멘트에서 나온 교정 사례다. 그대로 학습한다.
+
+| AI가 쓴 것 (before) | 사람이 쓸 것 (after) | 원인 |
+|---|---|---|
+| 시안 정합 버그픽스 잘 확인했습니다 | 디자인 시안이랑 다르게 나오던 거 고친 거 잘 봤어요 | 명사구 압축(F-6) |
+| Copilot이 짚은 주석 건도 반영되셨네요 | Copilot이 남긴 코멘트도 반영하셨네요 | 사무투 분류사 "건"(I-5) + 코드 용어 "주석" |
+| 유지보수성 관련해서 한 가지만 작게 남겨요 | 나중에 유지보수할 때 생각해서 코멘트 하나만 남길게요 | 명사화 "-성"(F-4) + "관련해서"(A-5) + 목적어 생략 |
+| 규칙을 전 소비자에게 배선했습니다 | 규칙을 소비자 전부에 연결해뒀어요 | 기술 비유 명사 "배선"(F-7) |
+| 코멘트에서 지식을 증류해 반영했어요 | 코멘트에서 쓸 만한 걸 추려서 반영했어요 | 기술 비유 명사 "증류"(F-7) |
+
+**목적어를 생략하지 말 것.** "한 가지만 작게 남겨요"처럼 무엇을 남기는지(코멘트·의견)를 빼고
+형식 수량사("한 가지")와 어색한 부사("작게")로 때우면 붕 뜬다. "코멘트 하나 남길게요",
+"의견 하나만 보탤게요"처럼 목적 명사를 살린다.
+
+---
+
 ## humanize-monolith 와의 관계 (중요)
 
 `humanize-monolith`의 S1 규칙은 **AI-tell 제거용**이라, 이 voice와 충돌하는 부분이 있다.
@@ -151,6 +171,8 @@ ghost 는 button의 ghost variant 를 위한 토큰입니다.
 - "결론적으로", "요약하자면", "이를 통해", "~를 수행합니다" 의인화 주어
 - 과장 어휘("핵심적으로", "시사하는 바가 크다"), 콜론 부제, 이모지 남발, 문두 접속사 반복
 - **가운뎃점(·) 나열 남발** — 본문에서 "A·B·C" 압축은 기계 티. 쉼표나 "A랑 B하고 C"로 푼다 (ai-tell C-12)
+- **명사구 압축·사무투 분류사** — "시안 정합 버그픽스", "주석 건" 같은 명사 뭉치는 동사로 풀고 "건"은 구체 명사로 (ai-tell F-6·I-5, 리뷰 register S1)
+- **기술 비유 명사** — "증류·배선·결정화·평탄화" 같은 화학·전기 어휘 차용은 일상 동사로 (ai-tell F-7, 리뷰 register S1)
 - **`c:`/`r:` 접두어, `[출처]` 대괄호 태깅, "…권장." 체언 종지** — Claude가 만든 가짜 시그니처
 
 ---
@@ -164,3 +186,4 @@ ghost 는 button의 ghost variant 를 위한 토큰입니다.
 5. 수정 제안은 코드·토큰 값까지 구체적으로.
 6. 친근체·물결·이모지는 자연스럽게, 과하지 않게.
 7. `c:`/`r:`·`[출처]`·"권장." 은 쓰지 않는다 (Claude artifact).
+8. 개념을 명사로 뭉치지 말고 동사로 푼다("시안 정합 버그픽스" → "시안이랑 다르게 나오던 거"). "건" 같은 사무투 분류사와 생략된 목적어를 되살린다.