im-not-ai: Instructions file for Claude Code

Humanize KR — AI 한글 티 제거 하네스 (v2.3.2)

프로젝트 개요

AI(ChatGPT·Claude·Gemini 등)가 쓴 한글 텍스트를 "사람이 쓴 글처럼" 윤문해주는 3경로 하네스. 번역투·영어 인용 과다·기계적 병렬·관용구·피동태 남용·접속사 남발·리듬 균일성·이모지/불릿 과다 등 10대 카테고리 70개 AI 티 패턴(+A-17 hold 1건)을 탐지·분류해 내용은 한 글자도 건드리지 않고 문체·리듬·표현만 재작성한다.

v2.2부터 shim이 정량 점수로 산출하는 route_hint(light | standard | heavy) 가 디폴트 경로를 정한다(사용자 명시가 오버라이드). 글의 상태가 콜 수를 정하는 구조로, 구 "fast 1콜 / 정밀 3콜" 이분법을 대체한다.

• light (1콜) — 잘 쓴 글(어휘 티 거의 0). 진단·finalize 생략, 보수 강도 단일 윤문. 손댈 게 거의 없으면 "이미 좋습니다" 조기 종료.
• standard (2콜) — 보통의 AI 초안. 진단 1콜 + 겨냥 윤문 1콜. finalize 생략이 기본(결정적 변경률 게이트로 대체). 1만자급도 청킹 없이 단일 윤문 콜.
• heavy (3+콜) — 중증 AI 슬롭 밀집 or 초장문(15,000자 초과) or 검증 증적 필요. 진단 → 윤문(shim이 청크를 2개 이상 만든 경우에만 청크 병렬) → finalize. --strict·"정밀 모드"는 이 경로를 강제.

콜 수 절감 원리 — 절감은 모델 티어가 아니라 콜 수에서 온다. 실측: 1만자 글 청킹 7콜 = 610K 토큰 vs 단일 콜 = 134K(품질 동등). 청크마다 룰북·진단이 재로드되는 비용이 폭발 원인. 따라서 단일 콜 우선, 청킹은 heavy 전용·15,000자 이하 비권장.

철칙

1. 의미 불변 (Fidelity First) — 사실·주장·수치·고유명사·인용은 100% 원문 보존.
2. 근거 기반 (Span-Grounded) — 모든 변경은 탐지 finding에 연결. 탐지 없는 구간은 건드리지 않음.
3. 장르 유지 (Tone Match) — 칼럼을 문학으로, 리포트를 에세이로 옮기지 않음.
4. 과윤문 금지 (No Over-Polish) — 변경률 30% 초과 시 경고, 50% 초과 시 강제 중단.
5. register 보존 — 양방향 — 격식체 입력은 격식체 출력, 구어 입력은 구어 출력. 원문보다 딱딱하게 만들지 않는다: '-했-' → '-하였-' 치환 금지, '~인데요/~거든요/~한 겁니다' 구어 종결 보존. (하향 금지만 있던 기존 단방향 규칙으로는 합쇼체가 유지되는 '했→하였' 상향을 못 잡았다.) AI 티는 문법·수사이지 격식 자체가 아니다.
6. AI 티는 빼기만 하고 넣지 않는다 (No New Tells) — 원문에 없던 상투구("기록적인 성과를 거두었다"·"괄목할 만한"·"~로 평가된다") 신규 삽입 금지. 살아있는 구어는 사람 글의 증거이므로 보존한다. 철칙 #2가 "탐지 없는 구간은 손대지 않는다"라면, #6은 "손대는 구간에도 새 AI 티를 심지 않는다" — 모순이 아니라 보완이다.

AI 워터마킹에 대한 입장 (2026-08-17 확정)

배경. Anthropic 은 2026-08-11 텍스트 워터마킹 도입을 발표했다. 방식은 Google DeepMind 의 SynthID-Text — 단어를 바꿔 심는 게 아니라, 동등하게 좋은 후보들 사이에서 뽑는 난수의 출처를 키 기반 결정값으로 바꾼다. EU AI Act 투명성 의무 대응이며 적용은 전 세계 동일. 2026-08-02 이후 출시 모델부터 적용되고, 그 이전 모델(Sonnet 5 = 6/30, Opus 5 = 7/24)에는 수개월에 걸쳐 소급 적용 중이다. 탐지 API 는 아직 공개되지 않았다.

결정: 워터마크 제거 기능은 탑재하지 않는다.

1. 측정할 수 없다. 탐지기가 없으므로 "지워졌는지"를 확인할 방법이 없다. 검증 없이 제거를 시도하면 맹목적으로 단어를 흔드는 것이고, 그건 이 프로젝트가 존재하는 이유(자연스러운 한국어)와 정면으로 충돌한다. 확실한 품질 손실을 지불하고 검증 불가능한 이득을 사는 거래다.
2. 투명성 장치 우회다. EU AI Act 가 요구하는 출처 표시를 무력화하는 기능이다.
3. 선은 분명하다. 어색한 한국어를 자연스럽게 고치는 편집이 부수적으로 통계 신호를 흐트러뜨리는 것은 이 프로젝트의 정상 동작이다. Anthropic 도 "전면 재작성이면 지워지고, 그 시점엔 AI 생성물이라 부를 수 있는지 자체가 논쟁적"이라고 인정했다. 금지되는 것은 그것을 표적 기능으로 만들어 그렇게 광고하는 것이다.