팀 리뷰에서 탐지 결과를 적는 문장 템플릿

풀 리퀘스트 댓글에 “AI 72%”만 남아 있던 날을 기억합니다. 작성자는 그 숫자가 머지 차단인지, 질문인지, 농담인지 몰라 한 시간을 허비했어요. 리뷰는 다음 행동을 적는 칸입니다. 점수는 행동이 아닙니다.

세 줄이면 됩니다

1) 조건: 도구, 시각, 글자 수, 범위. 2) 관찰: 신호 강도와 하이라이트 위치. 3) 요청: 출처, 초안, 범위 재확인처럼 상대가 할 수 있는 일. 이 순서가 뒤집히면 인신 공격처럼 읽혀요.

높은 신호 예시. “AI 판독기, 본문 1,120자, 표 제외. 방법 섹션 두 문단에 신호 몰림. 실험 기록 원문이나 노트북 캡처를 이 스레드에 붙여 주세요.” 낮은 신호 예시. “같은 조건에서 강한 신호 없음. 그래도 고객 숫자가 있는 단락은 사람이 출처 확인 부탁해요.”

쓰지 않는 한 줄

“AI 티 남.” “이거 니가 안 썼지.” “HUMAN이니까 머지.” 세 문장 모두 다음 행동이 없습니다. 특히 통과 도장형 댓글이 위험해요. 낮은 점수를 면죄부로 쓰면 나중에 사실 오류가 나와도 리뷰가 면책이 됩니다.

템플릿을 저장해 두고 숫자만 바꿔 붙이면 안 됩니다. 하이라이트 위치는 글마다 다르거든요. 위치가 없는 템플릿은 다시 점수만 남은 댓글이 됩니다. 팀 위키에는 빈 칸을 남겨 두세요.

권한과 같이 적기

리뷰어가 차단 권한이 있으면 그 사실을 숨기지 않습니다. “이 코멘트는 질문이고 머지는 막지 않음” 또는 “자료 올 때까지 홀드.” 모호한 점수는 모호한 권력입니다. 명확히 적으면 상대가 숨 쉴 곳이 생겨요.

저는 이 템플릿을 쓰고 나서 슬랙 DM이 줄었습니다. 공개 칸에 조건이 있으면 비공개로 해명할 일이 줄어들거든요. 탐지 도구는 리뷰를 대체하지 않아요. 리뷰 문장이 도구보다 거친 순간, 그 도구는 쓰지 않는 편이 낫습니다. 문장을 고치는 게 설정 튜닝보다 싸게 먹혀요.

이모지로 심각도를 표시하는 습관도 버렸습니다. 빨간불은 차단처럼 보이고, 웃는 얼굴은 농담처럼 보입니다. 점수는 그 둘 다 아니에요. 텍스트로 홀드인지 질문인지만 적습니다. 이모지가 편해도 권력의 색깔을 숨깁니다.

외부 프리랜서 문서에는 한 줄을 더 붙입니다. “이 코멘트는 계약 위반 통지가 아님.” 안 붙이면 점수가 곧 해지 통지처럼 읽혀요. 그 한 줄을 넣은 뒤로 법적 검토를 요청하는 메일이 줄었습니다. 줄었다는 건 실제로 세어 본 거예요. 한 분기 동안 네 통이 한 통이 됐습니다.

템플릿은 분기마다 한 문장만 고칩니다. 많이 고치면 아무도 안 외워요. 지금 팀이 외우는 문장은 “조건, 관찰, 요청” 여섯 글자입니다. 그 여섯 글자면 점수를 붙여넣기 전에 한 번 멈춥니다. 멈추는 게 이 글의 성공 지표예요.

새 멤버가 첫 주에 가장 많이 하는 실수는 점수를 제목에 넣는 일입니다. “[AI 81%] 방법 섹션”. 제목은 검색되고 알림에 잘립니다. 잘린 제목에는 조건이 안 남아요. 본문에 세 줄을 넣고 제목은 문서 이름만 씁니다. 알림이 무거워 보여도, 잘린 단정보다 낫습니다. 알림의 가벼움은 오해의 무게를 숨깁니다. 제목에 퍼센트를 넣던 주에는 DM이 늘었습니다. 빼고 나서는 공개 스레드에서 세 줄로 끝나기 시작했어요. 그 차이가 템플릿을 유지하는 이유입니다.