작업을 맡기는 법: 목표 중심 프롬프트 | 클로드 코드 에이전틱 자동화

Claude Code에게 일을 "맡긴다"는 것

Claude Code를 처음 쓰는 사람들이 가장 흔히 하는 실수는 절차를 지시하는 것입니다. "app.tsx 파일을 열고, 47번째 줄을 수정하고, useState를 useReducer로 바꿔라" — 이런 지시는 인간 동료에게도 좋지 않습니다. Claude Code는 코드베이스 전체를 컨텍스트로 이해하는 에이전트입니다. 절차 대신 목표와 제약을 주면 훨씬 좋은 결과를 냅니다.

목표 중심 프롬프트(Goal-Oriented Prompt)의 핵심은 단순합니다: "무엇을 해야 하는가"를 정의하고, "어떻게 할 것인가"는 Claude에게 맡기는 것. 이 접근이 왜 더 좋은 결과를 내는지, 그리고 어떻게 구성하는지 구체적으로 살펴봅니다.

나쁜 프롬프트 vs 좋은 프롬프트 비교

같은 작업을 두 가지 방식으로 요청하는 예시를 보겠습니다.

# ❌ 절차 중심 (나쁜 예)
components/UserCard.tsx 파일을 찾아서
props 타입에 optional avatar 필드 추가하고
렌더 부분에 이미지 태그 넣어줘

# ✅ 목표 중심 (좋은 예)
UserCard 컴포넌트에 선택적 아바타 이미지 표시 기능을 추가해줘.
- avatar URL이 없으면 이니셜로 폴백
- 기존 스냅샷 테스트가 깨지면 업데이트까지 처리
- 접근성(alt 속성, aria-label) 포함

두 번째 프롬프트는 Claude가 관련 파일(테스트, 타입 정의, 스타일)을 스스로 찾아 일관되게 수정합니다. 첫 번째는 지정한 파일만 수정해 테스트가 깨지거나 타입 오류가 남습니다.

효과적인 목표 중심 프롬프트의 4요소

What (무엇을): 원하는 최종 상태를 명확히. "로그인 폼에 비밀번호 강도 표시기 추가" — 구현 방법이 아닌 기능 설명.
Why (왜): 맥락이 있으면 더 적합한 선택을 합니다. "모바일 사용자가 많아서 탭 전환 없이 한 화면에서 확인 가능하도록" — Claude가 모바일 친화적 UI를 선택합니다.
Constraints (제약): 하지 말아야 할 것, 건드리지 말아야 할 파일, 유지해야 할 기존 동작. "기존 e2e 테스트 시나리오는 변경하지 말 것"
Done criteria (완료 기준): 어떻게 되면 끝인지 명시. "npm run test가 통과하고, TypeScript 에러 0개면 완료"

CLAUDE.md로 프롬프트 기준선 설정

매번 긴 컨텍스트를 적는 대신, 프로젝트 루트에 CLAUDE.md를 두면 Claude Code가 세션 시작 시 자동으로 읽습니다. 이곳에 프로젝트의 기본 맥락을 정의하면 프롬프트가 훨씬 짧아집니다.

# CLAUDE.md 예시
## 프로젝트 개요
Next.js 14 + Supabase + TypeScript. 채용 플랫폼.

## 코딩 규칙
- 컴포넌트는 함수형, export default
- 서버 액션은 app/actions/ 에만
- 새 테이블 생성 시 supabase/migrations/ 에 SQL 파일 필수

## 하지 말 것
- types/supabase.ts 직접 수정 금지 (자동생성 파일)
- console.log를 프로덕션 코드에 남기지 말 것

이 파일이 있으면 "채용 공고 마감일 알림 기능 추가해줘"처럼 짧게만 써도 Claude가 프로젝트 구조와 규칙을 지킵니다.

복잡한 작업의 단계적 위임 전략

한 번에 너무 큰 작업을 주면 중간에 판단이 잘못될 수 있습니다. 큰 기능은 단계로 나누되, 각 단계의 완료 기준을 명시하면 안전합니다.

# 큰 작업을 단계로 분리하는 예
1단계: 결제 모듈 타입 정의와 DB 스키마만 먼저 설계해줘.
       구현은 하지 말고 내가 검토 후 승인하면 2단계로 넘어갈게.

2단계: (1단계 승인 후) 결제 서버 액션 구현해줘.
       토스페이먼츠 SDK 사용, 기존 auth 미들웨어 패턴 따를 것.

3단계: 결제 UI 컴포넌트 추가해줘.
       기존 Button, Input 컴포넌트 재사용.

목표 중심 프롬프트의 핵심 교훈: Claude Code는 코드베이스를 이해하는 동료입니다. 단계를 지시하는 것은 시니어 개발자에게 "이 변수명은 x로 하고, 이 줄에 세미콜론 넣어"라고 말하는 것과 같습니다. 원하는 결과와 제약을 주면 어떻게 할지는 Claude가 더 잘 압니다.

핵심 정리

절차 지시 대신 What·Why·Constraints·Done criteria 4요소로 목표를 정의 — Claude가 관련 파일을 스스로 찾아 일관되게 수정
CLAUDE.md에 프로젝트 맥락·규칙·금지 사항을 정의하면 매 프롬프트에서 반복 설명 불필요
큰 작업은 단계로 분리, 각 단계 완료 기준 명시로 중간 검토 지점 확보

관련 검색어 · 클로드 코드 · Claude Code · 에이전틱 자동화 · 목표 중심 프롬프트 · CLAUDE.md 작성법 · 클로드 코드 프롬프트 · AI 작업 지시법 · AI 자동화 도구