CCPM (Claude Code Project Mgmt) (Claude Skill) — 설치 & 라이브 데모

왜 쓰나요

핵심 기능

GitHub Issues를 작업 대기열로 활용
이슈별 Git worktree — 진정한 병렬 에이전트 작업
/start /ship /abandon 슬래시 명령
이슈에 연결된 자동 PR 생성
병합/포기 시 정리
gh가 설치된 모든 GitHub 저장소에서 작동

라이브 데모

실제 사용 모습

준비됨

설치

작성자 저장소 · Claude Skills 공식 문서

사용 사례

실전 활용법: CCPM (Claude Code Project Mgmt)

한 번에 3개의 Claude 세션을 3개의 다른 이슈에서 실행

👤 솔로 창업자, 인디 개발자 ⏱ ~60 min intermediate

언제 쓸까: 5개의 작은 이슈가 있을 때; 순차적으로 하는 것은 느리지만 브랜치 전환이 상태를 깨트릴 때.

흐름

이슈 선택

Use ccpm. List open issues; recommend 3 small ones I can do in parallel today.✓ 복사됨

→ 대략적인 예상치와 서로 차단이 없는 3개의 이슈
시작

Start issue #42, #43, #45 each in its own worktree. Open 3 Claude Code sessions ready.✓ 복사됨

→ ../wt-42 등에 3개의 worktree 생성됨; 각 세션이 어떤 이슈를 가지고 있는지 앎
제출

(In each session) When done — /ship — push branch and open PR linked to the issue.✓ 복사됨

→ PR 생성됨, 이슈에 링크됨, CI 시작됨

결과: 브랜치 전환 고통 없이 하루 안에 세 개의 이슈 종료.

함정

이슈들이 겹치는 파일을 건드려 병합 충돌 — 스킬이 선택한 이슈에 파일 중복이 있으면 경고합니다; 병렬 작업을 위해 겹치지 않는 것을 선택하세요

함께 쓰기: github

일상적인 아이디어를 제대로 범위가 정해진 이슈로 변환

👤 아이디어가 넘치는 모든 사람 ⏱ ~5 min beginner

언제 쓸까: 채팅에 '아, 그리고 우리는 또...'를 계속 입력할 때. 적절한 이슈로 캡처하세요.

흐름

캡처

Use ccpm. I want to add JSON export to the dashboard. Create an issue with rationale, acceptance criteria, and a rough plan.✓ 복사됨

→ GitHub에 잘 형성된 이슈 생성됨
링크

Link to related issues if any.✓ 복사됨

→ 링크 추가됨

결과: 나중에 실제로 트리아지할 수 있는 이슈가 되는 아이디어.

함정

이슈가 너무 장황해짐 — 스킬이 본문에 200자 상한을 적용합니다

함께 쓰기: github

썩어가는 브랜치를 남기지 않고 시작된 이슈 깔끔하게 포기

👤 무언가를 시도했다가 재고한 모든 사람 ⏱ ~2 min beginner

언제 쓸까: 이슈를 시작한 지 30분 만에 접근이 잘못됐다는 것을 깨달았을 때; 깔끔하게 빠져나오고 싶을 때.

흐름

포기

/abandon. Remove the worktree, delete the branch, close the issue with a comment explaining why.✓ 복사됨

→ Worktree 삭제됨, 브랜치 삭제됨, 이슈가 설명과 함께 닫힘

결과: 저장소에 고아 브랜치 없음.

함정

실제로 일부 작업을 유지하고 싶었던 경우 — 스킬이 삭제 전 /tmp/ccpm-stashes에 패치를 저장합니다 — 약 7일간 복구 가능

함께 쓰기: github

조합

다른 MCP와 조합해 10배 효율

ccpm-skill + github

CCPM과 GitHub MCP가 이슈 상태에 동의하는지 확인

ccpm-skill + memorix-mcp

worktree 전체에 컨텍스트 전달

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
list	filters	작업 찾기
start	issue_number	이슈 작업 시작
ship	issue_number?	완료; PR 준비됨
abandon	issue_number, reason	깔끔하게 포기

비용 및 제한

운영 비용

API 쿼터: GitHub API 제한에 따라 결정 (인증 시 5000회/시간)
호출당 토큰: 가벼움 — 대부분의 작업은 git + gh CLI
금액: 무료
팁: 과도하게 이슈를 만들지 마세요 — 스킬이 생각을 캡처하도록 권장하지만 모든 미세한 생각은 아닙니다

보안

권한, 시크릿, 파급범위

최소 스코프: repo (이슈 + PR 쓰기용)

자격 증명 저장: gh auth를 통해

데이터 외부 송신: GitHub API

절대 부여 금지: admin:org

/abandon이 브랜치를 삭제합니다 — 공유 저장소에는 확인 플래그가 필요합니다

문제 해결

자주 발생하는 오류와 해결

git worktree add 실패: 이미 사용됨

이전 worktree가 여전히 존재합니다; git worktree prune으로 정리하세요

확인: `git worktree list`

gh PR create가 '커밋 없음' 오류

/ship 전에 worktree 브랜치에 최소 하나의 커밋을 만드세요

두 세션이 같은 이슈를 클레임

스킬이 이슈별 잠금 파일을 씁니다 — 두 번째 시작이 명확한 메시지와 함께 실패합니다

대안

CCPM (Claude Code Project Mgmt) 다른 것과 비교

대안	언제 쓰나	단점/장점
Linear MCP	GitHub Issues가 아닌 Linear를 사용할 때	CCPM은 GitHub 전용이지만 Linear MCP는 자체 생태계입니다
일반 `git worktree` + 체크리스트	한 번에 하나의 에이전트만 실행할 때	수동이지만 CCPM이 라이프사이클을 자동화합니다

CCPM (Claude Code Project Mgmt)

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

사용 사례

실전 활용법: CCPM (Claude Code Project Mgmt)

한 번에 3개의 Claude 세션을 3개의 다른 이슈에서 실행

흐름

함정

일상적인 아이디어를 제대로 범위가 정해진 이슈로 변환

흐름

함정

썩어가는 브랜치를 남기지 않고 시작된 이슈 깔끔하게 포기

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

CCPM (Claude Code Project Mgmt) 다른 것과 비교

더 보기

리소스