좋은 프롬프트의 구조: 목표→맥락→제약→산출물

AI에게 부탁할 때 머릿속에는 원하는 모습이 꽤 선명한데, 막상 적고 나면 "사이트 좀 만들어 줘" 한 줄일 때가 있습니다. AI가 그 사이를 전부 알아서 맞혀 주기는 어렵죠. 목표 → 맥락 → 제약 → 산출물로 나눠 적어 보면 내가 빠뜨린 조건부터 보입니다. 이 순서가 유일한 정답은 아니지만, 첫 요청을 정리하는 틀로 쓰기 좋습니다.

1. 목표: 한 줄, 동사로

무엇이 끝나면 성공인지 한 문장으로 씁니다. "홈페이지 개선"이 아니라 "뉴스레터 구독 랜딩 페이지 만들기"입니다. 독립적인 목표가 여러 개라면 나눠서 요청해 보세요. 무엇이 끝났고 무엇이 남았는지 확인하기 쉬워집니다.

• 나쁨: "사이트 좀 손봐 줘"
• 좋음: "메인 페이지 상단에 이메일 구독 폼을 추가해 줘"

2. 맥락: 누가, 어디서, 무엇으로

같은 목표라도 맥락이 다르면 답이 다릅니다.

• 대상 사용자: "혼자 콘텐츠를 만드는 1인 창작자"
• 기술 스택: Next.js, Supabase, Tailwind처럼 이미 쓰는 것. 없으면 "기술 선택은 네가 제안"
• 현재 상태: "지금은 정적 페이지만 있고 DB는 없음"

맥락은 길게 쓰지 않습니다. 코드베이스에서 알아낼 수 있는 것(폴더 구조 등)은 Claude가 직접 읽습니다. 프로젝트 전반의 규칙은 매번 적는 대신 CLAUDE.md에 둡니다.

3. 제약: 하지 말 것과 한계

원하는 모습만큼 바꾸면 안 되는 부분도 중요합니다. AI가 알아서 추측하지 않도록 이번 작업의 범위를 적어 주세요.

• 예산·기한: "무료 티어에서 동작", "오늘 안에 첫 버전"
• 금지: "로그인 없음", "새 유료 서비스 추가 금지", "기존 API 시그니처 변경 금지"
• 범위: "이 파일만 수정", "테스트 코드는 건드리지 않음"

한 줄에 하나씩 쓰면 읽고 확인하기 편합니다. 여러 작업에서 반복하는 규칙은 CLAUDE.md로 옮기고, 이번 요청에만 해당하는 조건은 프롬프트에 남겨 보세요.

4. 산출물: 형태를 지정

무엇을 받고 싶은지 형태로 말합니다.

Claude Code에서는 "계획 먼저"를 프롬프트로 쓰는 대신 plan 모드(Shift+Tab)로 강제할 수도 있습니다.

완성 예시

네 부분을 한 요청으로 연결하면 이런 모양이 됩니다. 아래 양식을 복사한 뒤 본인 작업에 맞게 바꿔 보세요.

## 목표
뉴스레터 구독 랜딩 페이지 만들기

## 맥락
- 대상: 혼자 콘텐츠를 만드는 1인 창작자
- 스택: Next.js, Supabase, Tailwind

## 필수 기능
- 이메일 입력 폼과 구독 완료 화면
- 중복 구독 방지
- 관리자만 볼 수 있는 구독자 목록

## 제약
- 구독자는 로그인 없이 제출. 관리자 목록은 인증·권한 확인 후 접근
- 무료 티어 범위의 연습용 페이지로 시작
- 외부 유료 서비스 사용 금지

## 산출물
- 코드를 쓰기 전에 계획을 먼저 보여 줄 것
- 바뀌는 파일 트리를 먼저 보여 줄 것
- 주석은 한국어로

결과가 나온 뒤

첫 결과가 어긋났다고 전체 요청을 처음부터 다시 쓸 필요는 없습니다. 네 부분 중 어디가 비었는지 찾습니다. 엉뚱한 기능이 생겼다면 목표를, 유료 서비스가 추가됐다면 제약을, 코드만 나왔다면 산출물 지정을 먼저 확인해 보세요. 요청이 명확했는데도 도구가 지시를 놓쳤을 수 있으니 원인부터 단정할 필요는 없습니다. 그 한 부분만 고쳐 다시 보냅니다. 방향이 틀린 채 여러 턴을 가면 비용만 늘어납니다(비용 줄이는 7가지).

다음 단계

• 위 양식에 지금 만들고 싶은 것의 목표·맥락·제약·산출물 채워 보기
• 바이브 코딩이란?
• 첫 홈페이지 만들기: Next.js + Vercel

출처와 확인 (2026-09-11)

• Claude Code: Manage costs effectively — Write specific prompts
• Claude Code: Permission modes (plan mode)
• 네 부분의 구조와 완성 예시는 첫 요청을 정리하기 위한 교육용 틀입니다.