03강: 프롬프트 엔지니어링 기초: IT 논리 구조를 반영한 지시 기법

SECTION 1. IT 실무 최적화: 왜 클로드인가? (입문)
 
• 01강: 챗GPT 대신 클로드를 선택해야 하는 이유 (아티팩트 & 20만 컨텍스트)
• 02강: IT 현업을 위한 초기 세팅: 프로젝트(Projects) 기능을 통한 도메인 지식 주입
• 03강: 프롬프트 엔지니어링 기초: IT 논리 구조를 반영한 지시 기법

SECTION 2. QA & 테스터를 위한 AI 전략 (심화)
 
• 04강: [QA] 요구사항 명세서 기반 완벽한 테스트 케이스(TC) 자동 생성
• 05강: [QA] 복잡한 데이터 흐름 분석 및 경계값 테스트 시나리오 도출
• 06강: [QA] 셀레늄/플레이라이트(Playwright) 자동화 스크립트 작성 및 오류 수정

SECTION 3. 개발 & 시스템 설계를 위한 AI 활용 (심화)
 
• 07강: [Dev] 레거시 코드 리팩토링 및 신규 라이브러리 마이그레이션 가이드
• 08강: [Dev] 에러 로그 분석을 통한 근본 원인(Root Cause) 파악 및 디버깅
• 09강: [Design] 머메이드(Mermaid)를 활용한 시퀀스 다이어그램 및 DB 설계도 그리기

SECTION 4. MCP와 자동화 에이전트로 가는 길 (실전)
 
• 10강: MCP(Model Context Protocol) 개념과 IT 도구(Notion/GitHub/Jira) 연동
• 11강: Sequential Thinking(심층 사고) 모드로 복잡한 비즈니스 로직 검증하기
• 12강: 클로드 코드(Claude Code) 입문: 터미널에서 제어하는 AI 주도 개발(ADC)

 

---

 

 

같은 도구, 다른 결과. 이번 글은 그 간격이 어디서 벌어지는지를 IT 실무자의 시선으로 들여다봅니다. 한 번 감을 잡으면 다시는 막연하게 질문하지 않게 됩니다.

 

옆자리 동료와 똑같은 클로드를 씁니다. 그런데 결과물의 질이 다릅니다.

 

누구는 한 번에 쓸 만한 코드를 받아내고, 누구는 열 번을 다시 물어도 영 엉뚱한 답만 돌아옵니다.

 

도구가 다른 게 아닙니다. 건네는 '말'이 다를 뿐입니다.

 

오늘은 그 말을 설계하는 법, 흔히 프롬프트 엔지니어링이라 부르는 기술을 다룹니다.

 

이름은 거창하지만 겁먹을 필요는 없습니다. IT 실무자라면 이미 절반은 몸에 배어 있는 사고방식이니까요.

 

 

천재 전학생은 똑똑해도, 우리 반 시간표는 모른다

클로드를 처음 쓰는 사람들이 가장 크게 착각하는 지점이 있습니다.

 

"똑똑하니까 알아서 다 해주겠지"라는 기대입니다.

 

클로드를 우리 반에 막 온 천재 전학생이라고 생각해 보세요.

 

전 과목 만점일 만큼 아는 건 많습니다.

 

하지만 우리 반 시간표도, 담임 선생님 이름도, 어제 무슨 일이 있었는지도 모릅니다. 오늘 처음 왔으니까요.

 

클로드도 똑같습니다.

 

세상의 일반적인 지식은 방대하게 갖췄지만, 당신의 회사 사정, 그 프로젝트의 코드 구조, 지난주 회의에서 정한 규칙은 전혀 모릅니다.

 

그래서 프롬프트의 본질은 결국 하나입니다.

 

똑똑한 전학생에게 우리 반 사정을 빠짐없이 건네주는 일입니다.

 

"로그인 코드 짜줘" 한 줄로 끝내면, 전학생은 자기가 아는 가장 흔한 방식대로 대충 만들어 옵니다.

 

우리 프로젝트가 쓰는 언어도, 보안 규칙도 모르니 당연한 결과입니다.

 

 

잘 짜인 지시문은 잘 짜인 코드와 닮았다

 

여기서 IT 실무자만의 강점이 나옵니다.

 

좋은 프롬프트의 구조가, 우리가 매일 쓰는 함수나 명세서와 거의 똑같이 생겼기 때문입니다.

 

함수를 떠올려 보세요.

 

입력값을 받고, 정해진 로직으로 처리하고, 약속된 형태로 결과를 돌려줍니다.

 

좋은 지시문도 정확히 이 흐름을 따릅니다.

 

 

먼저, '누구'에게 맡길지부터 정해 준다

연극에서 배우에게 배역을 정해 주듯, 클로드에게도 역할을 먼저 지정합니다.

 

"너는 10년 차 백엔드 개발자야"라고 한 문장 던져 두는 것만으로 답변의 깊이와 말투가 달라집니다.

 

같은 질문이라도 신입의 답과 시니어의 답이 다른 것과 같은 이치입니다.

 

이어서, '재료'를 빠짐없이 건넨다

요리사에게 "맛있는 거 해줘"라고만 하면 냉장고에 뭐가 있는지 몰라 헤맵니다.

 

