Part 2. 프롬프트 엔지니어링 실전 (40분)
학습 목표
실제 프로젝트(“나의 AI 개발자 만들기”)에서 사용한 프롬프트를 분석하고, 주제를 변수화한 재사용 가능한 템플릿으로 만들어 어떤 프로젝트에도 적용할 수 있도록 한다.
변수 규칙
아래 템플릿에서 사용하는 변수:
{{주제}}— 구현하고자 하는 기능/시스템 (예: “Dwg Reader, Writer”, “PDF Parser”, “실시간 채팅 시스템”){{도구명}}— 참고할 기존 소프트웨어 (예: “Rhino”, “AutoCAD”, “Figma”){{기술스택}}— 프로젝트 고유 기술 요소 (예: “HmEG”, “FastAPI”, “React”)
[인간 작성] 먼저 컨텍스트 엔지니어링을 하기에 앞서 가장 쉽고도 빠른 프롬프트로 티키 타카 하면서 프롬프트를 쌓아 나가 봅시다! 가장 심플한 형태의 컨텍스트 엔지니어링 입니다.
-
AI 한테 코딩을 시키는게 아니라. 이 프로젝트를 수행하기 위한 개발자를 만들어 나가는 과정
-
1단계 원샷을 통해 도메인 진입- 마치 신입개발자한테 도메인 정보를 학습 시키는 과정
-
구현은 맨 마지막에 시킨다는 마음으로 절대 AI가 “000을 구현할까요?” 해도 속아 넘어가지 않는다.
-
최근에 llm모델에서는 CLAUDE.md, GEMINI.md , Agent.md 등을 기본적인 사항(최적화)만 넣는게 좋다고 한다. 나머지 디테일은 subAgent나 Skill 에 넣어주는 흐름이 있음
-
Muti Agent 로 코딩군단을 만드는 흐름도 있음
-
(COT)Chain of Thought는 Think 모델을 쓰면 필요없음.
-
많이 써보면서 AI 가 어떤 것인지 감을 잡을 수 있음.
1단계. 기술 조사 — “뭘 모르는지 먼저 파악하기”
프롬프트 템플릿
{{주제}}을(를) 만들어 보고 싶다. 일단 심도 있게 웹 조사를 하고
어떤 방법으로 할지 하나씩 agent를 만드는 작업을 해볼 수 있을까?
하나씩 조사해 보자. 무엇을 할지 메모리에 저장해라.
강의 내용
왜 이렇게 쓰는가?
이 프롬프트는 탐색적 조사(Exploratory Research) 패턴입니다. 핵심 구조는 세 가지입니다:
- 목표 선언 —
{{주제}}을 만들어 보고 싶다로 최종 의도를 명확히 밝힙니다. - 방법 위임 — “어떤 방법으로 할지”를 AI에게 맡겨 선택지를 넓힙니다.
- 기억 명령 — “메모리에 저장해라”로 후속 대화에서 맥락을 유지하게 합니다.
기법 포인트:
- “심도 있게 웹 조사”라는 표현은 AI가 표면적 답변이 아닌 다양한 대안을 비교하도록 유도합니다.
- “하나씩”이라는 단어가 AI의 출력을 구조화된 리스트 형태로 만들어 줍니다.
- 결과적으로 10개의 대안 기술조사 결과처럼, 여러 선택지를 비교 가능한 형태로 받을 수 있습니다.
기대 결과: 주제에 대한 N개의 구현 대안과 각각의 장단점 비교표
2단계. 고려사항 파악 — “함정을 미리 찾기”
프롬프트 템플릿
우리가 이러한 {{주제}}를 구현하는 과정에서
고려해야 할 점들은 무엇일까요?
강의 내용
왜 이렇게 쓰는가?
이 프롬프트는 리스크 사전 분석(Pre-mortem) 패턴입니다.
- “우리가” — AI를 팀원으로 포지셔닝합니다. “너”가 아닌 “우리”를 쓰면 AI가 더 책임감 있게, 실무적으로 답변합니다.
- “이러한” — 앞선 대화 맥락을 참조하게 합니다. 1단계에서 조사한 내용을 기반으로 고려사항을 도출합니다.
- 열린 질문 — “무엇일까요?”는 AI가 자체적으로 카테고리를 나눠 포괄적으로 답하도록 유도합니다.
기법 포인트:
- 이 단계를 건너뛰고 바로 구현에 들어가면 나중에 아키텍처를 뒤엎는 일이 생깁니다.
- AI는 라이선스 문제, 성능 병목, 호환성 이슈 등 사람이 놓치기 쉬운 항목을 체계적으로 짚어줍니다.
- 결과물은 이후 CLAUDE.md의 “구현 주의사항” 섹션으로 자연스럽게 연결됩니다.
기대 결과: 기술적, 법적, 운영적 고려사항의 구조화된 체크리스트
3단계. 프로젝트 설계서 작성 — “실행 전 청사진 만들기”
프롬프트 템플릿
위를 구현하기 위한 프로젝트를 셋업하려고 합니다.
지금 셋업을 하지 말고 {{주제}} 구현을 위한 CLAUDE.md를 작성해주세요.
강의 내용
왜 이렇게 쓰는가?
이 프롬프트는 실행 억제 + 설계 우선(Design Before Action) 패턴입니다. AI 코딩 에이전트와 작업할 때 가장 중요한 기법 중 하나입니다.
- “지금 셋업을 하지 말고” — AI가 바로 코드를 생성하는 것을 막습니다. 이 한 줄이 없으면 AI는 즉시
mkdir,npm init등을 실행합니다. - “CLAUDE.md를 작성해주세요” — 구체적인 산출물을 지정합니다. CLAUDE.md는 프로젝트의 “헌법”과 같은 역할을 합니다.
CLAUDE.md에 포함되어야 할 핵심 항목:
- 디렉토리 구조 — 현재 구조 + 확장 계획
- 개발 규칙 — 코딩 스타일, 패키지 관리, 테스트/린팅
- AI API 사용 규칙 — 모델 계층화, Prompt Caching, API 키 관리
- 공통 기술 스택 — 표준화된 도구 목록
- 워크플로우 — 조사 → 설계 → 구현 → 검증 → 문서화
- 구현 주의사항 — 환경 제약, MVP 전략 등
기법 포인트:
- “설계 먼저, 실행은 나중에”는 AI와 협업할 때 가장 효과적인 원칙입니다.
- CLAUDE.md가 잘 작성되면 이후 모든 에이전트가 이 문서를 읽고 일관된 방향으로 작업합니다.
기대 결과: 프로젝트 전체를 관장하는 설계 문서(CLAUDE.md)
4단계. 검증 질문 — “빠진 것 없는지 확인하기”
프롬프트 템플릿
{{확인하고 싶은 항목}}에 대한 것들이 들어 있나요?
강의 내용
왜 이렇게 쓰는가?
이 프롬프트는 검증(Verification) 패턴입니다. 짧지만 매우 중요합니다.
- 구체적 항목 지정 — “디렉토리 구조”, “에러 핸들링”, “테스트 전략” 등 확인하고 싶은 것을 명시합니다.
- Yes/No로 시작하는 답변 유도 — AI가 있는지 없는지 먼저 답하고, 없으면 보완안을 제시합니다.
기법 포인트:
- AI가 생성한 문서를 그대로 수용하지 않는 습관을 들이는 것이 핵심입니다.
- 한 번에 모든 것을 완벽하게 만들 수 없으므로, 반복적 검증이 품질을 높입니다.
- 이 패턴은 코드 리뷰, 문서 검토, 요구사항 확인 등 모든 영역에 적용 가능합니다.
기대 결과: 누락 항목 발견 및 즉시 보완
5단계. 멀티 에이전트 협업 설정 — “팀 운영 규칙 만들기”
프롬프트 템플릿
일을 여러 에이전트들이 나눠서 할 때, 어디까지 진행되고
무슨 일을 해야 하는지에 대한 내용들을 각각 PROGRESS.md와 PLAN.md에서
관리하도록 합시다. 그리고 새로 시작할 때 두 파일을 읽어서
내가 무슨 일을 해야 하는지 에이전트들이 알 수 있게 합시다.
이렇게 CLAUDE.md를 업데이트합시다.
강의 내용
왜 이렇게 쓰는가?
이 프롬프트는 멀티 에이전트 오케스트레이션(Multi-Agent Orchestration) 패턴입니다. AI 에이전트를 “팀”으로 운영할 때 필수적인 설정입니다.
- 역할 분담의 전제 — 여러 에이전트가 동시에 작업할 수 있다는 것을 전제로 합니다.
- 상태 공유 메커니즘 —
PROGRESS.md(현재 상태)와PLAN.md(해야 할 일)로 나누어 관리합니다. - 자기 인식 — “새로 시작할 때 두 파일을 읽어서”로 에이전트가 스스로 맥락을 파악하게 합니다.
두 파일의 역할:
| 파일 | 역할 | 비유 |
|---|---|---|
PROGRESS.md | 현재까지 완료된 작업, 진행 상황 | 일일 스탠드업 회의록 |
PLAN.md | 앞으로 해야 할 작업 목록과 우선순위 | 스프린트 백로그 |
기법 포인트:
- 이 구조가 없으면 새 에이전트 세션마다 처음부터 설명해야 합니다.
- “합시다”체를 사용해 AI와 합의하는 형태로 지시하면, AI가 구조를 더 주도적으로 설계합니다.
- CLAUDE.md에 이 규칙을 넣으면 모든 에이전트가 자동으로 이 프로토콜을 따릅니다.
기대 결과: 에이전트 간 작업 연속성을 보장하는 상태 관리 시스템
6단계. 도구 설계 — “어떤 무기가 필요한지 정하기”
프롬프트 템플릿
그러면 이제 이런 일들을 할 때 필요한 에이전트, 커맨드, 스킬들이
무엇이 있을지 고민해 보고, 아이디어들을 알려주세요.
강의 내용
왜 이렇게 쓰는가?
이 프롬프트는 도구 설계 브레인스토밍(Tooling Brainstorm) 패턴입니다.
- “이런 일들을” — 앞선 맥락(1~5단계)을 모두 참조하게 합니다.
- 세 가지 카테고리 제시 — 에이전트(자율 실행), 커맨드(단발 명령), 스킬(재사용 가능 모듈)로 나누어 생각하게 합니다.
- “아이디어들을 알려주세요” — 확정이 아닌 제안을 요청하여, 사용자가 선택권을 유지합니다.
Claude Code의 세 가지 확장 구조:
| 구분 | 설명 | 예시 |
|---|---|---|
| Agent | 복잡한 멀티스텝 작업을 자율적으로 수행 | 기술 조사 에이전트, 코드 리뷰 에이전트 |
| Command | 한 번의 호출로 특정 작업 수행 (/명령어) | /setup-project, /run-tests |
| Skill | 재사용 가능한 지식/절차 모듈 | 코드 스타일 가이드, 테스트 작성 패턴 |
기법 포인트:
- 구현 전에 “어떤 도구가 필요한가?”를 먼저 생각하는 것은 소프트웨어 설계의 기본입니다.
- AI에게 아이디어를 먼저 내게 하고, 그중 필요한 것만 선택하는 것이 효율적입니다.
- 이 단계의 결과물이 7단계의 입력이 됩니다.
기대 결과: 프로젝트에 특화된 에이전트/커맨드/스킬 목록과 각각의 역할 설명
7단계. 도구 구현 — “실제로 만들기”
프롬프트 템플릿
그러면, Claude Code의 agent, command, skill 구조를 조사한 후,
그에 따라서 정확한 포맷을 지켜서 .claude 하위에
위에서 제안한 것들을 만들어 주세요.
강의 내용
왜 이렇게 쓰는가?
이 프롬프트는 조사 후 구현(Research-then-Implement) 패턴입니다.
- “구조를 조사한 후” — AI가 최신 문서/스펙을 먼저 확인하게 합니다. AI의 학습 데이터가 오래되었을 수 있으므로 중요합니다.
- “정확한 포맷을 지켜서” — 임의로 만들지 말고 공식 규격을 따르라는 품질 제약입니다.
- “.claude 하위에” — 정확한 출력 위치를 지정합니다.
기법 포인트:
- “조사 → 구현” 순서를 명시하면 AI가 잘못된 구조로 파일을 만드는 실수를 줄일 수 있습니다.
- 디렉토리를 지정함으로써 파일이 엉뚱한 곳에 생성되는 것을 방지합니다.
- 이 시점에서 AI는 1~6단계의 모든 맥락을 갖고 있으므로, 구체적이고 정확한 결과물을 생성할 수 있습니다.
기대 결과: .claude/ 디렉토리에 즉시 사용 가능한 에이전트/커맨드/스킬 파일들
핵심 원칙 정리 — “AI 개발자를 다루는 마인드셋”
원본 문서에서 명시한 세 가지 핵심 원칙을 템플릿화합니다:
원칙 1: 병렬 에이전트 활용
이 작업들을 병렬로 처리할 수 있도록
에이전트들을 나누어 동시에 실행해 주세요.
강의 내용
순차 실행이 아닌 병렬 실행을 지시하면 작업 시간을 대폭 단축할 수 있습니다. 예: 기술 조사 에이전트 + 샘플 코드 분석 에이전트를 동시에 실행.
원칙 2: AI를 개발자로 대하기
당신은 {{주제}} 전문 개발자입니다.
스스로 판단하고 최선의 구현 방법을 선택해서 진행하세요.
강의 내용
AI에게 “도구”가 아닌 “동료 개발자” 역할을 부여하면, 더 주도적이고 맥락을 고려한 결과물을 얻을 수 있습니다. 수동적 응답이 아닌 능동적 제안을 이끌어내는 핵심 기법입니다.
원칙 3: 직접 손대지 않기
내가 최대한 직접 작업물에 손을 대지 않도록
설명하거나 예시를 던져줘서 작업할 수 있도록 도와주어야 합니다.
강의 내용
AI 코딩 에이전트 활용의 궁극적 목표입니다. 사람은 방향을 지시하고 검증하는 역할, AI는 실행하는 역할. 코드에 직접 손을 대는 순간 AI의 맥락이 깨질 수 있으므로, 가능하면 프롬프트로 수정을 지시합니다.
전체 워크플로우 요약
| 순서 | 단계 | 프롬프트 패턴 |
|---|---|---|
| ① | 기술 조사 | 탐색적 조사 패턴 |
| ↓ | ||
| ② | 고려사항 파악 | 리스크 사전 분석 패턴 |
| ↓ | ||
| ③ | 설계서 작성 | 실행 억제 + 설계 우선 패턴 |
| ↓ | ||
| ④ | 검증 질문 | 검증 패턴 |
| ↓ | ||
| ⑤ | 협업 설정 | 멀티 에이전트 오케스트레이션 |
| ↓ | ||
| ⑥ | 도구 설계 | 도구 설계 브레인스토밍 |
| ↓ | ||
| ⑦ | 도구 구현 | 조사 후 구현 패턴 |
핵심 메시지
프롬프트 엔지니어링은 “한 번에 완벽한 프롬프트를 쓰는 것”이 아니라, 단계별로 맥락을 쌓아가며 AI와 대화하는 것입니다. 각 단계의 결과물이 다음 단계의 입력이 되고, 이 연쇄가 결국 완성된 프로젝트로 이어집니다.
실습 과제
실습: 나만의 프로젝트에 7단계 적용하기
{{주제}}에 자신이 만들고 싶은 것을 넣고, 위 7단계를 순서대로 실행해 보세요.예시 주제:
- “사내 문서 검색 챗봇”
- “자동 회의록 요약 시스템”
- “Excel 데이터 시각화 대시보드”
- “레거시 코드 마이그레이션 도우미”
체크리스트:
- 1단계: 기술 조사 결과 N개 대안 확보
- 2단계: 고려사항 체크리스트 작성
- 3단계: CLAUDE.md 초안 생성
- 4단계: 최소 3가지 검증 질문 수행
- 5단계: PROGRESS.md + PLAN.md 구조 설정
- 6단계: 필요한 에이전트/커맨드/스킬 목록 정리
- 7단계: .claude/ 에 도구 파일 생성 완료