권장 파일 구조 예시
버전 정책
| 변경 유형 | 예시 | 버전 |
|---|---|---|
| 패치 | 오탈자/명확성 개선 | x.y.Z |
| 마이너 | 출력 형식/지시 추가 | x.Y.z |
| 메이저 | 역할 재설계, 정책 변경 | X.y.z |
PR 체크리스트
- 변경 목적이 명확한가
- 기대 효과와 리스크가 적혀 있는가
- 관련 평가셋 회귀 테스트를 통과했는가
- 롤백 버전이 명시되어 있는가
실무 적용 체크리스트
- 이 문서의 규칙을 실제 서비스 플로우에 매핑했습니다.
- 측정 지표와 실패 임계값을 숫자로 정의했습니다.
- 변경 전/후를 비교할 기준 데이터셋 또는 로그를 준비했습니다.
- 팀 내 공유 문서(런북/가이드)에 반영했습니다.
자주 나는 실수
- 기준 지표 없이 개선을 선언합니다.
- 한 번에 여러 변수를 바꿔 원인 추적이 불가능해집니다.
- 롤백 조건 없이 배포해 장애 복구가 늦어집니다.
다음 문서
다음: A/B 테스트와 롤아웃
학습 흐름을 이어서 진행합니다.
릴리즈 노트 최소 항목
- 변경 목적
- 기대 효과
- 리스크와 롤백 조건
- 관련 평가셋 결과
Langfuse Prompt 버전 운영 절차
1) Prompt 목록에서 대상 프롬프트를 선택합니다
- 버전 수, 태그, 최신 변경 시간을 기준으로 점검합니다.
- 운영 대상 프롬프트는 이름 규칙(도메인/기능/환경)을 고정합니다.
2) 버전 상세에서 라벨을 확인합니다
production,candidate라벨을 분리합니다.- 변경된 system/user 메시지와 변수 스키마를 함께 검토합니다.
