개발 반복 잡무 AI로 넘기기 7가지 — 커밋 메시지·changelog·문서

커밋 메시지 다듬고, changelog 정리하고, 정규식 붙잡는 시간이 하루에 야금야금 쌓입니다. 이런 자잘한 잡무를 계속 손으로 하면 설계나 리뷰에 쓸 집중력이 새 나갑니다.

 

Claude Code로 매일 실무를 돌리는 입장에서, AI에 넘겨도 되는 잡무와 반드시 손으로 검수할 잡무를 나눠 정리했습니다. 핵심은 매번 프롬프트를 복붙하는 게 아니라, 자주 하는 건 슬래시 커맨드로 한 번만 굳혀두는 겁니다. 어떤 걸 넘기고 어떤 걸 커맨드로 만들지 이 글에서 잡힙니다.

 

예약 걸어두고 알아서 오는 자동화(아침 브리핑 등)는 결이 다르고, Claude Cowork 자동화에서 따로 다뤘습니다. 좋은 슬래시 커맨드는 GitHub에도 많이 공개돼 있으니, 아래 것들을 가져다 팀 규칙에 맞게 손봐 써도 됩니다.

1. 어떤 잡무를 AI에게 넘겨도 되나 — 판단 3기준

AI 자동화라고 전부 넘기면 안 됩니다. 반복적·규칙적·저위험 세 조건을 다 만족하는 것만 골라서 AI로 반복 작업을 돌리는 게 안전합니다.

반복적 — 매번 비슷한 모양으로 하는 일 (커밋 메시지, 주석)

규칙적 — 정답 형식이 정해져 있어 검수가 쉬운 일 (conventional commit, JSON 스키마)

저위험 — 틀려도 눈으로 바로 잡히거나 실행 전에 되돌릴 수 있는 일

반대로 아키텍처 결정, 보안에 닿는 로직, 비즈니스 판단이 들어가는 코드는 남깁니다. 창의·판단은 사람 몫이고, AI는 그 앞뒤의 반복 잡무를 걷어내는 역할입니다.

2. 커밋 메시지·PR·changelog 생성

가장 먼저 넘기기 좋은 후보입니다. 셋 다 입력이 이미 Git 안에 있어서, Claude Code라면 "커밋해줘" 한마디로 diff를 읽어 처리하고, 웹 챗을 쓴다면 아래 프롬프트를 붙여넣으면 됩니다. 매번 반복된다면 이 프롬프트를 슬래시 커맨드로 저장해두는 게 낫습니다(아래 6번).

 

① 커밋 메시지 (git diff → conventional commit)

아래 git diff를 conventional commit 규칙으로 요약해줘.
형식: <type>(<scope>): 제목 50자 이내
본문에 "무엇을·왜" 2~3줄. type은 feat/fix/refactor/docs/chore 중 선택.
--- diff ---
(git diff --staged 결과 붙여넣기)

② PR 설명 — 위 프롬프트 끝에 "그리고 이 변경의 리뷰 포인트 3가지도 목록으로"만 덧붙이면 됩니다.

③ changelog·릴리스 노트 (커밋 로그 → 읽는 노트)

아래 커밋 로그를 사용자가 읽는 릴리스 노트로 바꿔줘.
Added / Changed / Fixed 세 그룹으로 묶고, 각 항목은 기능 관점 한 줄로.
내부 리팩토링·오타 수정은 생략.
--- 커밋 로그 ---
(git log --oneline v1.2.0..HEAD 결과 붙여넣기)

AI 커밋 메시지는 diff만 보고 쓰기 때문에 "왜 바꿨는지"는 종종 빗나갑니다. type과 제목은 거의 맞으니 본문의 이유 한 줄만 손보면 됩니다.

3. 문서화 넘기기 — README·주석·docstring

문서화는 미루다 안 하게 되는 대표 잡무인데, 코드가 이미 답을 갖고 있어서 AI에 잘 맞습니다.

아래 함수에 docstring(또는 JSDoc) 주석을 달아줘.
- 목적 한 줄, 파라미터·반환값 타입과 설명, 예외 조건
- 코드 로직은 그대로 두고 주석만 추가
--- 코드 ---
(함수 붙여넣기)

README는 "이 프로젝트 폴더 구조와 package.json을 보고 설치·실행 방법 섹션을 써줘"처럼 파일 몇 개를 같이 주면 초안이 나옵니다. 주의할 건 AI가 코드에 없는 기능을 그럴듯하게 써넣는 경우라, 문서 안의 명령어는 한 번씩 실제로 돌려보고 넘어가야 합니다.

4. 로그 요약 · 정규식 · 데이터 변환

이 셋도 AI 자동화로 넘기기 좋습니다. "샘플을 주면 결과를 뱉는" 형태라 Claude 자동화든 Gemini든 잘 처리합니다.

④ 로그·에러 요약 (stacktrace → 원인 후보)

아래 stacktrace에서 (1) 진짜 원인으로 의심되는 줄
(2) 원인 후보 3개 (3) 다음에 확인할 순서를 정리해줘.
프레임워크: Spring Boot 3
--- 로그 ---
(stacktrace 붙여넣기)

⑤ 정규식 (샘플 in/out → regex) — 정규식은 문법 외우는 것보다 예시로 시키는 게 빠릅니다.

아래 조건에 맞는 정규식을 만들어줘 (언어: JavaScript).
- 매칭돼야 하는 예: 010-1234-5678, 01012345678
- 매칭되면 안 되는 예: 02-123-4567
설명과 테스트 코드도 같이.

