The Brief
Claude Code 실전 · 10편 — 진화 이야기 ①

프롬프트 엔지니어링만으로는
부족했다 — 실무자의 기록

The Brief 편집팀·7분 분량·AI 인사이트
한마디로

좋은 프롬프트는 확실히 결과를 좋게 만들어요. 그런데 어느 날 깨달았어요 — 매일 아침 같은 프롬프트를 다시 타이핑하고 있다는 걸요. 프롬프트는 아무리 잘 써도 세션이 끝나면 증발하는 '1회용'이에요. 이 형식 자체가 프롬프트 엔지니어링의 상한선이었어요. 이 글은 그 벽에 부딪힌 기록이자, 컨텍스트 엔지니어링과 하네스로 넘어가게 된 진화 이야기의 1편이에요.

프롬프트 '장인'이 되어가던 시절

고백부터 하자면, 저는 프롬프트를 꽤 정성 들여 쓰는 편이었어요. 데이터 조직에서 분석과 제안 업무를 하다 보니 AI에게 시키는 일이 많았고, 시키는 만큼 프롬프트도 늘었거든요.

매번 이런 식이었어요. "너는 10년 차 데이터 분석 전문가야. 결과는 표로 정리하고, 수치엔 근거를 달아. 우리 조직은 이런 상황이고, 클라이언트는 이런 걸 싫어해…" 역할을 부여하고, 좋은 예시를 붙이고, 출력 형식을 지정하고. 이른바 프롬프트 엔지니어링의 정석대로요.

그리고 이건 실제로 통했어요. 대충 시키면 대충 나오고, 정성 들여 시키면 정성스러운 결과가 나왔어요. 프롬프트가 좋아질수록 결과가 좋아지는 걸 체감하니까, 저는 점점 더 긴 프롬프트를 쓰는 사람이 됐어요. 잘 먹힌 프롬프트는 메모장에 모아뒀다가 복사해 붙여넣고요. 여기까지는 아마 AI로 일하는 분이라면 다들 비슷한 경로였을 거예요.

균열 — 나는 매일 같은 걸 다시 설명하고 있었다

균열은 사소한 데서 왔어요. 어느 날 아침, 어제 하던 분석을 이어서 하려고 새 대화를 열었는데 — 손이 자동으로 어제 쓴 프롬프트를 다시 타이핑하고 있더라고요. 역할 부여부터, 조직 상황 설명, 출력 형식까지 전부요.

AI는 어제 저와 합의한 규칙을 몰라요. 지난주에 끝낸 프로젝트도, "그 표현은 쓰지 말자"고 정한 것도 몰라요. 세션이 끝나면 모든 게 증발하니까요. 그러니 제 프롬프트 실력이 늘수록, 매일 다시 타이핑해야 하는 분량도 같이 늘어난 거예요. 잘하게 될수록 더 피곤해지는 이상한 구조였죠.

장면 · 매일 아침의 반복상황:어제 하던 분석을 오늘 이어서 하려고 할 때
✕ 새 세션 — 매번 0에서

"너는 데이터 분석 전문가야, 우리 상황은 이렇고…"를 또 씁니다. 어제 어디까지 했는지, 왜 그렇게 분석했는지도 다시 설명해요. 본론에 들어가기 전에 워밍업으로만 10분이 사라져요.

✓ 바라던 모습

켜자마자 "어제 A안까지 만들고 검토 대기 중이었죠. B안부터 이어갈까요?"라고 AI가 먼저 말해주는 것. 설명 없이 바로 본론으로 들어가는 것.

→ 이 간극이 이 시리즈 전체의 출발점이에요
잘 쓴 프롬프트의 수명 — 세션이 끝나면 0으로 월요일 화요일 수요일 공들여 설명 → 결과 좋아짐 세션 종료 = 증발 다음 날, 또 0에서 AI가 아는 맥락
그림 1. 프롬프트로 쌓은 맥락은 세션과 함께 사라져요. 다음 날은 또 0에서 시작이에요.

시간이 새던 다섯 군데

그 무렵의 제 작업 방식을 돌아보면, 시간이 새는 구멍이 다섯 개 있었어요. 하나하나는 사소해 보이는데, 매일 반복되니 합치면 꽤 컸어요.

구멍 01
매 세션 0에서 시작

새 대화는 어제 맥락을 몰라요. 매번 처음부터 다시 설명하고, 그 설명이 조금씩 달라져서 결과도 조금씩 달라져요.

구멍 02
지침은 '말로만'

"표로 정리해줘", "존댓말로" 같은 규칙을 그때그때 부탁해요. 어떤 날은 깜빡하고, 그날 결과물만 품질이 달라져요.

구멍 03
있는 걸 또 만듦

지난달에 만든 보고서 템플릿이 있는데, AI도 나도 그 존재를 잊어서 비슷한 걸 처음부터 또 만들어요.

