checklist

체크리스트 — 5원칙

프롬프트를 머지하기 전에 5개 ✓ 모두 통과해야 한다.

1) 명확성

• 동사가 구체적인가 (“리뷰”, “요약” 같은 막연한 단어 단독 사용 X)
• 출력 형식(JSON / 표 / 글머리표 / 자유 텍스트)이 지정됨
• 길이·톤·금지사항 명시
• 옆 동료가 그대로 따라 할 수 있는가 (Anthropic 황금률)

2) 맥락

• Why-맥락(왜 하는가, 누가 읽는가) 한 문장 이상
• What-맥락(도메인 용어, 스키마, 컨벤션) 명시
• 실패 시 무엇이 깨지는지 적었는가

3) 예시

• 최소 1개의 입출력 쌍 또는 톤 예시
• 예시가 실제 사용 사례와 유사한가
• 에지 케이스 1개 이상 포함

4) 구조

• 지시·자료·예시·출력 형식이 시각적으로 분리됨 (XML 또는 명확한 헤더)
• 자료와 지시의 경계가 모호하지 않은가

5) 평가 루프

• 회귀 테스트 입력 5개 이상 준비
• 성공 기준이 사람이 채점 가능한가, 또는 자동화 가능한가
• 변경 전후 점수를 기록할 곳이 있는가