탐색·계획·실행 3단계 워크플로우 | 클로드 코드 완벽 마스터: AI 개발 워크플로우

3단계 워크플로우 — 탐색·계획·실행

Claude Code를 처음 쓰는 사람들이 자주 하는 실수는 "바로 만들어줘"입니다. 큰 작업을 준비 없이 바로 실행하면 절반쯤 갔을 때 방향이 틀렸다는 걸 알게 됩니다. 탐색 → 계획 → 실행 3단계 워크플로우는 Anthropic이 권장하는 패턴으로, 복잡한 작업에서 일관성 있는 결과를 내는 방법입니다.

1단계: 탐색 (Explore)

실행하기 전에 관련 코드를 먼저 읽습니다. Claude에게 "읽기만 해줘, 수정하지 마"를 명시합니다.

# 탐색 단계 — 읽기 전용 지시
"결제 모듈을 추가하기 전에, 먼저 관련 파일들을 파악해줘.
 지금은 아무것도 수정하지 말고 탐색만 해줘:
 - 현재 사용자 인증 구조 (app/actions/auth.ts)
 - 주문 관련 기존 코드가 있는지
 - DB 스키마 (types/supabase.ts의 관련 테이블)
 - 환경변수 현황 (.env.local 제외하고 패턴만)"

탐색 단계에서 Claude가 발견하는 것들:

기존에 비슷한 코드가 이미 있는지 (중복 방지)
새 기능이 의존해야 하는 기존 유틸리티
지켜야 할 패턴 (에러 핸들링 방식, 타입 컨벤션)
예상치 못한 복잡도 (외부 API, 레거시 코드)

2단계: 계획 (Plan)

탐색 결과를 바탕으로 실행 계획을 수립합니다. 계획을 먼저 작성하고 사람의 승인을 받는 것이 핵심입니다.

# 계획 수립 지시
"탐색 결과를 바탕으로 결제 모듈 구현 계획을 작성해줘.
 계획에는 다음이 포함되어야 해:
 1. 생성/수정할 파일 목록
 2. DB 변경사항 (마이그레이션 필요 여부)
 3. 환경변수 추가 목록
 4. 예상 작업 순서 (의존성 고려)
 5. 예상 리스크 또는 주의사항
 
 계획 작성 후, 내가 승인하면 실행해줘."

Claude가 작성하는 계획 예시:

## 결제 모듈 구현 계획

### 생성할 파일
- app/actions/payment.ts        (결제 Server Action)
- app/[locale]/checkout/page.tsx (결제 페이지)
- components/PaymentForm.tsx    (Toss 위젯 컴포넌트)

### DB 변경
- supabase/migrations/xxx_add_payments_table.sql
  payments 테이블: id, user_id, amount, status, toss_order_id

### 환경변수 추가
- TOSS_CLIENT_KEY (공개 키)
- TOSS_SECRET_KEY (서버 키) — .env.local에만

### 작업 순서
1. DB 마이그레이션 생성
2. types/supabase.ts 재생성
3. payment.ts Server Action
4. PaymentForm.tsx 컴포넌트
5. checkout/page.tsx 페이지
6. 테스트 및 검증

### 리스크
- Toss Payments 테스트 환경 확인 필요
- webhook 엔드포인트 추가 필요 (app/api/webhook/toss/route.ts)

3단계: 실행 (Execute)

승인된 계획대로 실행합니다. 계획이 있으면 Claude가 일탈할 가능성이 크게 줄어듭니다.

# 실행 지시 — 계획 참조
"승인했어. 계획대로 실행해줘.
 각 파일 완료할 때마다 '✅ [파일명] 완료' 알려줘.
 예상치 못한 문제가 생기면 실행 멈추고 먼저 알려줘."

실행 중 중단 조건을 명시하는 것이 중요합니다:

# 중단 조건 명시
"다음 상황에서는 실행 멈추고 나에게 먼저 물어봐:
 - 기존 파일을 삭제해야 할 때
 - 계획에 없던 파일을 수정해야 할 때
 - DB 기존 데이터에 영향을 줄 때
 - 환경변수가 추가로 필요할 때"

워크플로우 적용 기준

# 3단계 워크플로우가 필요한 경우 (복잡한 작업)
- 새 기능 전체 구현
- 여러 파일에 걸친 리팩터링
- DB 스키마 변경
- 외부 API 연동

# 간단히 바로 실행해도 되는 경우
- 단일 파일 버그 수정
- UI 텍스트·스타일 수정
- 기존 함수에 옵션 파라미터 추가
- 주석·타입 추가

think 모드 — 계획에 더 많은 시간 쓰기

Claude Code는 think, think hard, ultrathink 키워드로 더 깊은 추론을 요청할 수 있습니다.

# 복잡한 아키텍처 결정 시
"이 마이크로서비스 분리를 어떻게 할지 think hard해줘.
 성능, 유지보수성, 배포 복잡도를 모두 고려해서."

# 최고 난도 문제
"이 동시성 버그의 원인을 ultrathink로 분석해줘."

think 모드는 비용이 더 들지만, 아키텍처 결정이나 복잡한 버그 분석에서 훨씬 깊이 있는 분석을 제공합니다.

3단계 워크플로우의 핵심 가치는 "계획 단계에서 실수를 잡는 것"입니다. 실행 중에 잘못된 방향을 발견하면 이미 만들어진 코드를 되돌려야 합니다. 계획 단계에서 "이 접근법은 나중에 문제가 될 수 있어요"라는 피드백을 받으면 0 비용으로 방향을 바꿀 수 있습니다.

핵심 정리

탐색(읽기만) → 계획(승인 대기) → 실행(계획 준수) — 복잡한 작업에서 방향 오류를 0 비용으로 막는 표준 패턴
계획 단계에서 파일 목록·DB 변경·환경변수·작업 순서 명시 — 실행 중 일탈과 예상치 못한 변경 방지
think / think hard / ultrathink — 비용 더 쓰고 더 깊이 생각, 아키텍처 결정·복잡한 버그에 사용

관련 검색어 · 클로드 코드 워크플로우 · AI 개발 3단계 · Claude Code 탐색 계획 실행 · 클로드 코드 완벽 마스터 · AI 페어 개발 방법론