어떤 재료가 있고, 알레르기는 무엇이고, 몇 인분인지 알려줘야 제대로 된 요리가 나옵니다.

 

코드의 일부, 에러 메시지 전문, 지켜야 할 사내 규칙. 이런 맥락이 곧 재료입니다.

 

충분히 줄수록 결과가 정교해집니다.

 

특히, 결과물의 '모양'을 미리 못 박는다

개인적으로 가장 효과가 큰데도 사람들이 자주 빼먹는 부분이 바로 이 출력 형식 지정입니다.

 

거스름돈을 받을 때 동전으로 줄지 지폐로 줄지 미리 말하는 것과 같습니다.

 

함수의 반환 타입을 정하듯, 결과물의 형태를 먼저 정해 주는 셈입니다.

 

"표로 정리해 줘", "주석을 단 코드 블록으로만 줘", "세 문장 이내로 요약해 줘"처럼요.

 

형식을 지정하는 순간 다듬는 시간이 확 줄어듭니다.

 

[역할] 너는 보안에 깐깐한 시니어 백엔드 개발자야.
[맥락] 우리 서비스는 파이썬 FastAPI를 쓰고, 비밀번호는 해싱해서 저장해.
[작업] 이메일 로그인 API의 뼈대 코드를 작성해 줘.
[형식] 함수별로 주석을 단 코드 블록 하나로만 줘.

 

"로그인 코드 짜줘"와 위 지시문은 들이는 수고는 비슷하지만, 돌아오는 결과의 완성도는 비교가 되지 않습니다.

 

복잡할수록 쪼개고, 예시 한 장이 설명 백 마디를 이긴다

기본 골격을 익혔다면, 결과를 한 단계 더 끌어올리는 감각이 두 가지 더 있습니다.

 

한꺼번에 다 시키지 않고, 생각의 순서를 정해 준다

라면을 끓일 때 "알아서 맛있게"라고 하면 결과가 들쭉날쭉합니다.

 

물 양과 면을 넣는 순서를 정해 주면 늘 같은 맛이 나옵니다.

 

복잡한 로직을 맡길 때도 마찬가지입니다.

 

"먼저 요구사항을 정리하고, 그다음 설계를 잡고, 마지막에 코드를 써 줘"처럼 사고의 단계를 끊어 주면, 클로드가 중간에 길을 잃지 않습니다.

 

 

말로 설명하기 어려우면, 정답지를 한 장 보여 준다

수학 문제집의 예제가 떠오르는 대목입니다.

 

풀이가 달린 예제 한 문제를 보고 나면, 비슷한 문제는 알아서 풉니다.

 

원하는 결과물의 샘플을 단 하나만 보여 줘도, 클로드는 그 형식과 톤을 정확히 흉내 냅니다.

 

길게 설명하기 애매한 요청일수록 이 한 장의 예시가 강력합니다.

 

덧붙이면, 여러 종류의 정보를 한꺼번에 넘길 때는 칸막이 도시락처럼 구역을 나눠 주는 게 좋습니다.

 

이사 갈 때 상자마다 '주방', '책'이라고 이름표를 붙이는 것과 같습니다.

 

클로드는 특히 이렇게 꺾쇠 표시로 묶어 이름표를 달아 주는 방식을 잘 알아듣습니다.

 

코드와 질문이 한데 뒤섞이지 않으니 오해가 줄어듭니다.

 

<코드>
여기에 검토할 코드를 넣는다
</코드>

<요청>
위 코드에서 보안 취약점만 짚어 줘
</요청>

 

 

프롬프트는 결국, 머릿속 논리를 글로 옮기는 일이다

여기까지 따라왔다면 한 가지가 분명해졌을 겁니다.

 

프롬프트 엔지니어링은 화려한 마법 주문을 외우는 기술이 아닙니다.

 

누구에게(역할), 무엇을 가지고(맥락), 어떤 순서로 처리해서(단계), 어떤 모양으로 내놓을지(형식)를 또렷하게 적는 일입니다.

 

곰곰이 보면 이건 우리가 동료에게 일을 넘길 때, 명세서를 쓸 때 이미 하던 사고 그대로입니다.

 

모호하게 던지면 모호하게 돌아오고, 논리적으로 건네면 논리적으로 돌아옵니다.

 

결국 클로드를 잘 다룬다는 건, 내 생각을 얼마나 또렷하게 정리해 글로 옮기느냐의 문제였습니다.

 

막연한 '잘해줘'를 졸업하는 순간, 같은 도구로도 전혀 다른 결과가 펼쳐집니다.

 

다음 04강 예고

기본기를 익혔으니, 이제 현업의 진짜 문제로 들어갑니다.

 

다음 SECTION 2는 QA와 테스터를 위한 시간입니다.

 

그 첫 시작인 04강에서는, 요구사항 명세서 한 장만 건네면 클로드가 빠짐없이 테스트 케이스(TC)를 뽑아내도록 만드는 법을 다룹니다.

 

하나하나 손으로 케이스를 적느라 야근하던 그 작업을, 어떻게 명세서 기반으로 자동화하는지 구체적인 지시문과 함께 보여 드리겠습니다.