"프롬프트를 잘 쓰면 AI가 더 잘 답한다." 맞는 말이에요. 근데 한계가 있어요. 잘 쓴 프롬프트도 AI가 아무 맥락 없이 받으면 첫 번째 반응은 항상 이거예요.
"어떤 앱이에요? 타겟 사용자는요? 어떤 채널에 홍보하실 건가요?"
이게 바로 프롬프트 엔지니어링이 풀지 못하는 문제예요. 프롬프트는 지금 이 한 줄을 잘 쓰는 기술이거든요. 근데 AI가 일을 잘 하려면 한 줄이 아니라 창문 전체에 무엇이 있는지가 더 중요합니다. 그 창문을 설계하는 게 컨텍스트 엔지니어링이에요.
프롬프트 엔지니어링 vs 컨텍스트 엔지니어링
| 프롬프트 엔지니어링 | 컨텍스트 엔지니어링 | |
|---|---|---|
| 초점 | 입력 한 줄을 어떻게 쓸까 | AI의 컨텍스트 창에 무엇을 넣을까 |
| 범위 | 단일 요청 | 전체 세션 + 프로젝트 전반 |
| 핵심 질문 | "어떻게 질문하면 좋은 답이 나올까?" | "AI가 무엇을 알고 있어야 일을 잘 하나?" |
| 결과 | 세션마다 처음부터 | 세션이 바뀌어도 즉시 실행 |
한마디로, 프롬프트 엔지니어링은 "어떻게 물어볼까"이고 컨텍스트 엔지니어링은 "AI가 뭘 보고 있어야 하나"예요.
이런 소식, 남들보다 먼저 받으실 분?
직접 돌려보고 되는 것만 골라 매주 보내드립니다. 광고성 하이프는 거릅니다.
같은 질문, 완전히 다른 결과 — 라이브 데모
실제로 어떤 차이가 나는지, 컨텍스트 없을 때와 있을 때를 나란히 보여드릴게요.
왼쪽(CE 없음)은 같은 "이 앱 마케팅 해줘"를 받아도 무한 질문 루프에 빠져요. 오른쪽(CE 있음)은 CLAUDE.md와 memory-log.md가 이미 로드돼 있으니 즉시 실행하죠. 동일한 Claude, 동일한 프롬프트, 결과는 완전히 다릅니다.
카드뉴스로 먼저 보기
컨텍스트는 3개 레이어로 이루어져 있다
Claude가 응답할 때 보는 창(Context Window)에 들어갈 수 있는 정보는 크게 3가지 레이어로 나뉩니다.
프롬프트 엔지니어링이 3번 레이어(입력 한 줄)에만 집중했다면, 컨텍스트 엔지니어링은 1·2·3번 전체를 설계하는 것입니다.
최소 구현 — 파일 2개로 시작하기
거창하게 시작할 필요 없어요. 저는 파일 두 개로 컨텍스트 엔지니어링을 시작했습니다.
📋 CLAUDE.md — 레이어 1 (시스템 지시)
프로젝트 규칙, 행동 지침, 역할 정의를 넣는 파일. 프로젝트 루트에 두면 Claude Code가 매 세션 자동으로 읽어요. 한 번 써두면 "이 프로젝트가 어떤 건지"를 매번 설명할 필요가 없어집니다.
📝 memory-log.md — 레이어 2 (기억 & 상태)
세션이 끝날 때마다 핵심 결정과 진행 상황을 기록하는 파일. ## YYYY-MM-DD — 제목 형식으로 최신순으로 쌓아두면, 다음 세션에서 Claude가 이걸 읽고 "어디까지 했는지"를 알고 시작해요. 항목이 5개 넘으면 압축 스크립트로 archive로 보내서 창이 넘치지 않게 관리합니다.
이 두 파일이 갖춰지면 매 세션 첫 번째 메시지가 "어떤 앱이에요?"에서 "어디서 시작할까요?"로 바뀝니다. 질문 대신 실행이에요.
주의할 점: 컨텍스트 창에는 용량 한계가 있어요. memory-log.md를 무한정 늘리면 오래된 내용이 창을 꽉 채워 정작 중요한 현재 정보가 밀려납니다. 주기적인 압축(archive)이 컨텍스트 엔지니어링의 일부예요.
실제 적용 사례 — 마케팅 자동화
저는 앱 마케팅 워크플로우에 이걸 적용했어요. D:\마케팅\CLAUDE.md에 프로젝트 구조, 앱 정보, 마케팅 파이프라인 5단계를 정의해뒀더니, 이제 새 세션에서 "담임노트 카드뉴스 만들어줘"라고 하면 Claude가 폴더 구조를 알고, 스타일 규칙을 알고, 직전에 어떤 스타일을 썼는지도 알고 바로 제작에 들어가요.
마케팅 부서 하나를 컨텍스트 파일 몇 개로 만든 셈이에요. 실제 제작기가 궁금하다면 아래 관련 글을 참고하세요.
1인 개발자 관점에서
프롬프트 엔지니어링은 "AI에게 말 걸기"의 기술이에요. 초기에는 이게 전부처럼 보였어요. 근데 일을 점점 AI에게 맡기다 보니, 한 번 물어보고 끝나는 게 아니라 여러 세션에 걸쳐 이어지는 프로젝트를 AI와 함께 해야 하는 상황이 생겼어요.
그때 깨달은 거예요. AI가 잘 일하려면 프롬프트가 아니라 AI가 보는 세계 자체를 설계해야 한다는 걸. 컨텍스트 엔지니어링은 거창한 개념이 아니라, 그냥 "AI한테 맥락을 제대로 줘라"는 얘기예요.
파일 두 개로 시작해보세요. 생각보다 빠르게 체감됩니다.
실측 위주 AI 뉴스레터 — 직접 돌려보고 되는 것만 골라 매주 보내드립니다.