📄 레슨

컨텍스트 엔지니어링 — 프롬프트의 후속

① 오늘의 미션

실력은 '문장'이 아니라 '환경 차리기'로 옮겨갔어요

예전엔 "마법 같은 프롬프트 한 줄"이 전부였어요. 이젠 AI가 일할 환경 전체를 잘 차려주는 게 진짜 실력 — 이걸 컨텍스트 엔지니어링이라 해요. 오늘은 '우리동네 반찬가게' 상품 상세 페이지를 만들며, 맥락을 곁들이느냐로 결과가 얼마나 갈리는지 손으로 봅니다.

지금까지 배운 CLAUDE.md·자료·계획이 다 여기 모여요. 우측 터미널에서 직접 차려 봅시다.

설명을 따라 진행하면, 여기서 직접 쳐보게 돼요 👇

~/my-shop

$ _

📚 「컨텍스트 엔지니어링 — 프롬프트의 후속」 레슨 내용 전체 텍스트로 훑어보기

실력은 '문장'이 아니라 '환경 차리기'로 옮겨갔어요

지금까지 배운 CLAUDE.md·자료·계획이 다 여기 모여요. 우측 터미널에서 직접 차려 봅시다.

예전엔 "프롬프트를 어떻게 쓸까"가 전부였어요. 가게를 잘 만들려는 지금, 더 중요해진 건?

맞아요. 이걸 컨텍스트 엔지니어링이라 불러요. 핵심이 '프롬프트 한 줄'에서 '환경 전체 설계'로 넘어간 거예요. 똑똑한 알바생도 매뉴얼·상품 자료·권한이 없으면 헤매듯, AI도 곁에 둔 맥락만큼 잘 만들어요. 👇

같은 "상품 상세 페이지 만들어줘"라도, 무엇을 곁에 차려줬느냐로 결과가 갈려요. 버튼으로 보세요.

✍️ 프롬프트만: "상품 상세 페이지 만들어줘"라는 멋진 문장 하나 → AI는 우리 가게·기존 디자인·상품 정보를 몰라 → 일반적인 껍데기.
문장만으론 한계가 있어요.

🌐 환경까지 차려줌: 같은 문장 + 가게 설명(CLAUDE.md) + 기존 상품 페이지 + 상품 사진·설명 자료를 곁에 둠 → 우리답고 구체적인 상세 페이지. ✅

먼저 맥락 없이 막 시켜볼게요. AI가 정보가 없어 헤매는 모습을 직접 봐요.

상품 상세 페이지 만들어줘 — 맥락 없이 — 일반적인 껍데기

정보가 없으니 빈 껍데기죠? AI 탓이 아니에요 — 우리가 차려준 게 없어서예요.

이번엔 가게 설명서·상품 사진·상품 데이터를 곁에 두고 같은 부탁을 하려고 해요. 결과가 어떻게 달라질까요?

맞아요. 좋은 맥락 = 좋은 결과. 곁에 둔 자료만큼 결과가 구체적이고 우리다워져요. 자료부터 준비해 직접 확인해 볼까요? 👇

맥락을 차린다는 건 거창한 게 아니에요. 참고할 자료를 가게 폴더에 같이 두는 것부터예요. 어떤 자료가 있는지 셸로 확인해요.

ls images/ products.json CLAUDE.md — 곁에 둘 자료 목록 확인 ($ 셸 명령)

설명서·상품 데이터·사진이 한 폴더에 모였어요. 이제 Claude에게 "이것들 참고해서"라고 가리키기만 하면 돼요.

이번엔 같은 부탁에 참고할 자료를 콕 집어 줘보세요. 결과가 완전히 달라져요.

CLAUDE.md랑 images/포기김치.jpg, products.json 참고해서 포기김치 상세 페이지 만들어줘 — 자료를 가리키며 요청

같은 문장인데 결과가 천지차이죠? 차이는 프롬프트가 아니라 곁에 차려준 맥락이었어요.

컨텍스트 엔지니어링은 사실 당신이 이미 배운 것들의 합이에요.

1️⃣ 설명서

CLAUDE.md로 우리 가게·규칙을 상시 제공. (지난 레슨)

2️⃣ 자료

참고할 상품 사진·기존 페이지·데이터를 my-shop 폴더에 같이 둠.

3️⃣ 도구

나중에 배울 MCP·커넥터로 주문 시트·결제 같은 손발을 연결.

곁에 둔 자료는 가리켜 줘야 써요. 빈칸을 채워, 자료를 가리키는 지시문을 완성하세요.

좋아요! "~ 참고해서"로 자료를 콕 집어주면, Claude가 그 사진·데이터를 실제로 읽고 반영해요. 차려두기 + 가리키기, 둘 다 있어야 맥락이 작동해요.

좋은 결과를 위해 맥락을 차리는 순서를 맞춰보세요. (↑↓로 정렬)

정확해요! 설명서 깔기 → 자료 두기 → 가리키기 → 맥락 보강. 프롬프트 문장을 고치기보다, 환경을 차리는 데 공을 들이는 게 진짜 실력이에요.

상세 페이지 결과가 영 우리답지 않게 나왔어요. 가장 먼저 의심할 것은?

맞아요. 결과가 약하면 십중팔구 맥락이 부족한 거예요. 문장을 다듬기보다, 무엇을 더 곁에 둘 수 있을까를 먼저 생각하세요.

한 줄로

요즘 AI로 가게를 잘 만드는 진짜 실력은 마법의 문장 찾기가 아니라 AI가 일할 환경을 잘 차려주는 것. 좋은 맥락 = 좋은 결과예요.

다음 레슨에서

그런데 맥락은 문서로만 주는 게 아니에요. 다음은 '폴더 구조도 컨텍스트다' — 정리된 폴더와 파일 이름이 곧 AI에게 주는 지도라는 걸 배웁니다. 🌱