중요

Claude Code Workflow는 현재 아카이브(archived)되었습니다. 모든 활발한 개발은 다음 위치에서 계속됩니다:

npm install -g maestro-flow

Maestro Flow는 CCW의 모든 기능에 더해 다음을 포함합니다: 지식 그래프 (Knowledge Graph), 적응형 라이프사이클 엔진 (adaptive lifecycle engine, Ralph), 훅 시스템 (hook system), 팀 협업 (team collaboration) 등.

| Gemini, Qwen, Codex, Claude로부터 - 자동 선택 또는 수동 역할 기반 에이전트 (Role-based agents), 내부 루프 실행 (inner loop execution), 백그라운드 큐 실행 서비스 (Background queue execution service) |
| 워크플로 세션 시작/재개/완료/동기화 (start/resume/complete/sync workflow sessions), 실행 모니터가 포함된 멀티 터미널 그리드 (Multi-terminal grid with execution monitor), 템플릿 기반 워크플로 시각적 편집 (Template-based workflow visual editing), 에이전트-사용자 상호작용 인터페이스 (Agent-to-User interactive interface) |

📖

처음이신가요? 전체 워크플로 문서를 보려면 워크플로 가이드 (Workflow Guide)를 참조하세요.

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

.codex/skills/ 워크플로 기술 (workflow skills)과 함께 Codex CLI를 사용하는 경우, 다음 필수 기능들을 ~/.codex/config.toml에 추가하세요:

[features]
default_mode_request_user_input = true # 대화형 확인을 위한 request_user_input 도구 활성화
multi_agent = true # 멀티 에이전트 조정 활성화 (spawn_agent, wait 등)
...

이 기능들은 워크플로 기술이 제대로 작동하기 위해 필수적입니다. 이 기능들이 없으면 대화형 확인 게이트 (request_user_input), 서브 에이전트 오케스트레이션 (subagent orchestration), 그리고 CSV 기반 병렬 실행 (CSV-driven parallel execution)이 작동하지 않습니다.

CCW는 두 가지 유형의 호출을 사용합니다:

유형 (Type)	형식 (Format)	예시 (Examples)
기술 (Skills)	트리거 문구 (슬래시 없음)	`workflow-lite-plan` , `brainstorm` , `workflow-plan`
명령어 (Commands)	슬래시 명령어 (Slash command)	`/ccw` , `/workflow/session:start` , `/issue/new`

기술 트리거 (Skill Trigger)	사용 사례 (Use Case)
`workflow-lite-plan`	경량 계획, 단일 모듈 기능 (lite-execute로 전달)
`workflow-multi-cli-plan`	멀티 CLI 협업 분석
`workflow-plan`	세션 지속성이 있는 전체 계획
`workflow-tdd-plan`	테스트 주도 개발 (Test-driven development)
`workflow-test-fix`	테스트 생성 및 수정 사이클
`brainstorm`	멀티 역할 브레인스토밍 분석

기술 트리거 (슬래시 없이 - 원하는 내용을 설명하세요)

workflow-lite-plan "JWT 인증 추가"
workflow-plan "결제 게이트웨이 연동 구현"
...

CLI	설명	공식 문서
Gemini	Google AI 분석	google-gemini/gemini-cli
Codex	OpenAI 자율 코딩 (autonomous coding)	openai/codex
OpenCode	오픈 소스 멀티 모델 (multi-model)	opencode-ai/opencode
Qwen	Alibaba Qwen-Code	QwenLM/Qwen

사용자는 프롬프트에서 CLI 도구를 의미론적으로 지정 (semantically specify) 할 수 있으며, 시스템은 자동으로 해당 CLI를 호출합니다.

사용자 프롬프트	시스템 동작
"Gemini를 사용하여 인증 모듈을 분석해줘"	분석을 위해 `gemini` CLI 자동 호출
...

패턴	사용자 프롬프트 예시
협업형 (Collaborative)	"Gemini와 Codex를 사용하여 보안 취약점을 협업하여 분석해줘"
병렬형 (Parallel)	"Gemini, Codex, Qwen이 아키텍처를 병렬로 분석하게 해줘"
반복형 (Iterative)	"Gemini로 진단하고, Codex로 수정하며, 해결될 때까지 반복해줘"
파이프라인형 (Pipeline)	"Gemini가 솔루션을 설계하고, Codex가 구현하며, Claude가 검토해줘"

ACE (Augment Context Engine)는 강력한 의미론적 코드 검색 (semantic code search)을 제공합니다.

⚠️ 개발 중: CodexLens는 반복적인 최적화 단계에 있습니다. 일부 기능은 불안정할 수 있습니다.

