핵심 정리
역할
성공 기준
입력 맥락
예시
출력 형식프롬프트 구성
성공 기준을 먼저 정해야 프롬프트를 개선할 수 있는 이유
Anthropic의 프롬프트 가이드는 "성공 기준이 무엇인지"를 먼저 분명히 하라고 강조합니다. 프롬프트를 고치기 전에 무엇을 잘한 것으로 볼지 정하지 않으면, 결과를 개선해도 품질 판단이 흔들리기 쉽습니다. 성공 기준이 명확하면 이후 예시 추가, 형식 조정, 맥락 보강이 모두 그 기준을 향해 수렴하게 됩니다.
프롬프트 다섯 요소를 분리해야 디버깅이 쉬운 이유
Claude 프롬프트의 기본 뼈대는 역할, 작업 목표, 필요한 맥락, 예시, 출력 형식입니다. 이 다섯 가지가 분리되어 있을수록 답변이 더 안정적이고 디버깅도 쉬워집니다. 반대로 이 요소들이 한 덩어리로 섞여 있으면, 결과가 나빴을 때 어느 부분이 문제인지 파악하기 어렵습니다. 반복 규칙은 instruction으로, 작업마다 바뀌는 입력은 context로, 원하는 결과물 모양은 format으로 나누는 편이 읽기도 수정하기도 쉽습니다.
역할
-> 누구처럼 답할지
성공 기준
-> 무엇이 잘된 답인지
입력 맥락
-> 이번 작업에만 필요한 자료
예시
-> 따라야 할 패턴
출력 형식
-> 결과 모양너는 기술 편집자다.
목표는 초안을 대학 수준의 설명으로 다듬는 것이다.
아래 원문을 기준으로,
1. 개념 정의
2. 핵심 차이
3. 흔한 오해
순서로 정리하라.
출력은 Markdown bullet 5개 이내로 작성하라.설명을 길게 쓰는 것보다 예시가 더 강한 이유
예시는 특히 강력합니다. 구조화된 출력, 특정 톤, 애매한 판정 기준이 있을 때는 설명만 길게 쓰는 것보다 3~5개의 좋은 예시가 더 큰 효과를 냅니다. Claude는 예시에서 패턴을 직접 추론하기 때문에, "이런 형태로 써줘"라고 설명하는 것보다 실제 예시 하나가 더 정확한 출력을 유도합니다. 판단 기준이 미묘하거나 형식이 복잡할수록 예시의 효과는 커집니다.
맥락을 길게 넣는 것이 항상 좋지 않은 이유
맥락을 너무 길게 넣는다고 항상 좋아지지는 않습니다. 관련 없는 배경 정보가 많아지면 핵심 지시가 묻힐 수 있고, 맥락이 서로 충돌하면 Claude가 잘못된 우선순위로 판단하기도 합니다. 작업마다 꼭 필요한 맥락만 선별해 넣고, 재사용되는 규칙은 project instructions나 CLAUDE.md로 분리해 두는 편이 더 일관된 결과를 냅니다.
무엇을 더 보강할까
| 상황 | 적합한 선택 |
|---|---|
| 판단 기준을 정하지 않은 프롬프트 개선 | 성공 기준부터 먼저 정의 |
| 결과가 나빠도 원인 파악이 안 될 때 | 5요소(역할·기준·맥락·예시·형식) 분리 |
| 형식이나 톤 지정이 잘 안 먹힐 때 | 설명 대신 구체적 예시 3~5개 추가 |
| 맥락이 너무 길어졌을 때 | 반복 규칙은 instructions로 분리 |
| 입력 자료 자체가 비어 있을 때 | 성공 기준을 다듬기보다 필요한 자료를 먼저 다시 요청 |
| 출력 형식이 들쭉날쭉할 때 | format 섹션을 별도로 명시 |
| 결과는 괜찮은데 이유를 모르겠을 때 | 5요소 중 어느 축을 바꿨는지 분리해서 실험 |
주의할 점
프롬프트가 길다고 좋은 것은 아닙니다. 역할, 기준, 예시, 형식이 서로 섞여 있으면 오히려 디버깅이 어려워집니다. 같은 정보를 늘리기보다, 각 부분의 역할을 분리해 쓰는 편이 더 강합니다. 맥락이 충돌하면 Claude가 잘못된 우선순위로 판단하므로 관련 없는 배경 정보는 제거하는 것이 낫습니다. 재사용 규칙과 이번 작업 입력을 한 문단에 섞어 두면, 나중에 무엇을 고쳐야 하는지 더 찾기 어려워집니다.
❌ "대충 잘 정리해줘. 참고로 독자는 초보자고,
출력은 표로 하고, 이 예시처럼 써 줘..."이런 한 덩어리 프롬프트는 무엇이 역할인지, 형식인지, 성공 기준인지 분리되지 않아 수정 포인트를 찾기 어렵습니다.
참고 링크
2 sources