automazeio/ccpm

CCPM – 프로젝트 매니저 에이전트

그것은 무엇인가

• Agent Skill(agentskills.io 표준 호환)로, AI 코딩 에이전트에 구조화된 프로젝트 관리 두뇌를 제공합니다.
• 자연어 아이디어를 사양 기반의 완전한 워크플로우로 변환합니다: PRD → Epic → Task → GitHub Issue → Code, 각 단계는 저장소에 기록됩니다.

왜 중요한가

• 컨텍스트가 사라지지 않음 – 모든 사양, 결정, 진행 상황은 채팅 로그에서 손실되지 않고 .claude/ 아래의 일반 마크다운 파일에 저장됩니다.
• 병렬성 – 단일 이슈를 여러 독립 스트림으로 분할하여 별도의 에이전트에서 동시에 실행할 수 있어 벽시계 시간을 크게 줄입니다.
• GitHub 네이티브 – GitHub Issues(및 선택적 gh-sub-issue 확장)를 단일 진실 소스로 사용하므로 팀은 추가 프로젝트 관리 도구 없이 인간 또는 에이전트와 협업할 수 있습니다.
• 하네스 비종속 – Claude Code, Codex, Factory, Amp, Cursor, OpenCode 등에서 작동하며, 하네스를 skill/ccpm/에 지정하기만 하면 됩니다.

주요 기능

기능	이점
사양 기반 워크플로우	PRD 생성, 에픽 계획, 작업 분해가 모두 마크다운 파일로 구동되어 추적성을 보장합니다.
병렬 실행 시스템	작업을 parallel: true로 표시하고 각 에이전트가 자체 git worktree에서 작업하는 여러 에이전트를 실행하여 충돌을 방지합니다.
GitHub 우선 통합	이슈가 프로젝트 상태가 되고, 댓글이 감사 추적으로 작동합니다. 별도의 데이터베이스나 Projects 보드가 필요 없습니다.
결정적 bash 스크립트	Stand-up, status, search, next-task, blocked-task 등이 스크립트로 즉시 실행되어 추가 LLM 토큰 비용을 제거합니다.
Agent-skill 플러그 앤 플레이	한 번 설치하면 Agent Skills 사양을 이해하는 모든 에이전트가 자연어로 CCPM을 호출할 수 있습니다(예: "issue 42 작업 시작").
완전한 추적성	모든 코드 줄은 PRD → Epic → Task → Issue → Commit 체인으로 추적할 수 있습니다.

설치

# 저장소 클론
git clone https://github.com/automazeio/ccpm.git

# Factory/Droid 하네스 예시
ln -s $(pwd)/ccpm/skill/ccpm ~/.factory/skills/ccpm

# Claude Code 예시
ln -s $(pwd)/ccpm/skill/ccpm .claude/skills/ccpm

전제 조건: git, 인증된 GitHub CLI(gh), 프로젝트가 위치할 GitHub 저장소.

일반적인 사용 흐름

1. 브레인스토밍 / PRD – *"알림 시스템을 구축하고 싶다"*라고 말하면 → CCPM이 명확화 질문을 하고 .claude/prds/notification-system.md를 작성합니다.
2. PRD → Epic 파싱 – *"notification-system PRD 파싱"*은 .claude/epics/notification-system/epic.md를 생성합니다.
3. 분해 – *"notification-system epic 분해"*는 메타데이터(depends_on, parallel)가 있는 작업 마크다운 파일을 생성합니다.
4. GitHub에 동기화 – *"notification-system epic을 GitHub에 동기화"*는 epic 이슈와 하위 이슈를 생성하고, 로컬 작업 파일을 이슈 번호로 이름을 바꾸고, 전용 worktree를 설정합니다.
5. 실행 – *"issue 42 작업 시작"*은 각자 파일에 범위가 지정된 병렬 에이전트를 실행합니다. 각 에이전트는 Issue #42: …와 같은 메시지로 커밋합니다.
6. 추적 – "standup" 또는 *"what's blocked"*는 번들된 standup.sh/status.sh 스크립트를 실행하여 마크다운 파일에서 실시간 보고서를 출력합니다.

프로젝트 구조

skill/ccpm/
├─ SKILL.md            # 스킬 진입점
└─ references/
   ├─ plan.md          # PRD → epic 로직
   ├─ structure.md     # 작업 분해
   ├─ sync.md          # GitHub 이슈 생성
   ├─ execute.md       # 병렬 실행
   ├─ track.md         # 상태/스탠드업 스크립트
   └─ scripts/        # 14개의 bash 헬퍼 (status.sh, standup.sh, …)

.claude/
├─ prds/               # 제품 요구 사항 문서
└─ epics/
   └─ <feature>/       # epic.md + <issue-id>.md 작업 파일

모든 진실 소스 데이터는 이러한 일반 마크다운 파일에 있습니다.

입증된 결과 (README의 주장)

• 컨텍스트 전환으로 인한 시간 손실 89% 감소.
• 단일 직렬 작업 대신 5–8개의 병렬 작업.
• 상세한 코딩 전 사양 덕분에 버그 75% 감소.
• 기능 제공 속도 최대 3배 향상.
• 내부 벤치마크에 따르면 CCPM 사용 시 PRD 생성, 이슈 실행, 스탠드업 성공률이 100%인 반면, 미사용 시 약 28%입니다.

개발 주체

• Automaze(https://automaze.io)가 개발했습니다. AI 기반 소프트웨어 제공에 특화된 컨설팅 회사입니다.
• 주요 연락처: X(이전 Twitter)의 @aroussi.

결론 CCPM은 AI 코딩 에이전트가 규율 있는 프로젝트 매니저처럼 작동하여 컨텍스트를 유지하고, 진정한 병렬 작업을 가능하게 하며, 모든 것을 GitHub Issues에서 볼 수 있게 하는 경량의 마크다운 우선 스킬입니다. 이미 LLM 기반 코딩 어시스턴트를 사용하고 있으며 재현 가능하고 감사 가능한 워크플로우를 원하는 팀에게 실용적인 추가 기능입니다.