핵심 표면

<examples>
  <example>
    <input>...</input>
    <output>...</output>
  </example>
</examples>

예시 설계

예시는 설명보다 출력 패턴을 더 직접적으로 고정한다

Claude에게 형식, 톤, 판정 기준을 설명하는 것도 중요하지만, 실제 예시는 원하는 결과를 더 직접적으로 보여 줍니다. 특히 분류, 요약, 리뷰, 문서 변환처럼 결과 모양이 중요한 작업에서는 좋은 예시 몇 개가 긴 설명보다 더 강합니다.

instruction:
  고객 피드백을 sentiment와 action으로 분류하라.

example:
  input: "배송은 빠른데 포장이 찢어졌어요."
  output: { "sentiment": "mixed", "action": "packaging_review" }

예시가 있으면 Claude가 "무엇을 맞춘 출력으로 볼지"를 직접 추론할 수 있습니다.

3~5개의 예시는 다양성과 일관성의 균형점이다

Anthropic의 프롬프트 가이드는 좋은 예시를 여러 개 넣는 방식을 권장합니다. 너무 적으면 패턴이 약하고, 너무 많으면 불필요한 세부 규칙까지 학습될 수 있습니다. 실무에서는 3~5개 정도로 시작하고, 실패 사례가 보이면 그 유형을 덮는 예시를 추가하는 방식이 관리하기 쉽습니다.

예시 1: 정상 케이스
예시 2: 경계값
예시 3: 애매한 표현
예시 4: 제외해야 할 케이스

예시는 많을수록 좋은 것이 아니라, 실제 입력 분포와 실패 지점을 대표해야 합니다.

좋은 예시는 relevant, diverse, clear를 만족한다

예시는 실제 사용 사례와 가까워야 하고, 서로 다른 케이스를 덮어야 하며, 입력과 출력이 명확히 분리되어야 합니다. 같은 형태의 쉬운 예시만 반복하면 Claude가 엉뚱한 표면 패턴을 따라갈 수 있습니다.

<example>
  <input>계정은 만들었는데 이메일 인증 링크가 안 와요.</input>
  <output>
    { "intent": "account_verification", "priority": "medium" }
  </output>
</example>

XML tag를 쓰면 예시와 실제 입력, 설명 문장이 섞이는 문제를 줄일 수 있습니다.

선택 기준

주의할 점

예시에 포함된 우연한 표현도 패턴으로 학습될 수 있습니다. 날짜, 이름, 코드, 말투가 모두 같은 예시만 넣으면 Claude가 그 표면 형식까지 따라 할 수 있으므로 필요한 차이만 남기고 불필요한 반복은 줄이는 편이 좋습니다.