From deep-work
Orchestrates Evidence-Driven Development sessions: initializes multi-sessions, loads profiles/flags, sets up git worktrees/directories, detects stale states, and prepares TDD phases.
npx claudepluginhub sungmin-cho/claude-deep-suite --plugin deep-workThis skill uses the workspace's default tool permissions.
사용자 입력: **$ARGUMENTS**
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Designs, implements, and audits WCAG 2.2 AA accessible UIs for Web (ARIA/HTML5), iOS (SwiftUI traits), and Android (Compose semantics). Audits code for compliance gaps.
사용자 입력: $ARGUMENTS
SessionStart hook의 update-check.sh 출력 처리:
JUST_UPGRADED → 업그레이드 완료 메시지, 계속 진행UPGRADE_AVAILABLE → 프로필 auto_update 확인 → 자동 또는 AskUserQuestion으로 업그레이드 제안.claude/deep-work.local.md 존재 + active → migrate_legacy_state 실행
detect_stale_sessions → 각 stale 세션에 대해 AskUserQuestion:
Registry에서 활성 세션 표시. 5개 이상이면 경고.
SESSION_ID=$(generate_session_id)
write_session_pointer "$SESSION_ID"
| 플래그 | 효과 |
|---|---|
--setup | 프로필 재설정 강제 |
--team | team_mode → "team" |
--zero-base | project_type → "zero-base" |
--skip-research | start_phase → "plan" |
--skip-brainstorm | brainstorm 건너뜀 |
--tdd=MODE | strict / relaxed / coaching / spike |
--skip-review | review_state → "skipped" |
--no-branch | git_branch → false |
--skip-to-implement | Plan까지 전부 건너뜀, 인라인 slice |
--profile=X | 프리셋 X 직접 선택 |
플래그 제거 후 나머지 = task description. 비어있으면 AskUserQuestion.
.claude/deep-work-profile.yaml 존재 시:
--profile=X / 단일 프리셋 → 자동선택 / 복수 → AskUserQuestion프로필 미존재 시: 아래 대화형 설정 진행.
기존 프로필 존재 → 프리셋 관리 UI (편집/새로 만들기)
프로필 로드 성공 시 이 단계 전부 건너뜀.
mkdir -p .deep-work
TASK_FOLDER="${TIMESTAMP}-${SLUG}"
mkdir -p ".deep-work/${TASK_FOLDER}"
Legacy deep-work/ → .deep-work/ 마이그레이션 자동 처리.
codex/gemini 설치 여부 확인 → 프로필의 cross_model_preference에 따라 자동 활성화 / AskUserQuestion.
세션 히스토리 충분 시 (>=5):
Git repository인 경우:
worktree_enabled: true, worktree_path, worktree_branch state에 기록.claude/deep-work.{SESSION_ID}.md 생성 (YAML frontmatter):
Registry 등록: register_session "$SESSION_ID" ...
프로필 미존재 시 .claude/deep-work-profile.yaml에 v2 형식으로 저장.
Deep Work 세션이 시작되었습니다!
작업: $ARGUMENTS
작업 폴더: $WORK_DIR
프리셋: [preset_name]
작업 모드: Solo / Team
TDD 모드: strict / relaxed / coaching / spike
모델 라우팅: R=[model] P=main I=[model] T=[model]
워크플로우:
Phase 0: deep-brainstorm [← 현재 / ✅ 건너뜀]
Phase 1: deep-research
Phase 2: deep-plan
Phase 3: deep-implement
Phase 4: deep-test
자동 흐름을 시작합니다...
ARGS="--session={SESSION_ID}"
if worktree_enabled: ARGS += " --worktree={worktree_path}"
if team_mode=team: ARGS += " --team"
if cross_model_enabled: ARGS += " --cross-model"
if tdd_mode: ARGS += " --tdd={tdd_mode}"
State의 current_phase에서 시작점 결정:
skipped_phases / start_phase 확인. 건너뛰면 → 3-2.
Skill("deep-brainstorm", args=ARGS)
완료 후 (current_phase → research): → 3-2.
Skill("deep-research", args=ARGS)
완료 후: Review + Approval Workflow 실행.
Phase Skill 완료 후:
승인 → current_phase: plan 설정 → 3-3.
Skill("deep-plan", args=ARGS)
완료 후: Review + Approval Workflow 실행 (Research와 동일 패턴). → 상세: Read("skills/shared/references/review-approval-workflow.md")
승인 → State 업데이트:
current_phase: implementplan_approved: trueplan_approved_at: current ISO timestamp (drift baseline으로 사용)
→ 3-4.Skill("deep-implement", args=ARGS + " --tdd={tdd_mode}")
완료 후 (current_phase → test): → 3-5.
current_phase 변경 주체: Implement Phase Skill이 직접
test로 전환.
Skill("deep-test", args=ARGS)
/deep-test가 내부적으로 implement-test retry loop 관리 (max 3회).
All pass (test_passed: true, current_phase는 test 유지): → 3-6.
Retry exhausted: auto-flow 중단. 사용자 수동 개입.
current_phase 변경 주체: Test Phase Skill은
current_phase를 변경하지 않음. Orchestrator가 finish 후 idle로 전환.
Read /deep-finish → 완료 옵션 제시:
세션 히스토리 기록 (JSONL), Session Quality Score 계산.
Finish 완료 후: current_phase: idle 설정.
Registry 해제: unregister_session "$SESSION_ID".
| Phase | Review | 사용자 승인 | current_phase 변경 주체 |
|---|---|---|---|
| Brainstorm | 선택적 | 불필요 | Phase Skill |
| Research | 필수 | 필수 | Orchestrator |
| Plan | 필수 | 필수 | Orchestrator |
| Implement | Phase Review | 불필요 | Phase Skill |
| Test | 자동 | 불필요 | Phase Skill |