Claude Code 내장 리뷰 및 병렬처리 커맨드 /simplify와 /batch

개요

Claude Code v2.1.63에서 새롭게 도입된 /simplify와 /batch는 개발자의 코드 리뷰와 대규모 코드 마이그레이션을 자동화하는 두 가지 핵심 명령어입니다. /simplify는 3개의 전문 리뷰 에이전트를 병렬로 실행하여 코드 품질을 자동 검증하고, /batch는 수십 개의 파일에 걸친 변경사항을 독립적인 워크트리에서 병렬 처리합니다.

이 글에서는 두 명령어의 작동 원리, 실전 활용법, 그리고 효과적인 사용 전략을 정리합니다.

 

---

/simplify 명령어: AI 코드 리뷰 자동화

무엇을 하는 명령어인가?

/simplify는 기능 구현 후 코드를 자동으로 리뷰하는 명령어입니다. 단순한 린터나 포매터가 아니라, 아키텍처 수준의 문제까지 감지하고 직접 수정을 적용합니다.

3개의 전문 리뷰 에이전트

/simplify를 실행하면 세 가지 전문 에이전트가 동시에 병렬로 작동합니다.

• 코드 재사용 에이전트: 여러 곳에 중복된 패턴을 감지하고, 공유 유틸리티 함수로 추출할 수 있는 기회를 찾습니다. 누락된 함수나 불필요하게 반복되는 로직을 식별합니다.
• 코드 품질 에이전트: 사람 리뷰어처럼 코드를 읽으며, 가독성, 네이밍 컨벤션, 구조적 문제를 지적합니다. 불필요한 import, 중복 변수 선언 등도 잡아냅니다.
• 효율성 에이전트: 성능 병목을 프로파일링하고, 불핀요한 메모리 할당, 중복 루프, 배치 처리 가능한 연산을 식별합니다.

사용법

# 기본 실행 - 최근 변경된 코드를 검토
/simplify

# 특정 관점에 초점을 맞춘 검토
/simplify focus on memory efficiency
/simplify focus on security patterns
/simplify focus on error handling

언제 사용해야 할까?

• 기능 구현 직후: 코드가 작동하는 것을 확인한 뒤, 품질을 높이기 위해 실행
• PR 개설 전: 팀 리뷰어에게 보내기 전 자동 검증 게이트로 활용
• 버그 수정 후: 수정 과정에서 발생할 수 있는 코드 악화를 방지
• AI 생성 코드 후: AI가 생성한 코드의 불핀요한 부분을 정리

 

---

/batch 명령어: 대규모 병렬 코드 마이그레이션

무엇을 하는 명령어인가?

/batch는 수십 개의 파일에 걸친 대규모 코드 변경을 병렬로 처리하는 명령어입니다. 프레임워크 마이그레이션, 라이브러리 교체, API 표준화 같은 반복적이고 광범위한 작업에 적합합니다.

3단계 프로세스

1단계 - 연구 및 계획

오케스트레이터 에이전트가 Explore 에이전트를 실행하여 변경 범위를 분석합니다. 코드베이스의 크기와 변경의 복잡도에 따라 5~30개의 독립적인 작업 단위로 분해합니다. 이 계획은 사용자의 승인을 받은 후 다음 단계로 진행됩니다.

2단계 - 워커 배포

승인이 완료되면 각 작업 단위마다 하나의 백그라운드 에이전트를 생성합니다. 모든 에이전트를 동시에 실행하여 진정한 병렬 처리를 구현합니다. 각 에이전트는 격리된 git 워크트리에서 작동하므로 서로의 작업에 영향을 주지 않습니다. 각 워커는 변경사항 적용 후 자동으로 /simplify를 실행하고, 테스트를 돌린 뒤, 커밋하고 PR을 생성합니다.

3단계 - 진행 추적

오케스트레이터가 상태 정보를 실시간으로 업데이트합니다. 모든 워커가 완료되면 최종 요약을 제공합니다.

사용법

# 프레임워크 마이그레이션
/batch migrate from react to vue

# 라이브러리 교체
/batch replace all uses of lodash with native equivalents

# 타입 추가
/batch add type annotations to all untyped function parameters

# 테스트 마이그레이션
/batch Jest에서 Vitest로 모든 테스트 마이그레이션

# API 표준화
/batch standardize all API error responses to use { error: string, code: number, details?: object } format

 

---

/simplify vs /batch 비교

두 명령어는 목적과 규모가 다릅니다.

규모 측면

• /simplify: 최근 변경된 파일만 대상으로 하는 로컬 검증 도구
• /batch: 전체 코드베이스에 걸친 병렬 마이그레이션 엔진

사용 시점

• /simplify: 구현 완료 후 사후 검증으로 사용
• /batch: 구현 전 대규모 변경 계획 수립 시 사용