⑥ 데이터 포맷 변환 (JSON↔CSV↔표) — "아래 CSV를 JSON 배열로, 숫자 필드는 number 타입으로 바꿔줘" 한 줄이면 됩니다. 목데이터 만들 때도 "이 스키마로 샘플 5건 만들어줘"가 빠릅니다.

5. 코드 정리·일괄 리네이밍 — 되는 것 vs 검수할 것

여기서부터는 넘기되 반드시 검수해야 하는 영역입니다.

⑦ 일괄 리네이밍·보일러플레이트

아래 파일 목록을 규칙에 맞게 새 이름으로 매핑한 표만 만들어줘.
규칙: camelCase → kebab-case, 확장자 유지.
실제 rename은 하지 말고 "old → new" 표로만.
--- 목록 ---
(파일 목록 붙여넣기)

삽질: rename 매핑만 받아 그대로 적용했다가 import 경로가 옛 이름 그대로여서 빌드가 통째로 깨진 적이 있습니다.

원인: AI는 준 목록만 보고 이름을 바꿀 뿐, 그 파일을 참조하는 다른 곳까지는 모릅니다.

해결: 프롬프트에 "이 파일들을 import하는 곳도 같이 찾아서 바꿔줘"를 넣고, 최종은 항상 git diff로 눈 검수한 뒤 커밋합니다.

보일러플레이트(반복 컴포넌트·CRUD 틀)도 같습니다. 생성은 AI, 도메인 규칙에 맞는지 판단은 사람. 이 경계는 AI 코딩 프롬프트를 스펙으로 쓰는 법에서 다룬 것과 같은 원리입니다.

6. 반복 프롬프트는 저장해서 재사용

반복 프롬프트를 저장하는 것 자체가 가벼운 AI 자동화입니다. 같은 프롬프트를 매번 다시 치는 것도 결국 반복 작업이 됩니다. Claude Code는 .claude/commands/ 폴더에 마크다운 파일 하나를 두면 커스텀 슬래시 커맨드가 됩니다.

<!-- .claude/commands/commit.md -->
스테이징된 변경을 conventional commit으로 요약해줘.
형식: <type>(<scope>): 제목 50자 이내, 본문 2~3줄.

이렇게 저장해두면 /commit만 치면 됩니다. 위 7개 프롬프트를 각각 파일로 만들어 팀 레포에 커밋하면 팀원 전체가 같은 규칙으로 쓸 수 있습니다.

 

한 가지 주의. 사내·민감 코드를 그대로 붙여넣지 마세요. 키·토큰·고객 데이터가 섞인 파일은 해당 부분을 지우거나 더미로 바꾼 뒤 넘기는 습관이 필요합니다.

반복 잡무 위임 가이드 (표)

AI 자동화로 넘길 잡무별 적합도와 검수 포인트를 한 장에 정리했습니다.

잡무 유형	AI 적합도	넘기는 법(입력)	검수 포인트
커밋 메시지·PR 설명	높음	git diff --staged	"왜 바꿨나" 본문 한 줄
changelog·릴리스 노트	높음	git log --oneline 범위	사용자 관점 표현·누락
README·주석·docstring	높음	코드 + 목적 한 줄	없는 기능 지어냈는지
로그·에러 요약	중간	stacktrace + 프레임워크	원인 후보의 실제 검증
정규식	중간	매칭 O/X 샘플	엣지 케이스 직접 테스트
데이터 포맷 변환	높음	원본 + 목표 스키마	타입·인코딩·빈 값
일괄 리네이밍·보일러플레이트	낮음(검수 필수)	목록 + 규칙	import 경로·빌드

표는 요약입니다. 각 프롬프트 원문과 함정은 위 본문 섹션을 참고하세요.

Q&A — 자주 보는 질문 4개

Q. Claude랑 Gemini 중 뭘 써야 하나요?
둘 다 이 잡무들은 무리 없이 합니다. 긴 코드 문맥·리팩토링은 Claude, 빠른 요약·문서 초안은 Gemini 쪽이 손에 붙습니다. 정답은 없고 쓰던 걸 쓰면 됩니다.

Q. 커밋 메시지를 완전히 자동으로 붙게 할 수 있나요?
할 수는 있지만 권하지 않습니다. diff만 보고 쓴 "왜"는 자주 틀려서, 생성은 AI에 맡기되 커밋 직전 한 번 눈으로 보는 흐름이 안전합니다.

Q. 예약해서 자동으로 돌게 하는 것과 뭐가 다른가요?
이 글은 그때그때 손으로 하던 걸 AI에 시키는 온디맨드 방식입니다. 정해진 시간에 알아서 오는 자동화는 목적이 달라, 따로 세팅이 필요합니다.

Q. 회사 코드를 붙여넣어도 되나요?
민감 정보(키·토큰·고객 데이터)는 반드시 지우거나 더미로 바꾼 뒤 넘기세요. 로직 구조만 보여줘도 대부분의 잡무는 처리됩니다.

마무리

AI 자동화의 핵심은 하나입니다. 반복적·규칙적·저위험이면 AI에 넘기고, 판단이 들어가면 사람이 쥔다. 위 7개 프롬프트를 슬래시 커맨드로 저장해두면 다음부터는 붙여넣기 한 번으로 끝납니다. 같은 환경이면 위 순서대로 따라가도 무리 없습니다.

관련 글

• Gemini CLI 사용법 — 무료로 어디까지 되나, 직접 써보고 정리
• Claude Code Hooks 실전 — 포맷·위험 명령 차단·알림 자동화 5가지
• Claude Code 활용법 정리 — 망치는 습관 3개와 살리는 습관 7개

사용 환경: Windows 11, Node.js v24, Claude Code, Claude Max + Gemini Pro 병행