Claude Code Workflow(CCW)로 정리하는 단계별 개발 워크플로우와 멀티 CLI 자동화

이 글에서는 **Claude Code Workflow(CCW)**라는 CLI 기반 개발 워크플로우 도구를 중심으로,
개발 복잡도에 따라 선택할 수 있는 4단계 워크플로우 구조,
여러 AI CLI(Gemini, Codex, Qwen, Claude)를 자동 또는 수동으로 조합하는 멀티 CLI 오케스트레이션,
그리고 JSON 기반 상태 관리와 대시보드 기능까지 전반적인 구조와 활용 방식을 정리합니다.

특히 “간단한 수정부터 복잡한 멀티 모듈 개발까지, 어떤 기준으로 워크플로우를 선택해야 하는가”라는 고민을 가진 개발자에게 CCW가 어떤 해법을 제공하는지에 초점을 맞춰 설명합니다.

반응형

---

Claude Code Workflow(CCW)란 무엇인가

Claude Code Workflow(CCW)는 개발 작업의 복잡도에 따라 단계적으로 선택할 수 있는 CLI 기반 워크플로우 시스템입니다.
단순한 코드 수정부터 멀티 모듈 개발, 멀티 역할 브레인스토밍까지 하나의 흐름으로 관리할 수 있도록 설계되어 있습니다.

핵심은 다음과 같습니다.

• 작업 난이도에 맞춰 과도한 설계 없이 필요한 만큼만 워크플로우를 사용
• 여러 AI CLI를 상황에 맞게 자동 또는 수동으로 조합
• 실행 상태와 계획을 JSON 파일 하나로 일관성 있게 관리
• 대시보드를 통해 세션, 검색, 실행 상태를 시각적으로 관리

---

CCW의 핵심 특징 정리

1. 4단계 워크플로우 시스템

CCW는 개발 작업의 성격에 따라 다음과 같은 4단계 워크플로우를 제공합니다.

• Level 1: lite-lite-lite
  즉시 실행이 필요한 아주 단순한 작업
  예: README 오타 수정, 설정 값 변경
• Level 2: lite-plan / lite-fix / multi-cli-plan
  단일 기능 개발, 버그 원인 분석, 다각도 분석이 필요한 작업
• Level 3: plan / tdd-plan
  멀티 모듈 개발이나 테스트 주도 개발처럼
  세션 관리와 계획이 필요한 작업
• Level 4: brainstorm:auto-parallel
  여러 역할 관점에서 병렬 브레인스토밍이 필요한 복잡한 설계 작업

이 구조 덕분에 항상 동일한 프로세스를 강요받지 않고,
작업 복잡도에 맞춰 적절한 수준의 워크플로우를 선택할 수 있습니다.

---

2. 멀티 CLI 오케스트레이션

CCW는 Gemini, Codex, Qwen, Claude 등 여러 AI CLI를 동시에 또는 순차적으로 실행할 수 있습니다.

• 단일 CLI 호출
• 여러 CLI의 병렬 분석 후 결과 통합
• 특정 CLI는 분석, 다른 CLI는 구현 담당하는 순차 파이프라인

사용자는 “어떤 CLI를 어떻게 호출할지”를 직접 명령하지 않아도,
의미 중심의 프롬프트만으로 시스템이 적절한 CLI를 선택해 실행합니다.

---

3. 의존성 인식 병렬 실행

CCW는 작업 간 의존성을 분석해 병렬 실행이 가능한 에이전트는 동시에 처리합니다.
이 과정에서 별도의 워크트리를 강제하지 않아,
병렬 실행의 이점은 유지하면서도 복잡성은 줄였습니다.

---

4. Issue Workflow로 사후 유지보수 대응

메인 워크플로우와 별도로,
개발 이후 유지보수를 위한 Issue Workflow를 제공합니다.

• discover → plan → queue → execute 흐름
• 필요 시 워크트리 분리 가능

이를 통해 신규 개발과 유지보수 작업을 명확히 구분해 관리할 수 있습니다.

---

5. JSON 기반 상태 관리

모든 실행 상태와 계획은
.task/IMPL-*.json 파일 하나에 저장됩니다.

이 파일은 단순 로그가 아니라 단일 진실의 원천(Single Source of Truth) 역할을 하며,
세션 재개, 실행 추적, 대시보드 시각화의 기반이 됩니다.

---

CCW 대시보드와 검색 기능

대시보드 기능

ccw view 명령어를 통해 대시보드를 열 수 있으며, 다음을 관리할 수 있습니다.

• 워크플로우 세션 상태
• CLI 실행 현황
• API 및 커스텀 CLI 등록
• CodexLens 검색 및 그래프 탐색

---

CodexLens 로컬 코드 검색

CodexLens는 로컬 코드베이스를 의미 기반으로 검색할 수 있는 도구입니다.

• 프로젝트 인덱싱
• 대시보드에서 검색 실행 및 관리

현재는 개발 중 기능으로, 일부 기능이 불안정할 수 있음을 명시하고 있습니다.

---

CCW 설치 및 기본 사용 방법

CCW 설치

npm install -g claude-code-workflow
ccw install -m Global

---

워크플로우 선택 예시

Level 1: 즉시 실행

/workflow:lite-lite-lite "Fix typo in README"

Level 2: 가벼운 계획 수립

/workflow:lite-plan "Add JWT authentication"
/workflow:lite-fix "User upload fails with 413 error"

Level 3: 표준 계획 및 실행

/workflow:plan "Implement payment gateway integration"
/workflow:execute

Level 4: 병렬 브레인스토밍

/workflow:brainstorm:auto-parallel "Design real-time collaboration system" --count 5
/workflow:plan --session WFS-xxx
/workflow:execute

---

/ccw 명령어 기반 자동 워크플로우 선택

CCW는 /ccw 명령어를 통해 사용자의 의도를 분석하고 자동으로 워크플로우를 선택합니다.

/ccw "Add user authentication"
/ccw "Fix memory leak in WebSocket"
/ccw "Implement with TDD"

또한 /ccw-coordinator를 사용하면
분석 → 체인 추천 → 사용자 확인 → 실행의 수동 조율도 가능합니다.

---

CCW 아키텍처 한눈에 보기

CCW는 다음 구조로 동작합니다.

• 메인 워크플로우: 4단계 개발 흐름 관리
• Issue Workflow: 사후 유지보수 보조
• 의존성 분석 기반 병렬 처리
• 복잡도에 따른 워크플로우 선택 원칙

핵심 원칙은 과도한 설계를 피하고, 필요한 만큼만 사용하자는 것입니다.

---

728x90

Claude Code Workflow(CCW)는
단순한 CLI 자동화 도구가 아니라,
개발 복잡도를 기준으로 사고하고 실행하도록 돕는 워크플로우 시스템입니다.

• 작업 규모에 맞는 프로세스 선택
• 멀티 AI CLI의 효율적인 활용
• 상태와 실행 흐름의 명확한 관리
• 신규 개발과 유지보수의 분리

결과적으로 개발자는
“어떤 도구를 언제, 얼마나 써야 하는지”에 대한 고민을 줄이고,
문제 해결 자체에 더 집중할 수 있는 환경을 기대할 수 있습니다.

300x250

https://github.com/catlog22/Claude-Code-Workflow

GitHub - catlog22/Claude-Code-Workflow: JSON-driven multi-agent development framework with intelligent CLI orchestration (Gemi