에이전트 구성

• /simplify: 3개의 검토자 에이전트 (코드 재사용, 품질, 효율성)
• /batch: 5~30개의 구현자 에이전트 (각 작업 단위별 하나씩)

결과물

• /simplify: 현재 브랜치에 수정사항 직접 적용
• /batch: 작업 단위별 독립 PR 생성

Git 요구사항

• /simplify: Git 저장소가 아니어도 사용 가능
• /batch: Git 저장소 필수 (워크트리 격리를 위해)

상호 연동

모든 /batch 워커는 자동으로 /simplify를 실행합니다. 따라서 /batch가 생성하는 모든 PR은 이미 3단계 코드 리뷰를 거친 상태입니다.

---

실전 활용 시나리오

시나리오 1: 일일 기능 개발 사이클

# 1단계: 기능 구현
"JWT 인증과 리프레시 토큰 추가해줘"

# 2단계: 자동 코드 리뷰
/simplify

# 3단계: 보안 관점 집중 검토
/simplify focus on security patterns

매일 PR을 올리기 전 /simplify를 습관적으로 실행하면, 팀 리뷰어가 발견하기 전에 3~59개의 문제를 미리 잡을 수 있습니다.

시나리오 2: React 클래스 컴포넌트 함수형 전환

# 45개 크래스 컴포넌트를 함수형으로 변환
/batch convert all React class components in src/components/ to functional components with hooks

이 명령어를 실행하면 약 15개의 작업 단위(3개 컴포넌트)로 자동 분할되고, 각 PR이 독립적으로 검토하고 병합할 수 있습니다.

시나리오 3: 테스트 프레임워크 마이그레이션

/batch src/utils의 모든 파일에 TypeScript 타입 추가

패턴 기반의 반복 작업이라 /batch로 자동화하는 것이 가장 효율적입니다.

---

효과적인 활용을 위한 핵심 팁

/simplify 활용 팁

• 매 PR마다 실행하세요: 팀 리뷰 전 자동으로 아키텍첲 수준의 문제를 잡을 수 있습니다.
• AI생성 코드 후 반드시 실행하세요: 불필요한 import, 중복 변수, 미추출 공유 로집 등을 정리합니다.
• 초점 옵션을 적극 활용하세요: focus on memory efficiency, focus on error handling 등으로 특정 관점의 심층 검토가 가능합니다.

/batch 활용 팁

• 구체적으로 설명하세요: "코드베이스 업데이트"는 너무 모호합니다. "lodash를 네이티브 함수로 교체하고 관련 API 호출 업데이트"처럼 구체적으로 작성하세요.
• 계획 단계를 꼼꼼히 검토하세요: 분해 방식이 부적절하면 실행 전에 수정할 수 있습니다. 이 단계를 건너뛰지 마세요.
• 테스트 스위트를 강화하세요: 각 워커가 테스트를 실행하므로, 테스트가 약하면 문제를 놓칠 수 있습니다.
• 패턴 기반 작업에 사용하세요: "모든 API 엔드포인트에 이 변경 적용"은 적합하지만, "전체 인증 시스템 재작성"은 부적합합니다.

---

/batch가 부적합한 경우

모든 작업에 /batch가 젠합한 것은 아닙니다. 다음 경우에는 다른 접근 방식을 고려하세요.

• 파일 간 의존성이 있는 작업: 작업 단위 A의 결과가 단위 B에 필요한 경우, 독립적인 병렬 처리가 불가능합니다. 이 경우 Agent Teams를 사용하세요.
• 탐색적 리팩토링: 최종 결과물의 형태가 아직 결정되지 않은 상태에서는 /batch보다 직접 작업이 낫습니다.
• 단일 파일 변경: 파일 하나만 수정하면 되는 경우, 분해 오버헤드가 불필요합니다.

---

마무리

/simplify와 /batch는 기존에 수동으로 수행하던 코드 리뷰와 대규모 마이그레이션 작업을 자동화하는 강력한 도구입니다. /simplify는 매일의 개발 사이클에서 품질 게이트 역할 을 하고, /batch는 수십 개 파일에 걸친 반복 작업을 한 번의 명령어로 처리합니다.

핥심은 두 명령어의 역할 을 몄확히 구분하는 것입니다. /simplify는 구현 후 검증, /batch는 대규모 병렬 실행입니다. 그리고 /batch 워커가 자동으로 /simplify를 실행하므로, 두 명령어는 자연스럽하 보욆관계를 형성합니다.

---

찴고 자료

• Claude Code /simplify and /batch Commands Guide
• /simplify and /batch: Two Claude Code Commands You're Probably Not Using
• Essential Claude Code Skills and Commands
• Claude Code overview - Claude Code Docs

이 글은 Claude Code를 활용하여 작성되었습니다.