좋은 프롬프트의 3원칙

💡 프롬프트가 결과의 80%를 결정한다

바이브 코딩에서 AI 도구의 성능이 도구마다 다소 차이가 있긴 하지만, 더 큰 차이를 만드는 것은 프롬프트의 품질입니다. 같은 AI에게 같은 작업을 시켜도, 프롬프트를 어떻게 쓰느냐에 따라 결과물의 품질이 천차만별입니다. 이번 강의에서는 좋은 프롬프트를 만드는 3가지 핵심 원칙을 배웁니다.

📌 원칙 1 — 명확성: 무엇을 원하는지 구체적으로

AI는 마음을 읽지 못합니다. 모호한 지시는 모호한 결과를 만듭니다. 당신이 머릿속에서 당연하다고 생각하는 것도 AI는 모를 수 있습니다.

나쁜 프롬프트	좋은 프롬프트
"로그인 만들어줘"	"이메일과 비밀번호로 로그인하는 폼을 만들어줘. 빈 칸 제출 시 '필수 입력 항목입니다' 에러 메시지를 폼 아래에 빨간 글자로 표시해줘."
"버튼 예쁘게 해줘"	"버튼 배경을 파란색(#2563EB)으로 바꾸고, 둥근 모서리(8px), 흰색 글자, 호버 시 어두운 파란색(#1D4ED8)으로 변경해줘."
"속도 빠르게 해줘"	"목록 조회 API가 3초 이상 걸려. 쿼리에 인덱스 추가하거나 캐싱을 적용해서 1초 이내로 만들어줘."

명확한 프롬프트를 쓰는 습관은 결과물을 상상하며 역으로 설명하는 것입니다. "완성되면 어떻게 보일까?"를 먼저 생각하고, 그걸 말로 풀어내세요.

🧭 원칙 2 — 맥락: 기술 스택·기존 코드·목적을 알려주기

AI는 당신의 프로젝트를 모릅니다. 프로젝트에 대한 정보를 직접 알려줘야 AI가 그 상황에 맞는 코드를 만듭니다.

맥락에 포함해야 할 요소:

• 기술 스택: "React + TypeScript + Tailwind CSS를 사용 중이야"
• 프로젝트 상황: "이미 user.ts 파일에 User 타입이 정의되어 있어"
• 목적: "관리자 전용 기능이라 복잡한 권한 체크는 없어도 돼"
• 제약 조건: "IE11은 지원 안 해도 돼. 모바일 우선으로 만들어줘"

🔖 실전 팁: 프로젝트를 시작할 때 CLAUDE.md나 .cursor-rules 같은 파일을 만들어 기술 스택, 코딩 컨벤션, 주의사항 등을 적어두면, AI가 매번 이 파일을 참고해 일관된 결과를 만듭니다. 설정 한 번으로 모든 프롬프트에 맥락이 자동 추가되는 셈입니다.

🚧 원칙 3 — 제약: 하지 말 것·스타일·범위를 명시하기

AI는 특정 지시가 없으면 스스로 판단해서 뭔가를 만듭니다. 이 판단이 당신의 의도와 다를 수 있습니다. 하지 말아야 할 것을 명시하면 엉뚱한 결과를 방지합니다.

• "기존 함수는 건드리지 말고, add 함수만 추가해줘"
• "라이브러리는 추가하지 말고 순수 JavaScript만 사용해줘"
• "지금은 UI만 바꾸고, 로직은 손대지 마"
• "TypeScript 타입 에러가 있어도 일단 any 쓰지 말고 정확한 타입을 찾아줘"

🔗 3원칙을 합친 최강 프롬프트

세 원칙을 하나의 프롬프트에 담으면 이렇게 됩니다:

우리 프로젝트는 Next.js 14 App Router + TypeScript + Tailwind CSS를 사용해. [맥락]
사용자 목록 페이지(app/users/page.tsx)에 이름으로 검색하는 기능을 추가해줘. [명확성]
검색은 클라이언트 측에서만 처리하고, API 호출은 새로 만들지 마. debounce는 300ms로 설정해줘. [제약]

이 정도의 프롬프트라면 AI가 한 번에 원하는 결과를 만들 확률이 크게 높아집니다.

⚠️ 흔한 실수 — "좋게 해줘" 시리즈

다음과 같은 프롬프트는 결과 예측이 어렵습니다:

• "UI 좋게 해줘" → 좋다는 기준이 없습니다.
• "최적화해줘" → 무엇을 기준으로 최적화할지 모릅니다.
• "더 나은 방법으로 바꿔줘" → 무엇이 나은 건지 AI가 임의로 판단합니다.

모호한 프롬프트가 틀린 건 아닙니다만, 결과를 수정하는 데 시간이 더 걸립니다. 처음부터 구체적으로 쓰는 편이 결과적으로 빠릅니다.

✅ 정리

• 명확성: 완성됐을 때 어떻게 보일지 구체적으로 묘사하세요.
• 맥락: 기술 스택, 기존 구조, 목적을 AI에게 알려주세요.
• 제약: 하지 말아야 할 것, 건드리면 안 되는 부분을 명시하세요.
• 3원칙 모두를 담을 필요는 없습니다 — 작업의 복잡도에 맞게 필요한 것만 추가하면 됩니다.