변수와 함수 이름 후보 받기

결과 예시

방향이 다른 후보 5개가 나왔고, 마지막 줄에서 "getData2 는 그대로 둘 이유가 없다"고 잘라 말했다.

후보	이 이름만 보면 무엇을 한다고 읽히는지	언제 어색해지는지
calculateCheckoutTotal	결제 화면에 띄울 최종 금액을 계산한다	장바구니 미리보기에서 부르면 상황을 좁힌다
getPayableAmount	낼 금액을 꺼내 온다	get이라 가벼워 보여 필터·쿠폰 계산이 숨는다

"팀에서 자주 쓰는 이름 5개"를 함께 넣으면 관례에 더 맞는다.

Claude에서 실제로 실행해 확인 · 2026-09

왜 이렇게 쓰는가

역할

당신은 코드 리뷰에서 이름 짓기를 오래 봐 온 개발자입니다. 좋아 보이는 이름 하나를 고르는 대신, 후보를 늘어놓고 각각이 어떻게 읽히는지 비교해 주세요.

맥락

저는 {{언어}}로 작업하고 있고, 지금 쓰는 이름은 {{기존 이름}}입니다. 이 이름을 처음 보는 동료가 코드를 열었을 때 무슨 일을 하는지 짐작할 수 있으면 좋겠습니다.

과제

아래 설명을 읽고 이름 후보를 5개 제안해 주세요. 비슷한 이름 5개가 아니라, 무엇을 강조하느냐가 서로 다른 5개로 만들어 주세요.

형식

표로 정리해 주세요. 열은 "후보 · 이 이름만 보면 무엇을 한다고 읽히는지 · 언제 어색해지는지"입니다. 표 아래에 하나를 추천하고 그 이유를 두 문장으로 적어 주세요. 마지막에 지금 이름을 그대로 두는 편이 나은 경우가 있다면 한 줄로 알려 주세요.

예시

예를 들어 "주문을 취소할 수 있는지 검사한다"는 설명이라면 canCancelOrder(가능 여부를 묻는 이름) · validateOrderCancellation(검증 절차라는 느낌) · checkOrder(무엇을 검사하는지 빠짐)처럼, 방향이 다른 후보와 그 이름이 주는 인상을 함께 적어 주세요.

제약

이름은 {{언어}}에서 쓰는 표기 관례를 따라 주세요. 팀에서 통하지 않을 축약어(mgr, tmp, proc)는 쓰지 마세요. 설명에 없는 기능을 이름에 넣지 마세요.

입력 자료

하는 일 설명: """ {{하는 일 설명}} """

변수명 짓기를 AI에게 물으면 보통 이름 하나가 돌아옵니다. 그럴듯하지만 왜 그 이름인지, 다른 선택지는 무엇이었는지가 없어서 팀 규칙과 어긋나도 알아채기 어렵습니다. 이름은 정답이 하나인 문제가 아니라 무엇을 강조할지 고르는 문제라서, 비교할 것이 없으면 고를 수도 없습니다.

형식을 표로 고정한 것이 이 프롬프트의 중심입니다. "이 이름만 보면 무엇을 한다고 읽히는지" 열은 이름을 만든 사람의 의도가 아니라 처음 보는 사람이 받을 인상을 적게 만듭니다. "언제 어색해지는가" 열은 지금은 맞지만 기능이 조금만 늘어나면 거짓말이 되는 이름을 미리 걸러 냅니다. fetchUser 가 캐시에서도 읽어 오게 되는 순간처럼요.

예시를 한 줄 넣어 둔 이유는 "서로 다른 방향"이라는 말이 모호하기 때문입니다. 예시 없이 5개를 시키면 getX, getXData, getXInfo 같은 사실상 같은 이름이 나옵니다. 방향이 갈리는 후보 셋을 보여 주면 그 폭이 기준이 되어 나머지 후보도 벌어집니다.

제약은 두 가지를 막습니다. 표기 관례를 지정하지 않으면 파이썬 코드에 getUserList 같은 이름이 섞이고, 축약어를 금지하지 않으면 짧다는 이유로 procMgr 류가 후보에 올라옵니다. "설명에 없는 기능을 이름에 넣지 마세요"는 함수 이름 추천에서 특히 중요합니다. AI가 andSendEmail 처럼 하지도 않는 일을 이름에 붙이면 다음 사람이 그 코드를 잘못 읽습니다.

용어가 낯설면 아하AI에서: prompt, output-format

나쁜 예와 비교

흔한 나쁜 예

장바구니 최종 금액 계산하는 함수 이름 뭐가 좋을까?

calculateTotalPrice 하나가 돌아옵니다. 무난하지만 이 함수가 품절 상품을 걸러 낸다는 사실도, 쿠폰을 적용한다는 사실도 이름에 없습니다. 비교할 후보가 없으니 그대로 쓰게 되고, 몇 달 뒤 "총액인데 왜 값이 다르지"라며 함수 안을 다시 읽게 됩니다.

변형

파일이나 폴더 이름을 정할 때

{{언어}} 프로젝트에서 새로 만드는 모듈의 파일 이름과 폴더 위치를 정하려 합니다. 아래 설명을 읽고 후보를 3개 제안하고, 각 후보가 어떤 폴더 구조를 전제하는지 한 줄씩 적어 주세요. 이미 흔히 쓰는 이름과 헷갈릴 위험이 있으면 표시해 주세요.

""" {{하는 일 설명}} """

개별 이름이 아니라 배치가 문제일 때 씁니다. 폴더 구조 전제를 함께 적게 하면 팀 구조와 맞는지 바로 판단할 수 있습니다.

이름 여러 개를 한 번에 손볼 때

아래는 한 파일에 있는 {{언어}} 이름 목록입니다. 각 이름에 대해 "그대로 둘 것 · 바꿀 것"을 먼저 판단하고, 바꿀 것만 새 이름 후보 2개와 이유를 표로 적어 주세요. 이름 규칙이 파일 안에서 서로 어긋나는 부분이 있으면 마지막에 따로 모아 알려 주세요.

""" {{하는 일 설명}} """

리팩터링 중 이름을 한꺼번에 정리할 때입니다. 먼저 걸러 내게 해야 멀쩡한 이름까지 바꾸자는 제안이 줄어듭니다.

모델별 주의

팀 코드에서 자주 쓰는 이름 몇 개를 함께 붙여 넣으면 기존 규칙에 맞춘 후보가 나옵니다

후보가 마음에 들지 않아 다시 뽑아 달라고 하면 앞서 나온 이름을 조금 바꾼 것들만 돌아오기 쉽습니다. 마음에 드는 방향 하나를 골라 "이 방향으로만 다섯 개"라고 지정해 주세요. 팀 저장소에서 자주 쓰는 이름 대여섯 개를 함께 붙여 넣으면 기존 규칙에 맞춘 후보가 나옵니다.