1 / 6
5강
MODULE 1 ⚡ 개발자 과정 핵심 과정

프롬프트 엔지니어링
— 개발자 버전

일반적인 프롬프트 팁은 이미 알고 있을 겁니다. 이 모듈은 코드 생성에 특화된 프롬프트 전략입니다.
컨텍스트 설계, 반복 개선, 멀티파일 작업 지시까지 — 개발자 전용 기술을 다룹니다.

이 모듈에서 배울 것

LECTURE 1-1

코드 생성 프롬프트의 원칙

"함수 만들어줘"와 "TypeScript로 입력값을 검증하는 순수 함수 만들어줘, 에러는 throw 대신 Result 타입으로 반환해"는 완전히 다른 결과를 냅니다. 언어, 스타일, 제약 조건, 출력 형식을 명시하는 코드 전용 프롬프트 구조를 배웁니다.

💡

핵심 포인트 — 좋은 코드 프롬프트는 언어 + 패턴 + 제약 + 예시 4요소를 갖춥니다. AI에게 코드 스타일 가이드를 첨부하면 컨벤션이 자동으로 맞춰집니다.

⌨️ Claude Code 터미널에 입력

vibelab 폴더에서 claude 실행 후 붙여넣으세요

언어: [TypeScript / Python / Go 등]
패턴: [함수형 / 클래스 기반 / 훅 등]
제약: [에러 처리 방식, 외부 라이브러리 사용 여부, 최대 줄 수]
테스트: [Jest / pytest 등으로 테스트 코드도 함께 작성]

위 조건으로 [기능 설명]을 구현해줘.
입력: [타입과 예시], 출력: [타입과 예시]
LECTURE 1-2

컨텍스트 설계 — CLAUDE.md 작성법

CLAUDE.md는 클로드 코드가 프로젝트를 열 때마다 자동으로 읽는 파일입니다. 프로젝트 구조 설명, 코딩 컨벤션, 금지 패턴, 자주 쓰는 명령어를 담는 방법과 실제 프로젝트 유형별 CLAUDE.md 템플릿을 제공합니다.

💡

핵심 포인트 — CLAUDE.md를 잘 쓰면 매 대화의 첫 3~5턴을 생략할 수 있습니다. "이 프로젝트는 Next.js 14 App Router를 씁니다"를 한 번만 쓰면 됩니다.

⌨️ Claude Code 터미널에 입력

vibelab 폴더에서 claude 실행 후 붙여넣으세요

내 프로젝트 루트에 있는 파일들을 읽고
아래 섹션이 포함된 CLAUDE.md를 생성해줘:

## 프로젝트 개요
## 기술 스택 및 버전
## 디렉토리 구조 설명
## 코딩 컨벤션 (네이밍, 에러 처리, 스타일)
## 절대 수정하면 안 되는 파일/영역
## 자주 쓰는 명령어
## 현재 작업 중인 것들 (WIP)
LECTURE 1-3

반복 개선 루프 (Iterative Prompting)

한 번의 완벽한 프롬프트를 추구하는 것은 시간 낭비입니다. 빠르게 초안을 뽑고, 구체적인 수정 지시로 정제하는 반복 개선 패턴이 실전에서 훨씬 빠릅니다. "이거 틀렸어" 대신 "X 부분을 Y 방식으로 바꿔줘" — 효과적인 수정 지시법을 배웁니다.

💡

핵심 포인트 — 수정 요청은 범위 + 이유 + 기대값으로 구성하세요. "성능이 느려" 대신 "getUserById 함수가 매 호출마다 DB를 조회해 — 캐싱 레이어 추가해줘"가 훨씬 효과적입니다.

⌨️ Claude Code 터미널에 입력

vibelab 폴더에서 claude 실행 후 붙여넣으세요

방금 작성한 [함수/컴포넌트/모듈] 코드를 아래 기준으로 개선해줘.

변경 범위: [어떤 부분]
변경 이유: [왜 바꿔야 하는지]
기대하는 결과: [어떻게 동작해야 하는지]
유지해야 할 것: [바꾸면 안 되는 부분]
LECTURE 1-4

멀티파일 작업 지시하기

실제 기능 추가는 단일 파일로 끝나지 않습니다. 라우터, 컨트롤러, 서비스, 테스트 파일 — 여러 파일에 걸친 변경을 AI에게 한 번에 지시하는 방법을 배웁니다. 어떤 파일을 함께 제공해야 하는지, 변경 순서를 어떻게 지정하는지도 다룹니다.

💡

핵심 포인트 — 멀티파일 작업을 지시할 때는 변경 파일 목록을 먼저 확인받으세요. "어떤 파일을 수정할 건지 먼저 나열해줘, 동의하면 진행해"가 실수를 막는 가장 효과적인 방법입니다.

⌨️ Claude Code 터미널에 입력

vibelab 폴더에서 claude 실행 후 붙여넣으세요

[기능 설명]을 추가하려고 해.

구현 전에 먼저:
1. 수정이 필요한 파일 목록을 나열해줘
2. 각 파일에서 무엇을 바꾸는지 한 줄로 설명해줘
3. 새로 생성할 파일이 있으면 알려줘

목록을 확인하면 "진행해줘"라고 할게.
LECTURE 1-5

오류 디버깅을 AI에게 위임하기

스택 트레이스, 타입 에러, 런타임 오류 — 디버깅을 AI에게 넘기는 방법을 배웁니다. 에러 메시지만 붙여넣는 것과, 재현 조건 + 코드 + 에러를 함께 제공하는 것의 차이. AI가 틀린 진단을 할 때 올바른 방향으로 유도하는 방법도 다룹니다.

💡

핵심 포인트 — 디버깅 요청의 황금 공식: 에러 전문 + 관련 코드 + "내가 기대한 동작" + "실제 동작". 이 4가지를 함께 주면 AI의 첫 번째 진단 정확도가 크게 올라갑니다.

⌨️ Claude Code 터미널에 입력

vibelab 폴더에서 claude 실행 후 붙여넣으세요

아래 오류를 디버깅해줘.

에러 메시지:
[전체 스택 트레이스 붙여넣기]

관련 코드:
[오류가 발생하는 함수/컴포넌트]

기대한 동작: [무엇을 하려고 했는지]
실제 동작: [무슨 일이 일어나는지]
재현 조건: [어떤 상황에서 발생하는지]

원인 분석과 수정 방법을 알려줘.
← 이전: MODULE 0 마인드셋 전환 다음 모듈: 코드베이스 장악하기 →