AI 가 짠 코드, 요청한 기능보다 불필요한 코드가 더 많다. 저장하는 순간 잡아내는 법
월 · 구현기 · 약 1,000자
붙임 1 · 원문 · youtu.be
youtu.be/3JCgiVYlLFo · 원문 확인 2026-10-26

판단
AI 가 짠 코드는 간결하지 못하다. 요청한 기능에 필요 없는 코드가 많다. 안 쓰는 변수, 주석 처리해 사용을 제한한 코드, 오류가 나도 알리지 않고 넘어가는 예외 처리. 우리 코드에는 이 마지막 것만 128곳.
사실
규칙을 글로 적어도 소용없었다. 대화가 길어지면 AI 가 규칙을 놓쳤다.
판단
그래서 검사를 2중으로 적용했다. 저장하는 순간 방금 생긴 것만 알리고, 커밋 때 늘었으면 막는다.
사실
커밋 검사가 한 번에 14건을 잡았다. 그래도 이름만 바꿔 다시 짠 함수는 못 잡았다.
결론: 이 문장을 AI 에게 주세요
판단
그대로 붙여 넣기 · Claude Code (hook 이 있는 다른 도구도 같은 방식)
이 프로젝트에 «불필요한 코드 막기» hook 두 개를 만들어 적용하라. 첫째, 파일을 저장한 직후 도는 hook: 방금 새로 생긴 안 쓰는 import·변수, 주석 처리해 사용을 제한한 코드, 오류가 나도 알리지 않고 넘어가는 예외 처리만 찾아 네게 알리고, 알림이 오면 그 줄부터 지워라. 둘째, 커밋 직전에 도는 hook: 그런 것이 전보다 늘었으면 커밋을 막고 어디가 늘었는지 보여 줘라. 알림에는 전체 숫자가 아니라 방금 생긴 것만 담아라.
판단
이 문장을 주면 이렇게 달라진다
- 파일을 저장할 때마다 hook 이 자동으로 돌아 방금 생긴 불필요한 코드만 알려 준다. 당신이 코드를 읽으며 찾을 일이 줄어든다.
- 불필요한 코드가 늘어난 채로는 커밋이 막힌다.
- 우리 결과. 커밋 직전 검사가 한 번에 14건을 찾아냈고, 동작이 같게 고친 뒤 커밋했다. 이 검사는 프로젝트 다섯 곳에 적용돼 있다.
- 안 된 것. 글 지시만으로는 막히지 않았다. 이름과 줄 모양을 다르게 다시 짠 함수는 비교한 다른 도구 네 종 모두 못 잡았다.
판단
이런 증상이 보이면 이 글이 맞다
- 요청한 기능에 비해 코드가 길다
- 안 쓰는 import·변수나 주석 처리해 사용을 제한한 코드가 남는다
- «짧게 써라» 라고 적어도 대화가 길어지면 다시 늘어난다