프롬프트 엔지니어링은 마법이 아닙니다. 구조와 맥락을 성실히 전달하는 기술입니다. 같은 Claude, 같은 GPT를 써도 출력이 눈에 띄게 다른 이유는 대부분 프롬프트 설계의 차이에 있습니다. 매일 업무에 쓰는 10가지 기법을 체크리스트 형태로 정리했습니다. 하루 실전에서 바로 적용할 수 있는 것들 위주입니다.
기본 구조 — 4요소 템플릿
- 역할을 한 줄로 고정. 예: "당신은 시니어 백엔드 엔지니어입니다."
- 목표를 구체화. "이 API의 에러 처리를 중앙화하는 설계를 제안해주세요."
- 제약을 명시. "FastAPI, Python 3.10, 기존 미들웨어 유지."
- 출력 형식을 지정. "코드 먼저, 이후 2~3줄 요약."
이 네 가지를 한 번이라도 명시적으로 쓰면, 같은 질문이어도 결과물의 일관성이 즉시 올라갑니다.
맥락 제공 — "무엇을 이미 알고 있어야 하는가"
- 관련 파일을 먼저 읽히기. Claude Code면
@filename으로 참조. - 실패 로그·에러 메시지는 전문 그대로 첨부. 요약해서 넣으면 AI가 원인을 놓칩니다.
- 비즈니스 제약은 "왜"까지 짧게 설명. "법적 요건으로 A가 B보다 먼저 처리되어야 함"처럼.
반복 기법 — 수렴 속도 올리기
- 한 번에 맞추려 하지 말고, 초안 → 피드백 → 수정 3회 안에 수렴.
- "직전 답변의 3번 문단을 더 구체화"처럼 증분 지시. 전체를 다시 쓰게 하지 말고 특정 부분만 손보게 유도.
- 막히면 "이 접근의 약점은 무엇인가?"로 되물어 AI가 자기 검증하게 만들기.
출력 형식 — JSON·마크다운·체크리스트 활용
개발 자동화 시나리오에서 가장 빠지기 쉬운 함정이 "출력이 매번 다른 모양"입니다. 해결책은 단순합니다.
- 파싱이 필요한 출력은 JSON 스키마를 예시로 박아두기.
- 보고서·분석 출력은 고정된 마크다운 템플릿 지정.
- 체크리스트가 필요하면 "반드시 10개 체크박스 형식"을 명시.
평가 기준 — AI에게 자기 검증 시키기
결과물이 나오면 "이 코드/문서가 실무에 나갔을 때 물을 수 있는 질문 5개를 생성해줘"라고 되묻습니다. 그 질문에 스스로 답하게 하면 빈틈이 드러납니다. 이 기법 하나로 품질이 체감상 20~30% 올라간다는 게 제 경험입니다.
하지 말 것 — 자주 하는 실수
- "잘 만들어줘" 같은 추상 지시 — 평가 기준이 없어 결과가 평범해집니다.
- 시스템 프롬프트와 사용자 프롬프트 뒤섞기 — Claude API 사용 시
system필드 별도 활용. - 반복되는 맥락을 매번 복붙 — 프로젝트 규칙 파일(
CLAUDE.md,.cursorrules)로 고정. - 과도한 예시 — few-shot 3개 이상은 오히려 혼란. 좋은 예시 1~2개가 더 효과적.
고급 — 에이전트 시나리오에서의 프롬프트
에이전트 루프(Claude Code 같은 다단계 작업)에서는 기본 프롬프트 외에 두 가지가 더 중요합니다.
- 중단 조건: 언제 작업을 멈추고 사용자에게 확인받을지. "파일 20개 이상 수정 전에는 반드시 승인 요청".
- 실패 복구 지시: 테스트 실패 시 어떻게 행동할지. "3번 재시도 후에도 실패하면 분석 후 중단".
팀에 정착시키는 간단한 방법
각자 개인 노트에 "효과 있었던 프롬프트 5개"를 모아두는 것만으로 팀의 프롬프트 품질이 올라갑니다. 주 1회 5분, 팀 채팅에 한 명씩 공유하는 의식을 만들어 보세요. 두 달이면 팀만의 프롬프트 라이브러리가 자연스럽게 생깁니다.
핵심은 한 가지 — AI에게 요구하는 만큼의 명료함이 자기 머릿속에도 있어야 합니다. 프롬프트가 안 떠오른다는 건 아직 문제 정의가 덜 됐다는 신호입니다.