본문 바로가기
스터디 열기

프롬프트 엔지니어링

같은 AI를 두고도 결과가 사람마다 다릅니다. 이 차이를 설명하려고 업계는 몇 년 사이에 네 단어를 차례로 만들었습니다. 프롬프트 엔지니어링, 컨텍스트 엔지니어링, 하네스 엔지니어링, 루프 엔지니어링입니다. 이 장을 처음 쓴 2026년 5월에는 앞의 세 가지였고, 6월 무렵 루프 엔지니어링이라는 말이 더해졌습니다.

그런데 그 몇 달 사이에 이 네 가지 고민의 상당 부분이 AI와 제품 안으로 들어갔습니다. 모델은 대충 말해도 뜻을 알아듣고, 필요한 맥락은 메모리와 이전 대화에서 스스로 찾아옵니다. 예전에 사람이 손으로 짜던 작업 환경은 Claude Code 같은 제품의 기본 기능이 되었습니다. 그래도 끝까지 사람에게 남는 일이 하나 있습니다. AI가 알 수 없는 나만의 맥락을 건네는 일입니다. 그리고 반복해서 건네는 맥락은 스킬(Skills) 이라는 형태로 모입니다.

엔지니어링처음의 질문지금은 누가 하나사람에게 남는 것
프롬프트어떻게 물어볼까모델이 뜻을 알아서 읽음무엇을 왜 원하는지
컨텍스트무엇을 같이 보여 줄까메모리·대화 검색·파일 읽기세상에 없는 내 정보
하네스어디서 어떻게 일하게 할까제품의 기본 기능반복되는 맥락을 스킬로
루프언제까지 반복하게 할까반복·예약 실행 기능언제 끝났다고 볼지

이 흐름을 그림 하나로 보면 다음과 같습니다.

4장은 이 흐름을 바이브 코딩에 필요한 만큼만 다룹니다. 이 절에서는 프롬프트, 4-2에서는 컨텍스트, 4-3에서는 하네스와 스킬, 그리고 루프를 짧게 봅니다.

더 깊이 들어가고 싶다면: 네 가지 엔지니어링의 역사와 기법, 하네스를 직접 설계하는 법, 루프를 안전하게 돌리는 법은 별도 교재 『프롬프트, 컨텍스트, 하네스 엔지니어링 에센셜』에서 자세히 다룹니다. 1장에서 네 가지 흐름을, 3장에서 프롬프트, 4장에서 컨텍스트, 5장에서 하네스, 6장에서 위니브 랜딩 페이지 하네스 사례, 8장에서 루프를, 9장에서 맥락이 스킬로 모이는 흐름을 다룹니다.

1. 프롬프트 엔지니어링이란

프롬프트 엔지니어링(prompt engineering)은 AI에게 주는 입력 글을 설계해서 원하는 결과를 받아내는 기술입니다. 한 줄로 줄이면 "AI에게 잘 물어보는 법"입니다. 프롬프트는 AI 입력창에 넣는 글 전체를 말합니다.

예전에는 이 기술이 결과를 크게 갈랐습니다. 역할(10년 경력의 마케터처럼), 맥락, 작업, 형식의 네 요소를 갖춰 쓰라는 공식이 있었고, 예시를 몇 개 같이 주는 퓨샷(Few-shot), 단계별로 생각하게 하는 사고의 사슬(Chain of Thought) 같은 기법을 익히는 것이 AI를 잘 쓰는 사람의 조건이었습니다. 모델이 말귀를 잘 못 알아들었기 때문입니다.

지금은 사정이 다릅니다. 모델이 문장 뒤의 의도를 잘 읽어서, 정해진 틀에 맞춰 쓰지 않아도 원하는 것을 알아듣습니다. 역할을 부여하는 문장 한 줄이나 형식을 꾸미는 기교가 만드는 차이는 많이 줄었습니다. 대신 Claude Code 공식 문서의 표현처럼 "Claude는 의도를 추론할 수 있지만 마음을 읽지는 못합니다." 결과를 가르는 것은 문장 기술이 아니라 AI가 알 수 없는 정보를 얼마나 건넸는가로 옮겨 갔습니다.

2. 직접 해보기

Claude Code를 열고 빈 폴더에서 아래 두 요청을 차례로 해 보세요. 두 번째 요청은 새 폴더에서 하거나, /clear로 대화를 비운 뒤 합니다.

2.1 한 줄로 시키기

독서 모임 페이지 만들어줘.

예전 같으면 쓸모없는 결과가 나왔을 요청입니다. 지금은 이 한 줄로도 꽤 그럴듯한 페이지가 나옵니다. 다만 그 페이지는 '세상의 평균적인 독서 모임'을 위한 것입니다.

