본문 바로가기
C.W.K.
Stream
Lesson 01 of 10 · published

프롬프트 버전 관리 — 문자열이 아니라 Git

~14 min · production, versioning

Level 0수련생
0 XP0/100 lessons0/14 achievements
0/120 XP to next level120 XP to go0% complete

프롬프트도 소프트웨어야

프롬프트가 데이터베이스 한 행의 문자열, Notion 페이지, 코드 속 상수에만 있다면 차이 보기, 검토, 되돌리기 같은 기본 공학 도구를 포기한 거야. 2026년의 최소선은 소스 관리, 의미 버전, frontmatter 메타데이터, 운영이 읽는 버전 키야.

버전을 담는 모양

  • 프롬프트마다 파일 하나를 두고 <name>/v<n>.md<name>@<n>.prompt처럼 이름 붙여.
  • frontmatter에는 id, version, model, owner, last-eval-pass-date, 입출력 스키마를 적어.
  • 운영에서는 파일 이름 무늬로 찾지 말고 버전 키로 읽어.
  • 버전을 올릴 때 새 파일을 만들고 되돌릴 수 있게 옛 버전도 남겨.

버전이 열어주는 것

  • 변경 제안에서 문장 차이를 볼 수 있어.
  • 검토자가 앞뒤 맥락과 함께 변경을 읽어.
  • 버전 키만 바꾸면 곧장 되돌릴 수 있어.
  • A/B 시험도 “이 사용자는 v_new, 저 사용자는 v_old”로 나눌 수 있어.

Code

앞머리 정보가 있는 프롬프트·markdown
---
id: support.draft_reply
version: 8
model: claude-opus-4-7
owner: customer-experience
input_schema: schemas/support_input.json
output_schema: schemas/support_output.json
last_eval_pass: 2026-04-30
changelog: tightened refusal language for out-of-scope pricing
---

You are a support agent for ACME...

{{user_message}}

External links

Exercise

운영 프롬프트 하나를 코드 속 문자열에서 frontmatter가 있는 버전 파일로 옮겨봐. 운영이 버전 키로 읽게 하고 되돌리기가 실제로 작동하는지 확인해.

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.