Claude Code가 주석을 너무 많이 달지 않게 하려면 어떻게 해야 하나요?

haiku ultracode “remove all comments”

CLAUDE.md에 아주 타이트하게 표준을 작성하세요.

짧은 문장. 의무 사항에는 RFC 2119 키워드 사용. 커밋 = 명령형 주어; 본문은 diff로 보여줄 수 없는 사실만 기록. 주석은 코드가 설명을 필요로 할 때만 — 서술은 절대 금지.

첫 커밋부터 아주 빡세게 관리하세요. 그래야 나중에 더 많은 쓰레기를 낳는 슬롭(slop)으로 가득 차지 않게 됩니다.

“output styles”를 검색해보세요

Opus 5에서 특히 이런 현상이 심한 걸 느끼고 있어요. 평소에 프롬프트를 꽤 구체적이고 직접적으로 쓰는 편인데, 지난주에 실험 삼아 “야, 주석 좀 적당히 달아. 도대체 뭐 하는 거야?”라고 말해봤거든요. 그랬더니 한 줄짜리 메서드에 주석을 4줄씩 달거나, 여러 주석에 같은 내용이 반복되는 건 필요 없다는 걸 이해하더라고요. 코드베이스 외부의 컨텍스트(회사 정책, 티켓 번호, 의사결정자 이름 등)가 아닌 이상 주석은 대부분 필요 없으니까요.

“커밋하기 전에, 그 주석들 좀 적당히 좀 해줄래”가 요즘 내가 입버릇처럼 하는 말임 ㅋㅋ. 난 주석 대 코드 비율을 계산해서 “이 주석이 꼭 필요한가?”라고 경고 띄우고 여러 줄짜리 주석은 아예 차단하는 훅을 쓰고 있어. 만약 AI가 동의 안 하면 “TODO: 확장” 요청으로 표시해두고, 진짜 필요하면 내가 수동으로 업데이트함. 효과는 있는데, 요즘 모든 출력 텍스트에 적용되는 워터마킹 발표를 보니까, 아마 일정 글자 수 이상을 채워야 해서 그런 게 아닐까 싶음...