2.2 맥락을 담아 한 문단으로 시키기

우리 동네 독서 모임 열두 명이 쓸 페이지를 만들어줘.
회원은 대부분 50~60대이고 휴대폰으로만 봐. 글씨는 크게, 버튼은 적게 해줘.
모임은 격주 토요일 오전이고, 회원들이 제일 자주 묻는 건 다음 모임 날짜와 읽을 책이야.
기술 선택은 알아서 하고, 만들기 전에 꼭 필요한 것만 먼저 물어봐줘.

역할을 부여하지도, 형식을 꾸미지도 않았습니다. 누가 쓰는지, 어떤 상황인지, 무엇이 가장 중요한지를 말했을 뿐입니다. 이것은 AI가 아무리 똑똑해도 스스로 알 수 없는 정보입니다.

마지막 줄도 눈여겨보세요. 애매한 부분을 미리 다 정해 두지 않고, 꼭 필요한 것만 AI가 묻게 했습니다. Claude Code는 이렇게 요청하면 만들기 전에 질문을 먼저 하고, 선택지를 보여 주며 고르게 하기도 합니다. 기술을 무엇으로 쓸지, 화면을 어떻게 나눌지 같은 결정은 AI에게 맡기는 편이 대개 결과가 좋습니다. 큰 작업이라면 계획 모드로 계획을 먼저 보고 시작할 수도 있습니다(3장에서 다룹니다).

3. 무엇을 관찰해야 하나

두 결과를 나란히 놓고 보세요.

  • 한 줄 요청의 결과도 충분히 쓸 만합니다. 프롬프트를 잘 다듬지 않아도 AI가 알아서 채우는 시대라는 뜻입니다.
  • 두 번째 결과는 '우리 모임'에 맞춰져 있습니다. 글씨 크기, 첫 화면에 무엇이 보이는지가 다릅니다. 이 차이는 문장 기술이 아니라 건넨 정보에서 나왔습니다.

저희도 2026년 11월 8일에 빈 폴더 두 개를 만들어 Claude Code에 이 두 요청을 그대로 넣어 봤습니다.

누가 쓰는지 말하자 휴대폰 첫 화면이 다음 모임 날짜와 읽을 책으로 채워졌다.

두 결과를 휴대폰 너비로 열어 첫 화면만 나란히 놓았습니다. 왼쪽 한 줄 요청의 결과는 '책갈피'라는 이름을 지어 붙인 깔끔한 소개 페이지입니다. 다만 첫 화면을 모임 소개 문구와 버튼 두 개가 차지하고, 다음 모임 날짜는 한참 내려가야 나옵니다. 이번 달 책 『작별하지 않는다』, 모임 시간, 회비, 문의 메일도 모두 AI가 지어 넣은 예시였고, Claude도 답에서 "내용은 모두 예시입니다"라고 밝혔습니다. 휴대폰 너비에서는 소개 문장 한 줄이 화면 밖으로 잘리기도 했습니다.

오른쪽 한 문단 요청에는 Claude가 만들기 전에 질문 세 개를 먼저 했습니다. 책과 날짜를 누가 어떻게 바꿀지, 다음 모임이 11월 14일인지 21일인지, 공개 주소로 만들어도 되는지입니다. 날짜와 장소, 책 이름을 답해 주자 첫 화면에 '11월 14일 토요일 오전 10시'와 남은 날수, 읽을 책, 장소가 큰 글씨로만 놓인 페이지가 나왔습니다. 버튼은 하나도 없었고, 격주 토요일 날짜는 페이지가 스스로 계산해 넘기게 만들었습니다. 둘 다 같은 AI이고, 달라진 것은 건넨 정보뿐입니다.

이 책 10장에서 다루는 '한 문단 브리프'가 바로 이 방식입니다. 프롬프트 기법 중 지금도 쓸모 있는 습관은 세 가지 정도입니다.

  • 보여 주기: 말로 설명하기 어려운 느낌은 참고 사이트 주소나 화면 캡처를 같이 줍니다. 6장에서 자세히 다룹니다.
  • 끝난 모습 말하기: "휴대폰에서 버튼 하나로 다음 모임 날짜가 보이면 끝"처럼 언제 다 됐다고 볼지 말해 줍니다.
  • 하지 말 것 말하기: "회원 이름은 화면에 보이지 않게"처럼 꼭 피해야 할 것을 말해 줍니다.

남은 질문은 이것입니다. 두 번째 요청에 담은 정보를 매번 다시 말해야 할까요. AI가 그 정보를 스스로 찾아오게 할 수는 없을까요. 다음 절에서 컨텍스트 엔지니어링으로 이어 갑니다.

마지막 수정