Claude Task Master를 이용한 전체 PR 생명주기 자동화
매일 Claude Code를 사용한다면, 이 루프를 알고 있을 것입니다: 기능 계획을 세우고, 코드를 작성하고, 테스트를 실행하고, 커밋하고, 푸시하고, PR(pull request)을 열고, CI(Continuous Integration)를 기다리고, 실패를 수정하며, 리뷰 코멘트를 처리하고, 병합합니다. 반복합니다.
Claude Task Master (CLI: claudetm)는 이 전체 루프를 자동화합니다. 목표만 제시하면 다음 작업을 수행합니다:
- 계획(Plans) - 코드베이스를 읽고, PR별로 정리된 작업 목록을 생성하며, 성공 기준을 사전에 정의합니다.
- 실행(Executes) - 각 작업을 처리합니다: 변경 사항 적용, 테스트 실행, 커밋, 푸시.
- PR 생성(Creates PRs) - 모든 작업은 풀 리퀘스트를 통해 이루어지며, 직접적인 커밋은 없습니다.
- CI 처리(Handles CI) - 검사를 기다리고, 실패를 수정하며, 리뷰 코멘트를 처리합니다.
- 병합(Merges) - 승인되면 자동 병합합니다 (설정 가능).
- 검증(Verifies) - 모든 성공 기준이 실제로 충족되었는지 확인합니다.
- 적응(Adapts) - 메일함 시스템을 통해 동적 계획 업데이트를 수락하면서도 계속 작업합니다.
중단에도 살아남는 상태 (State That Survives Interruptions)
단순 스크립트와의 주요 차이점은 Task Master가 세션 간에 상태를 유지한다는 것입니다. 노트북을 닫거나, 전원이 끊기거나, 속도 제한(rate limit)에 걸려도 작업은 중단했던 지점부터 정확하게 재개됩니다. 메일함 시스템을 사용하면 REST API, MCP 또는 CLI를 통해 실행 도중에 계획 업데이트를 보낼 수 있습니다.
여러 구독을 병렬로 실행하기 (Running Multiple Subscriptions in Parallel)
기본적으로 claudetm은 사용자의 전역 Claude Code 세션을 사용합니다. 프로필(Profiles) 기능을 사용하면 격리된 인스턴스를 실행할 수 있습니다:
- OAuth 프로필: 각각
~/.claudetm/profiles/<name>/에 자체 설정 홈을 가지므로, 두 개의 Claude 구독이 서로 덮어쓰지 않습니다.
- API-key 프로필:
ANTHROPIC_API_KEY와 ANTHROPIC_BASE_URL을 직접 주입합니다 (Anthropic API 또는 OpenRouter 사용 가능).
이는 동일한 저장소(repo)에 대해 여러 개의 자율 에이전트를 실행하거나, 각기 다른 크리덴셜을 가진 여러 에이전트를 실행할 수 있음을 의미합니다.
위에 구축하기 (Building On Top)
REST API, MCP 서버 및 HMAC 서명된 웹훅은 동일한 생명주기를 프로그래밍 방식으로 노출합니다. 저희 자체 claudetm merge-pr 명령어는 이를 사용하며, 저희 저장소의 PR #147-#150이 이 방식으로 병합되었습니다.
빠른 시작
uv tool install claude-task-master
claude
/login
...
Python 버전 3.10 이상, 인증된 Claude CLI, 그리고 인증된 GitHub CLI가 필요합니다.
MIT 라이선스입니다. PyPI와 Docker에서 무료로 이용 가능합니다.
https://github.com/developerz-ai/claude-task-master
#ClaudeCode #AIAgents #DevTools #자동화 #OpenSource