Claude Code의 /batch를 이용한 안전하고 병렬적인 대규모 리팩토링 방법

요약

Claude Code의 `/batch` 명령어를 활용하여 수백 파일에 걸친 대규모 리팩토링 작업을 안전하고 병렬적으로 수행하는 방법을 소개합니다. 이 기능은 각 에이전트에 독립적인 git worktree를 할당하여 파일 충돌을 방지하며, 의존성 분석 및 `--plan` 기능을 통해 사전 검증과 순차적 실행까지 지원합니다.

핵심 포인트

• `/batch`는 독립적인 worktree를 제공하여 병렬 작업 시 파일 충돌을 구조적으로 회피합니다.
• 작업의 의존성을 분석하여 순서가 중요한 변경 사항도 안전하게 처리할 수 있습니다.
• `--plan` 기능을 사용해 실제 실행 전 대상 파일과 분할 계획을 비용 효율적으로 확인할 수 있습니다.
• 진행 상황 추적(`tasks`)을 통해 에이전트 간의 대기 및 완료 상태를 명확히 파악할 수 있습니다.