검색 모드	설명
FTS	전체 텍스트 검색 (Full-text search), SQLite FTS5 기반
Semantic	의미론적 검색 (Semantic search), 로컬 임베딩 모델 (embedding models) 사용
Hybrid	하이브리드 검색 (Hybrid search), FTS + Semantic + 재순위화 (Reranking) 결합

명령	설명	사용 시점
/ccw	자동 워크플로우 오케스트레이터 (orchestrator) - 의도를 분석하여 워크플로우를 선택하고 실행	✅ 일반적인 작업, 자동 워크플로우 선택
/ccw-coordinator	스마트 오케스트레이터 - 명령 체인을 추천하고 수동 조정을 허용	🔧 복잡한 다단계 워크플로우

빠른 예시:

# /ccw - 자동 워크플로우 선택
/ccw "사용자 인증 추가"
/ccw "WebSocket의 메모리 누수 수정"
...

/workflow:session:start # 새로운 워크플로우 세션 시작
/workflow:session:resume # 일시 중지된 세션 재개
/workflow:session:list # 모든 세션 목록 표시
...

/issue/new # 새로운 이슈 생성
/issue/plan # 이슈 해결 계획 수립
/issue/queue # 실행 큐(queue) 형성
...

ccw install # 워크플로우 파일 설치
ccw view # 대시보드 열기
ccw cli -p "..." # CLI 도구 실행 (Gemini/Qwen/Codex)
...

┌─────────────────────────────────────────────────────────────────┐
│ 워크플로우 기술 (Workflow Skills) │
│ 📝 workflow-lite-plan / workflow-multi-cli-plan (경량형) │
...

Claude-Code-Workflow/
├── .claude/
│ ├── agents/ # 22개의 특화된 에이전트 (team-worker, cli-discuss 등)
...

v2 팀 아키텍처는 효율적인 오케스트레이션 (orchestration)을 위해 **이벤트 기반 비트 모델 (event-driven beat model)**을 도입합니다:

비트 사이클 (단일 비트) (Beat Cycle (single beat))
======================================================================
이벤트 코디네이터 워커 (Event Coordinator Workers)
...

주요 이점:

🎯 이벤트 기반 (Event-driven): 코디네이터는 필요할 때만 깨어남 (콜백/재개) - ⚡
⚡ 빠른 진행 (Fast-advance): 코디네이터의 왕복 과정 없이 단순 후속 작업이 직접 생성됨 - 🔄
🔄 동적 파이프라인 (Dynamic pipelines): 의존성 그래프 (dependency graph)로부터 작업별로 생성됨 - 📊
📊 병렬 실행 (Parallel execution): 독립적인 작업들이 동시에 실행됨

실시간 실행 모니터링을 지원하는 멀티 터미널 그리드 레이아웃입니다.

기능:

🖥️ 크기 조절 가능한 창을 가진 멀티 터미널 그리드
📊 에이전트 목록이 포함된 실행 모니터
📁 프로젝트 탐색을 위한 파일 사이드바
🎯 프로젝트 태그별 세션 그룹화
🌙 전체 화면/몰입 모드

드래그 앤 드롭 방식의 시각적 워크플로우 템플릿 에디터입니다.

기능:

🎨 React Flow 기반의 시각적 편집
📦 사전 구축된 워크플로우가 포함된 템플릿 라이브러리
🔧 노드 설정을 위한 속성 패널
⚡ 슬래시 명령어 (Slash command) 통합

결점 없는 (Impeccable)— 디자인 감사 방법론, OKLCH 색상 시스템, 안티-AI-슬롭 (anti-AI-slop) 탐지 패턴, 편집 타이포그래피 표준, 모션/애니메이션 토큰 아키텍처, 그리고 바닐라 JS 상호작용 패턴. UI 팀 기술 (team-ui-polish, team-interactive-craft

, team-motion-design

, team-visual-a11y

, team-uidesign

, team-ux-improve

)는 Impeccable의 디자인 지식을 대폭 활용합니다. -
gstack— 체계적인 디버깅 방법론 (Systematic debugging methodology), 보안 감사 프레임워크 (Security audit frameworks), 그리고 릴리스 파이프라인 패턴 (Release pipeline patterns). investigate (Iron Law 디버깅), security-audit (OWASP Top 10 + STRIDE), 그리고 ship (gated release pipeline) 기술은 gstack의 워크플로우 디자인에서 영감을 받았습니다.

CCW WeChat 그룹에 참여하여 다른 개발자들과 팁을 논의하고 경험을 공유하세요!

WeChat 그룹에 참여하려면 스캔하세요 (QR 코드가 만료된 경우, 최신 코드를 위해 Issue를 생성해 주세요)

catlog22/Claude-Code-Workflow

요약

핵심 포인트

기술 트리거 (슬래시 없이 - 원하는 내용을 설명하세요)

댓글