구멍 04
저장은 한 곳뿐

결과물이 클라우드 폴더 한 곳에만 있어요. 파일이 꼬이거나 날아가면 되돌릴 방법이 없어요.

구멍 05
검증 없이 산출

AI는 그럴듯하게 틀려요. 수치나 사실 오류를 사람이 일일이 잡아야 하고, 놓치면 그대로 보고서에 실려 나가요.

주목할 점은, 이 다섯 개 중 프롬프트를 더 잘 써서 해결되는 건 하나도 없다는 거예요. 구멍 2는 얼핏 프롬프트 문제 같지만, 아니에요. 규칙을 완벽하게 써도 다음 세션에서 그걸 다시 붙여넣는 걸 깜빡하면 끝이니까, 결국 같은 휘발성 문제예요.

진단 — 문제는 품질이 아니라 '형식'이었다

여기서 내린 진단이 이 시리즈의 첫 번째 결론이에요. 문제는 프롬프트의 품질이 아니라 프롬프트라는 형식 자체였어요.

프롬프트는 본질적으로 1회용이에요. 그 안에 담은 역할, 규칙, 맥락은 대화가 끝나는 순간 사라져요. 그러니 프롬프트 엔지니어링이 아무리 발전해도 그 상한선은 '매번 잘 부탁하는 기술'이에요. 부탁을 잘하는 법을 연마하는 게 아니라, 부탁 자체가 필요 없는 환경을 만들어야 했던 거죠.

오해는 말아주세요. 프롬프트 엔지니어링이 쓸모없다는 얘기가 아니에요. 명확하게 지시하고, 좋은 예시를 주고, 출력 형식을 정하는 감각은 지금도 매일 써요. 다만 그건 기본기이지 시스템이 아니에요. 기본기 위에 뭘 쌓느냐가 다음 단계였어요.

에디터 노트 · The Brief

돌아보면 신호는 명확했어요. "같은 걸 두 번 이상 타이핑하고 있다면, 그건 프롬프트가 아니라 설정이 되어야 한다"는 것. 매일 붙여넣는 역할 설명, 매번 반복하는 출력 규칙, 세션마다 다시 하는 상황 브리핑 — 전부 어딘가에 '상주'했어야 할 것들이었어요.

혹시 지금 메모장에 프롬프트 모음집을 갖고 계시다면, 그게 바로 그 신호예요. 그 메모장이 다음 편에서 다룰 '컨텍스트 엔지니어링'의 씨앗이거든요.

다음 편 예고 — 프롬프트를 '상주'시키다

그래서 방향을 바꿨어요. 프롬프트를 매번 쓰는 대신, AI가 일하는 공간에 파일로 심어두는 것. 매 세션 자동으로 읽히는 정체성 파일, 어제 작업을 기록해두는 인계 파일, 반복되는 결정을 쌓는 기억 파일. 업계에서 '컨텍스트 엔지니어링'이라고 부르게 된 바로 그 방식이에요.

2편에서는 그 전환으로 뭐가 좋아졌는지, 그리고 — 이게 더 중요한데 — 그다음에 뭐가 부러졌는지를 실제 사고 기록과 함께 다뤄요.

지금 바로 해보고 싶다면

이 시리즈는 '왜'를 다루는 이야기예요. 따라 하는 '방법'은 실전 가이드에 있어요.

1편 — 비개발자가 Claude Code를 '워크스페이스'로 쓴다는 것

2편 — 첫 세팅, 설치부터 초기 설정까지

자주 묻는 것

프롬프트 엔지니어링은 이제 배울 필요가 없나요?
아니요, 여전히 기본기예요. 명확한 지시, 좋은 예시, 출력 형식 지정은 어떤 방식으로 AI를 쓰든 결과 품질을 좌우해요. 다만 프롬프트는 세션이 끝나면 사라지는 1회용이라, 그것만으로는 '매번 다시 설명하는 문제'를 해결할 수 없어요. 기본기 위에 컨텍스트와 환경을 쌓는 게 다음 단계예요.
AI는 왜 지난 대화를 기억하지 못하나요?
AI가 한 번에 볼 수 있는 정보의 범위(컨텍스트 윈도)가 대화 단위로 초기화되기 때문이에요. 새 세션은 이전 세션의 내용을 모르는 상태로 시작해요. 그래서 기억시키고 싶은 것은 대화가 아니라 파일로 남겨서, 매 세션 다시 읽히게 만들어야 해요.
그럼 무엇부터 바꾸면 되나요?
매번 반복해서 타이핑하는 내용부터 파일로 옮기세요. 역할·규칙·상황 설명을 담은 정체성 파일(CLAUDE.md)이 시작점이에요. 이 시리즈 2편에서 그 과정을 다루고, 구체적인 방법은 실전 가이드 3편(CLAUDE.md)에 있어요.

← Claude Code 실전 가이드 목록