Skip to main content
PromptQuorumPromptQuorum
Home/Prompt Engineering/ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™” ν…œν”Œλ¦Ώ: νŒ€μ„ μœ„ν•œ 6가지 μž¬μ‚¬μš© κ°€λŠ₯ν•œ ν˜•μ‹
νŒ€ κ±°λ²„λ„ŒμŠ€

ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™” ν…œν”Œλ¦Ώ: νŒ€μ„ μœ„ν•œ 6가지 μž¬μ‚¬μš© κ°€λŠ₯ν•œ ν˜•μ‹

Β·10λΆ„ 읽기·By Hans Kuepper Β· Founder of PromptQuorum, multi-model AI dispatch tool Β· PromptQuorum
μ–Έμ–΄ 선택:
πŸ‡ΊπŸ‡ΈenπŸ‡©πŸ‡ͺdeπŸ‡«πŸ‡·frπŸ‡―πŸ‡΅jaπŸ‡¨πŸ‡³zhπŸ‡ͺπŸ‡ΈesπŸ‡§πŸ‡·ptπŸ‡ΈπŸ‡¦arπŸ‡°πŸ‡·ko

λ¬Έμ„œν™”λ˜μ§€ μ•Šμ€ ν”„λ‘¬ν”„νŠΈλŠ” 쑰용히 κ³ μž₯ λ‚˜κ³ , 쀑볡 μž‘μ„±λ˜λ©°, 감사가 λΆˆκ°€λŠ₯ν•©λ‹ˆλ‹€. 6가지 μž¬μ‚¬μš© κ°€λŠ₯ν•œ λ¬Έμ„œν™” ν…œν”Œλ¦Ώμ΄ 단일 μ‚¬μš© ν•œ μ€„μ§œλ¦¬λΆ€ν„° κ²€ν†  이λ ₯이 μžˆλŠ” 버전 κ΄€λ¦¬λœ ν”„λ‘œλ•μ…˜ ν”„λ‘¬ν”„νŠΈκΉŒμ§€ λͺ¨λ“  ν”„λ‘¬ν”„νŠΈ 수λͺ… μ£ΌκΈ° 단계λ₯Ό λ‹€λ£Ήλ‹ˆλ‹€.

ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™”λŠ” ν”„λ‘¬ν”„νŠΈκ°€ 무엇을 ν•˜λŠ”μ§€, μ™œ κ·Έλ ‡κ²Œ μž‘μ„±λ˜μ—ˆλŠ”μ§€, μ–΄λ–€ ν…ŒμŠ€νŠΈλ₯Ό 톡과해야 ν•˜λŠ”μ§€μ— λŒ€ν•œ κ΅¬μ‘°ν™”λœ κΈ°λ‘μž…λ‹ˆλ‹€. 이것이 μ—†μœΌλ©΄ ν”„λ‘¬ν”„νŠΈλŠ” κ²€ν†  λΆˆκ°€λŠ₯ν•˜κ³ , λ‘€λ°± λΆˆκ°€λŠ₯ν•˜λ©°, μž‘μ„±μžκ°€ νŒ€μ„ λ– λ‚  λ•Œ μž¬ν˜„μ΄ λΆˆκ°€λŠ₯ν•©λ‹ˆλ‹€.

⚑ Quick Facts

  • Β·One-Liner CardλΆ€ν„° API Config BlockκΉŒμ§€ 전체 ν”„λ‘¬ν”„νŠΈ 수λͺ… μ£ΌκΈ°λ₯Ό λ‹€λ£¨λŠ” 6가지 ν…œν”Œλ¦Ώ
  • Β·One-Liner CardλŠ” 2λΆ„ 이내에 μž‘μ„± κ°€λŠ₯ν•˜λ©° κ°€μž₯ ν”ν•œ λ¬Έμ„œν™” μ‹€νŒ¨λ₯Ό μ˜ˆλ°©ν•©λ‹ˆλ‹€
  • Β·λ¬Έμ„œν™”λŠ” 별도 μ‹œμŠ€ν…œμ΄ μ•„λ‹Œ ν”„λ‘¬ν”„νŠΈμ™€ ν•¨κ»˜ μ €μž₯ν•˜μ„Έμš”
  • Β·"why" ν•„λ“œ(λ³€κ²½ 이유)λŠ” λͺ¨λ“  ν…œν”Œλ¦Ώμ—μ„œ κ°€μž₯ μ€‘μš”ν•œ ν•„λ“œμž…λ‹ˆλ‹€
  • Β·Version Block + Change Rationale은 λͺ¨λ“  ν”„λ‘œλ•μ…˜ ν”„λ‘¬ν”„νŠΈ μˆ˜μ •μ— ν•„μˆ˜μž…λ‹ˆλ‹€
  • Β·PromptHubλŠ” Version Block 및 API Config Block ν•„λ“œμ— 직접 λ§€ν•‘λ©λ‹ˆλ‹€

핡심 λ‚΄μš©

  • λͺ¨λ“  ν”„λ‘œλ•μ…˜ ν”„λ‘¬ν”„νŠΈλŠ” μ΅œμ†Œν•œ One-Liner Card(λͺ©μ , λͺ¨λΈ, λ‚ μ§œ, μž‘μ„±μž)κ°€ ν•„μš”ν•©λ‹ˆλ‹€
  • λͺ¨λ“  μˆ˜μ •λœ ν”„λ‘¬ν”„νŠΈλŠ” Version Block(λ³€κ²½ λ‚΄μš©, 이유, ν…ŒμŠ€νŠΈ κ²°κ³Ό)이 ν•„μš”ν•©λ‹ˆλ‹€
  • λͺ¨λ“  ν…ŒμŠ€νŠΈλœ ν”„λ‘¬ν”„νŠΈλŠ” Test Suite Header(톡과 κΈ°μ€€, 골든 예제, μ‹€νŒ¨ λͺ¨λ“œ)κ°€ ν•„μš”ν•©λ‹ˆλ‹€
  • λ¬Έμ„œν™”λ₯Ό ν”„λ‘¬ν”„νŠΈμ™€ λ™μΌν•œ μ‹œμŠ€ν…œμ— μ €μž₯ν•˜μ„Έμš” β€” 별도 λ¬Έμ„œλŠ” λ°©μΉ˜λ©λ‹ˆλ‹€
  • λ³€κ²½ 이유("why")κ°€ κ°€μž₯ μ€‘μš”ν•œ ν•„λ“œμž…λ‹ˆλ‹€: 이λ₯Ό κ±΄λ„ˆλ›°λŠ” νŒ€μ€ μž‘μ„±μžκ°€ λ– λ‚œ ν›„ 이전 νŒ¨ν„΄μœΌλ‘œ λ˜λŒμ•„κ°‘λ‹ˆλ‹€
  • PromptHubλŠ” κ°€μž₯ μ™„μ „ν•œ λ‚΄μž₯ λ¬Έμ„œν™” ꡬ쑰λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€; Git은 쒋은 컀밋 κ·œμœ¨μ„ κ°–μΆ˜ μ—”μ§€λ‹ˆμ–΄λ§ νŒ€μ— μ ν•©ν•©λ‹ˆλ‹€

λ¬Έμ„œν™”λ˜μ§€ μ•Šμ€ ν”„λ‘¬ν”„νŠΈκ°€ νŒ€μ„ λ§κ°€λœ¨λ¦¬λŠ” 이유

πŸ“ In One Sentence

λ¬Έμ„œν™”λ˜μ§€ μ•Šμ€ ν”„λ‘¬ν”„νŠΈλŠ” μ‘°μš©ν•œ νšŒκ·€, 쀑볡 μž‘μ„±, 지식 손싀을 톡해 νŒ€μ„ λ§κ°€λœ¨λ¦½λ‹ˆλ‹€ β€” 각각 ν”„λ‘¬ν”„νŠΈλ‹Ή 5~10λΆ„μ˜ λ¬Έμ„œν™”λ‘œ μ˜ˆλ°©ν•  수 μžˆμŠ΅λ‹ˆλ‹€.

πŸ’¬ In Plain Terms

ν”„λ‘¬ν”„νŠΈμ— 무엇을 ν•˜λŠ”μ§€ λ˜λŠ” μ™œ κ·Έλ ‡κ²Œ μž‘μ„±λ˜μ—ˆλŠ”μ§€μ— λŒ€ν•œ 기둝이 μ—†μœΌλ©΄, νŒ€μ€ μ•ˆμ „ν•˜κ²Œ λ³€κ²½ν•  수 μ—†κ³ , μˆ˜μ • ν›„ 볡ꡬ할 수 μ—†μœΌλ©°, μƒˆ νŒ€μ›μ—κ²Œ λ§₯락 없이 인계할 수 μ—†μŠ΅λ‹ˆλ‹€.

λ¬Έμ„œν™”λ˜μ§€ μ•Šμ€ ν”„λ‘¬ν”„νŠΈλŠ” μ„Έ 가지 λ°©μ‹μœΌλ‘œ νŒ€μ„ λ§κ°€λœ¨λ¦½λ‹ˆλ‹€: μ‘°μš©ν•œ νšŒκ·€(λ³€κ²½ 기둝 μ—†μŒ), 쀑볡(νŒ€μ΄ κΈ°μ‘΄ ν”„λ‘¬ν”„νŠΈλ₯Ό 찾지 λͺ»ν•΄ λ‹€μ‹œ μž‘μ„±), 지식 손싀(μž‘μ„±μžκ°€ λ– λ‚˜λ©΄ ν”„λ‘¬ν”„νŠΈλ₯Ό μœ μ§€ 관리할 수 μ—†μŒ). 각 μ‹€νŒ¨λŠ” ν”„λ‘¬ν”„νŠΈλ‹Ή 5~10λΆ„μ˜ λ¬Έμ„œν™”λ‘œ μ˜ˆλ°©ν•  수 μžˆμŠ΅λ‹ˆλ‹€.

κ°€μž₯ λΉ„μš©μ΄ 많이 λ“œλŠ” μ‹€νŒ¨λŠ” μ‘°μš©ν•œ νšŒκ·€μž…λ‹ˆλ‹€. νŒ€μ΄ ν•˜λ‚˜μ˜ 문제λ₯Ό μˆ˜μ •ν•˜κΈ° μœ„ν•΄ ν”„λ‘œλ•μ…˜ ν”„λ‘¬ν”„νŠΈλ₯Ό μˆ˜μ •ν–ˆλ‹€κ°€ μ˜λ„μΉ˜ μ•Šκ²Œ λ‹€λ₯Έ 문제λ₯Ό λ°œμƒμ‹œν‚€κ³ , 비ꡐ할 기쀀선이 μ—†μŠ΅λ‹ˆλ‹€. 버전 이λ ₯κ³Ό Test Suite Header μ—†μ΄λŠ” νšŒκ·€λ₯Ό μ§„λ‹¨ν•˜λ €λ©΄ μˆ˜λ™ 비ꡐ와 좔츑이 ν•„μš”ν•©λ‹ˆλ‹€.

ν•œ 번 이상 μ‚¬μš©λ˜κ±°λ‚˜, 곡유 인프라에 μ €μž₯λ˜κ±°λ‚˜, ν”„λ‘œλ•μ…˜μ— λ°°ν¬λ˜λŠ” λͺ¨λ“  ν”„λ‘¬ν”„νŠΈμ— λ¬Έμ„œν™”λ₯Ό μ‚¬μš©ν•˜μ„Έμš”. 단일 μ„Έμ…˜μ—μ„œ μ‚¬μš©ν•˜λŠ” μΌνšŒμ„± 탐색 ν”„λ‘¬ν”„νŠΈλŠ” κ±΄λ„ˆλ›°μ–΄λ„ λ©λ‹ˆλ‹€.

⚠️ μ‘°μš©ν•œ νšŒκ·€ μœ„ν—˜

Version Blockκ³Ό 골든 μ˜ˆμ œκ°€ μ—†μœΌλ©΄, ν”„λ‘œλ•μ…˜ ν”„λ‘¬ν”„νŠΈλ₯Ό μˆ˜μ •ν•˜λŠ” νŒ€μ—κ²ŒλŠ” 기쀀선이 μ—†μŠ΅λ‹ˆλ‹€. λͺ¨λ“  μˆ˜μ •μ€ 이전 μƒνƒœκ°€ μ–΄λ– ν–ˆλŠ”μ§€μ— λŒ€ν•œ μΆ”μΈ‘μž…λ‹ˆλ‹€.

6가지 ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™” ν…œν”Œλ¦Ώ

6가지 ν…œν”Œλ¦Ώμ΄ 첫 번째 μ΄ˆμ•ˆλΆ€ν„° ν”„λ‘œλ•μ…˜ νκΈ°κΉŒμ§€ 전체 ν”„λ‘¬ν”„νŠΈ 수λͺ… μ£ΌκΈ°λ₯Ό λ‹€λ£Ήλ‹ˆλ‹€. 각 ν…œν”Œλ¦Ώμ€ μ™„μ„±ν•˜λŠ” 데 10λΆ„ 이내가 걸리도둝 μ„€κ³„λ˜μ—ˆμœΌλ©°, 각 수λͺ… μ£ΌκΈ° 단계에 ν•„μš”ν•œ μ΅œμ†Œν•œμ˜ 정보λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€.

  1. 1
    One-Liner Card
    Why it matters: λͺ©μ : μž¬μ‚¬μš©λ˜λŠ” λͺ¨λ“  ν”„λ‘¬ν”„νŠΈμ— λŒ€ν•œ μ΅œμ†Œν•œμ˜ μ‹€ν–‰ κ°€λŠ₯ν•œ 기둝을 μΊ‘μ²˜ν•©λ‹ˆλ‹€. ν•„λ“œ: ν”„λ‘¬ν”„νŠΈ 이름, λͺ©μ (1λ¬Έμž₯), λŒ€μƒ λͺ¨λΈ, 생성 λ‚ μ§œ, μž‘μ„±μž. μ‚¬μš© μ‹œκΈ°: ν”„λ‘¬ν”„νŠΈκ°€ 처음 μ €μž₯될 λ•Œ. μ €μž₯: λͺ¨λ“  곡유 도ꡬ(Notion, Git, PromptHub).
  2. 2
    Version Block
    Why it matters: λͺ©μ : μ‹œκ°„μ΄ 지남에 따라 λ³€κ²½λ˜λŠ” ν”„λ‘¬ν”„νŠΈμ˜ 이λ ₯을 μΆ”μ ν•©λ‹ˆλ‹€. ν•„λ“œ: 버전 번호, μˆ˜μ • λ‚ μ§œ, μž‘μ„±μž, λ³€κ²½ λ‚΄μš©(1λ¬Έμž₯), λ³€κ²½ 이유(1λ¬Έμž₯), ν…ŒμŠ€νŠΈ κ²°κ³Ό μš”μ•½. μ‚¬μš© μ‹œκΈ°: ν”„λ‘¬ν”„νŠΈκ°€ μˆ˜μ •λ  λ•Œ. μ €μž₯: Git 컀밋 λ©”μ‹œμ§€ λ˜λŠ” PromptHub 버전 ν•­λͺ©.
  3. 3
    Test Suite Header
    Why it matters: λͺ©μ : ν…ŒμŠ€νŠΈ μž‘μ„± 전에 ν—ˆμš© 기쀀을 μ •μ˜ν•©λ‹ˆλ‹€. ν•„λ“œ: ν…ŒμŠ€νŠΈ λͺ©ν‘œ(ν”„λ‘¬ν”„νŠΈκ°€ ν•΄μ•Ό ν•  것), 톡과 κΈ°μ€€(성곡을 μ •μ˜ν•˜λŠ” 좜λ ₯ νŠΉμ„±), 골든 예제(2~3개의 μž…λ ₯/좜λ ₯ 쌍), μ•Œλ €μ§„ μ‹€νŒ¨ λͺ¨λ“œ. μ‚¬μš© μ‹œκΈ°: ν”„λ‘¬ν”„νŠΈκ°€ ν…ŒμŠ€νŠΈ μŠ€μœ„νŠΈμ— λ“€μ–΄κ°ˆ λ•Œ. μ €μž₯: Git λ˜λŠ” Braintrust ν”„λ‘œμ νŠΈμ˜ ν…ŒμŠ€νŠΈ 파일과 ν•¨κ»˜.
  4. 4
    Decision Log
    Why it matters: λͺ©μ : ν”„λ‘¬ν”„νŠΈ ν…μŠ€νŠΈμ—μ„œ λͺ…ν™•ν•˜μ§€ μ•Šμ€ 섀계 결정을 κΈ°λ‘ν•©λ‹ˆλ‹€. ν•„λ“œ: λ‚΄λ¦° κ²°μ •, κ³ λ €ν•œ λŒ€μ•ˆ, 이 μ˜΅μ…˜μ„ μ„ νƒν•œ 이유, λ‚ μ§œ. μ‚¬μš© μ‹œκΈ°: λΉ„λͺ…ν™•ν•œ 섀계 선택이 μ΄λ£¨μ–΄μ§ˆ λ•Œ(예: νŠΉμ • temperatureκ°€ μ„€μ •λœ 이유, νŠΉμ • μ œμ•½μ΄ μΆ”κ°€λœ 이유). μ €μž₯: Version Blockμ—μ„œ 링크된 λ¬Έμ„œ.
  5. 5
    Change Rationale
    Why it matters: λͺ©μ : 변경을 λ˜λŒλ¦¬κ±°λ‚˜ λ³΅μ œν•  수 μžˆλŠ” λ°©μ‹μœΌλ‘œ ν”„λ‘¬ν”„νŠΈκ°€ λ³€κ²½λœ 이유λ₯Ό μ„€λͺ…ν•©λ‹ˆλ‹€. ν•„λ“œ: 문제 μ§„μˆ (무엇이 잘λͺ»λλŠ”지), λ³€κ²½ λ‚΄μš©, μ˜ˆμƒ κ°œμ„  사항, μΈ‘μ •λœ κ²°κ³Ό. μ‚¬μš© μ‹œκΈ°: μ‹€νŒ¨ λ˜λŠ” νšŒκ·€μ— λŒ€μ‘ν•˜μ—¬ ν”„λ‘¬ν”„νŠΈκ°€ μˆ˜μ •λ  λ•Œ. μ €μž₯: Git 컀밋 λ³Έλ¬Έ λ˜λŠ” PromptHub λ³€κ²½ λ…ΈνŠΈ.
  6. 6
    API Config Block
    Why it matters: λͺ©μ : ν”„λ‘œλ•μ…˜μ—μ„œ μ‚¬μš©λœ λͺ¨λΈ νŒŒλΌλ―Έν„°λ₯Ό κΈ°λ‘ν•©λ‹ˆλ‹€. ν•„λ“œ: λͺ¨λΈ(예: GPT-5.5, Claude 4.6 Sonnet), temperature, max tokens, top_p, stop sequences, μ‹œμŠ€ν…œ ν”„λ‘¬ν”„νŠΈ 버전, μ‚¬μš©μž ν”„λ‘¬ν”„νŠΈ 버전. μ‚¬μš© μ‹œκΈ°: ν”„λ‘¬ν”„νŠΈκ°€ ν”„λ‘œλ•μ…˜μ— 배포될 λ•Œ. μ €μž₯: 배포 ꡬ성 파일, Version Blockμ—μ„œ μ°Έμ‘°.

πŸ“Œ ν…œν”Œλ¦Ώ 선택 κ°€μ΄λ“œ

μƒˆ ν”„λ‘¬ν”„νŠΈ β†’ One-Liner Card. μˆ˜μ •λœ ν”„λ‘¬ν”„νŠΈ β†’ Version Block. ν…ŒμŠ€νŠΈλœ ν”„λ‘¬ν”„νŠΈ β†’ Test Suite Header. 섀계 κ²°μ • β†’ Decision Log. μ‹€νŒ¨ ν›„ λ³€κ²½ β†’ Change Rationale. ν”„λ‘œλ•μ…˜ 배포 β†’ API Config Block.

ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™” μ €μž₯ μœ„μΉ˜

ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™”λ₯Ό ν”„λ‘¬ν”„νŠΈμ™€ λ™μΌν•œ μ‹œμŠ€ν…œμ— μ €μž₯ν•˜μ„Έμš”. ν”„λ‘¬ν”„νŠΈκ°€ μ½”λ“œμ— μžˆλ‹€λ©΄ Git에 λ¬Έμ„œλ₯Ό μ €μž₯ν•˜μ„Έμš”. GUI 도ꡬ에 μžˆλ‹€λ©΄ ν•΄λ‹Ή λ„κ΅¬μ˜ λ…ΈνŠΈλ‚˜ 링크된 λ¬Έμ„œμ— μ €μž₯ν•˜μ„Έμš”.

  • Git: 파일둜 μ €μž₯된 ν”„λ‘¬ν”„νŠΈκ°€ μžˆλŠ” μ—”μ§€λ‹ˆμ–΄λ§ νŒ€μ— μ΅œμ μž…λ‹ˆλ‹€. 컀밋 λ©”μ‹œμ§€κ°€ Version Block 역할을 ν•©λ‹ˆλ‹€. 무료. 규율이 ν•„μš”ν•©λ‹ˆλ‹€. λ‚΄μž₯ 리뷰어 μ›Œν¬ν”Œλ‘œμš°κ°€ μ—†μŠ΅λ‹ˆλ‹€.
  • PromptHub: 버전 이λ ₯, 리뷰어 μ„œλͺ…, ν…ŒμŠ€νŠΈ κ²°κ³Ό μ €μž₯ κΈ°λŠ₯을 κ°–μΆ˜ λͺ©μ μ— νŠΉν™”λœ ν”„λ‘¬ν”„νŠΈ 관리 λ„κ΅¬μž…λ‹ˆλ‹€. $0~$49/μ›”. 3λͺ… 이상이 ν”„λ‘¬ν”„νŠΈλ₯Ό μž‘μ„±ν•˜λŠ” νŒ€μ— μ΅œμ μž…λ‹ˆλ‹€.
  • Notion: μ½”λ“œκ°€ μ•„λ‹Œ λ¬Έμ„œλ‘œ ν”„λ‘¬ν”„νŠΈλ₯Ό κ΄€λ¦¬ν•˜λŠ” νŒ€μ— μ ν•©ν•©λ‹ˆλ‹€. μ„€μ •ν•˜κΈ° μ‰½μŠ΅λ‹ˆλ‹€. 버전 관리 및 ν…ŒμŠ€νŠΈ 톡합이 μ—†μŠ΅λ‹ˆλ‹€ β€” μ§„μ‹€μ˜ μ›μ²œμ΄ μ•„λ‹Œ λ¬Έμ„œν™” λ ˆμ΄μ–΄λ‘œ μ·¨κΈ‰ν•˜μ„Έμš”.
  • Braintrust: ν”„λ‘¬ν”„νŠΈ 버전과 ν•¨κ»˜ Test Suite Header 및 평가 κ²°κ³Όλ₯Ό μ €μž₯ν•©λ‹ˆλ‹€. 정기적인 μžλ™ν™” 평가λ₯Ό μ‹€ν–‰ν•˜λŠ” νŒ€μ— μ΅œμ μž…λ‹ˆλ‹€.
  • PromptQuorum: 25개 μ΄μƒμ˜ AI κ³΅κΈ‰μžμ—κ²Œ λ™μ‹œμ— λ¬Έμ„œν™”λœ ν”„λ‘¬ν”„νŠΈλ₯Ό μ „λ‹¬ν•˜λŠ” ν”„λ‘¬ν”„νŠΈ μ΅œμ ν™” ν”Œλž«νΌμž…λ‹ˆλ‹€. 버전을 ν™•μ •ν•˜κΈ° 전에 λ¬Έμ„œν™”λœ ν”„λ‘¬ν”„νŠΈκ°€ μ—¬λŸ¬ λͺ¨λΈμ—μ„œ μΌλ°˜ν™”λ˜λŠ”μ§€ κ²€μ¦ν•˜λŠ” 데 μ‚¬μš©ν•˜μ„Έμš”. 무료 ν‹°μ–΄ 제곡.

πŸ’‘ λ¬Έμ„œν™”λ₯Ό ν•¨κ»˜ μ €μž₯ν•˜μ„Έμš”

ν”„λ‘¬ν”„νŠΈμ™€ 별도 μ‹œμŠ€ν…œ(Notion, Confluence, Google Docs)에 μ €μž₯된 λ¬Έμ„œν™”λŠ” λ©°μΉ  내에 ꡬ식이 λ©λ‹ˆλ‹€. ν˜„μž¬ μƒνƒœλ₯Ό μœ μ§€ν•˜λŠ” μœ μΌν•œ λ¬Έμ„œν™”λŠ” ν”„λ‘¬ν”„νŠΈμ™€ ν•¨κ»˜ μžˆλŠ” λ¬Έμ„œν™”μž…λ‹ˆλ‹€.

일반적인 λ¬Έμ„œν™” μ‹€μˆ˜

❌ λ¬Έμ„œν™” μ „ν˜€ μ—†μŒ

Why it hurts: μˆ˜μ • ν›„ ν”„λ‘¬ν”„νŠΈλ₯Ό 볡ꡬ할 수 μ—†κ³ , νŒ€μ΄ ν”„λ‘¬ν”„νŠΈκ°€ νŠΉμ • λ°©μ‹μœΌλ‘œ μž‘μ„±λœ 이유λ₯Ό 이해할 수 μ—†μŠ΅λ‹ˆλ‹€

Fix: μ΅œμ†Œν•œ One-Liner Card ν…œν”Œλ¦Ώμ„ μ‚¬μš©ν•˜μ„Έμš” β€” 3개 ν•„λ“œ, 2λΆ„ 이내

❌ ν”„λ‘¬ν”„νŠΈμ™€ λ³„λ„λ‘œ μ €μž₯된 λ¬Έμ„œν™”

Why it hurts: ν”„λ‘¬ν”„νŠΈκ°€ 변경됨에 따라 λ¬Έμ„œν™”κ°€ ꡬ식이 되며, νŒ€μ΄ μ—…λ°μ΄νŠΈν•˜λŠ” 것을 μžŠμŠ΅λ‹ˆλ‹€

Fix: ν”„λ‘¬ν”„νŠΈ μžμ²΄μ™€ λ™μΌν•œ 파일 λ˜λŠ” Git 컀밋에 λ¬Έμ„œν™”λ₯Ό μ €μž₯ν•˜μ„Έμš”

❌ "why" ν•„λ“œ μ—†μŒ β€” ν”„λ‘¬ν”„νŠΈκ°€ 무엇을 ν•˜λŠ”μ§€λ§Œ μ„€λͺ…

Why it hurts: 미래 νŽΈμ§‘μžκ°€ μ œμ•½ 쑰건을 λͺ¨λ₯΄κ³ , μ•ˆμ „ν•˜κ²Œ λ¦¬νŒ©ν„°λ§ν•  수 μ—†μŠ΅λ‹ˆλ‹€

Fix: λͺ¨λ“  ν…œν”Œλ¦Ώμ— "rationale" ν•„λ“œλ₯Ό μΆ”κ°€ν•˜μ„Έμš”: 이 ꡬ쑰가 μ„ νƒλœ μ΄μœ μ— λŒ€ν•œ 1~2λ¬Έμž₯

❌ Version Block μ—†μŒ

Why it hurts: ν”„λ‘œλ•μ…˜μ—μ„œ μ‹€ν–‰ 쀑인 ν”„λ‘¬ν”„νŠΈκ°€ λ¬Έμ„œν™”λœ 버전과 μΌμΉ˜ν•˜λŠ”μ§€ μ•Œ 방법이 μ—†μŠ΅λ‹ˆλ‹€

Fix: λͺ¨λ“  ν”„λ‘œλ•μ…˜ ν”„λ‘¬ν”„νŠΈ νŒŒμΌμ— versionκ³Ό dateModifiedλ₯Ό μΆ”κ°€ν•˜μ„Έμš”

자주 λ¬»λŠ” 질문

ν”„λ‘¬ν”„νŠΈμ— μ™œ λ¬Έμ„œν™”κ°€ ν•„μš”ν•©λ‹ˆκΉŒ?

λ¬Έμ„œν™”κ°€ μ—†λŠ” ν”„λ‘¬ν”„νŠΈλŠ” κ²€ν† , 감사, μž¬ν˜„μ΄ λΆˆκ°€λŠ₯ν•©λ‹ˆλ‹€. μž‘μ„±μžκ°€ ν”„λ‘¬ν”„νŠΈλ₯Ό λ³€κ²½ν•˜κ³  기둝을 남기지 μ•ŠμœΌλ©΄, νŒ€μ€ νšŒκ·€λ₯Ό 진단할 수 μ—†κ³ , μ•Œλ €μ§„ 정상 λ²„μ „μœΌλ‘œ λ‘€λ°±ν•  수 μ—†μœΌλ©°, μƒˆ νŒ€μ›μ„ μ˜¨λ³΄λ”©ν•  수 μ—†μŠ΅λ‹ˆλ‹€.

ν”„λ‘¬ν”„νŠΈμ— ν•„μš”ν•œ μ΅œμ†Œν•œμ˜ λ¬Έμ„œν™”λŠ” λ¬΄μ—‡μž…λ‹ˆκΉŒ?

μ΅œμ†Œν•œμ€ One-Liner Cardμž…λ‹ˆλ‹€: ν”„λ‘¬ν”„νŠΈ λͺ©μ (ν•œ λ¬Έμž₯), λŒ€μƒ λͺ¨λΈ, 생성 λ‚ μ§œ, μž‘μ„±μž. μž‘μ„±ν•˜λŠ” 데 2뢄이 걸리며 κ°€μž₯ ν”ν•œ λ¬Έμ„œν™” μ‹€νŒ¨ β€” 6κ°œμ›” ν›„ λͺ©μ μ„ μ•Œ 수 μ—†λŠ” ν”„λ‘¬ν”„νŠΈ β€” λ₯Ό μ˜ˆλ°©ν•©λ‹ˆλ‹€.

ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™”λŠ” 어디에 μ €μž₯ν•΄μ•Ό ν•©λ‹ˆκΉŒ?

ν”„λ‘¬ν”„νŠΈ μžμ²΄μ™€ λ™μΌν•œ μœ„μΉ˜μ— ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™”λ₯Ό μ €μž₯ν•˜μ„Έμš”. Git은 μ½”λ“œ 파일둜 μ €μž₯된 ν”„λ‘¬ν”„νŠΈμ— μ ν•©ν•©λ‹ˆλ‹€. PromptHubλŠ” 버전 이λ ₯κ³Ό 리뷰어 μ„œλͺ…이 λ‚΄μž₯된 κ΅¬μ‘°ν™”λœ μ €μž₯μ†Œλ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€. Notion은 λ¬Έμ„œλ‘œ ν”„λ‘¬ν”„νŠΈλ₯Ό κ΄€λ¦¬ν•˜λŠ” νŒ€μ— μ ν•©ν•˜μ§€λ§Œ 버전 관리가 μ—†μŠ΅λ‹ˆλ‹€.

Change Rationale은 μ–Όλ§ˆλ‚˜ 상세해야 ν•©λ‹ˆκΉŒ?

μ„Έ 쀄: λ³€κ²½λœ λ‚΄μš©(ν•œ λ¬Έμž₯), 이유(변경이 ν•΄κ²°ν•˜λŠ” 문제), μ–΄λ–€ ν…ŒμŠ€νŠΈκ°€ 효과λ₯Ό ν™•μΈν–ˆλŠ”μ§€. "why"λ₯Ό κ±΄λ„ˆλ›°λŠ” νŒ€μ€ μž‘μ„±μžκ°€ λ– λ‚œ ν›„ λ°˜λ“œμ‹œ 이전 νŒ¨ν„΄μœΌλ‘œ λ˜λŒμ•„κ°‘λ‹ˆλ‹€.

μƒˆ ν”„λ‘¬ν”„νŠΈμ— μ–΄λ–€ λ¬Έμ„œν™” ν…œν”Œλ¦Ώμ„ μ‚¬μš©ν•΄μ•Ό ν•©λ‹ˆκΉŒ?

One-Liner Card둜 μ‹œμž‘ν•˜μ„Έμš”. ν”„λ‘¬ν”„νŠΈκ°€ ν”„λ‘œλ•μ…˜μ— κ°€λ©΄ Version Block으둜 μ—…κ·Έλ ˆμ΄λ“œν•˜μ„Έμš”. μ—¬λŸ¬ ν…ŒμŠ€νŠΈ μΌ€μ΄μŠ€κ°€ 있으면 Test Suite Headerλ₯Ό μΆ”κ°€ν•˜μ„Έμš”. λΉ„λͺ…ν™•ν•œ 섀계 결정이 ν•„μš”ν–ˆλ‹€λ©΄ Decision Logλ₯Ό μΆ”κ°€ν•˜μ„Έμš”.

ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™”λ₯Ό μ–Όλ§ˆλ‚˜ 자주 μ—…λ°μ΄νŠΈν•΄μ•Ό ν•©λ‹ˆκΉŒ?

ν”„λ‘¬ν”„νŠΈ ν…μŠ€νŠΈκ°€ 변경될 λ•Œλ§ˆλ‹€ μ—…λ°μ΄νŠΈν•˜μ„Έμš”. λͺ¨λ“  μ‹€μ§ˆμ μΈ μˆ˜μ •μ— λŒ€ν•΄ 버전 번호λ₯Ό 올리고 Change Rationale ν•­λͺ©μ„ μΆ”κ°€ν•˜μ„Έμš”. λ¬Έμ„œν™”λ₯Ό μ†ŒκΈ‰ν•˜μ—¬ μ—…λ°μ΄νŠΈν•˜μ§€ λ§ˆμ„Έμš”.

ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™”λŠ” 어디에 μ €μž₯ν•΄μ•Ό ν•©λ‹ˆκΉŒ?

ν”„λ‘¬ν”„νŠΈμ™€ ν•¨κ»˜ λ¬Έμ„œν™”λ₯Ό μ €μž₯ν•˜μ„Έμš” β€” λ™μΌν•œ 파일, 디렉터리, λ˜λŠ” Git 컀밋에. ν”„λ‘¬ν”„νŠΈ 파일 μžμ²΄μ— μ°Έμ‘° 링크 μ—†μ΄λŠ” μ ˆλŒ€ 별도 μ‹œμŠ€ν…œμ— μ €μž₯ν•˜μ§€ λ§ˆμ„Έμš”. λΆ„λ¦¬λœ λ¬Έμ„œν™”λŠ” λ©°μΉ  내에 ꡬ식이 λ©λ‹ˆλ‹€.

PromptHubμ—μ„œ 이 ν…œν”Œλ¦Ώμ„ μ‚¬μš©ν•  수 μžˆμŠ΅λ‹ˆκΉŒ?

예. PromptHubλŠ” Version Block 및 API Config Block ν…œν”Œλ¦Ώμ— 직접 λ§€ν•‘λ˜λŠ” ν”„λ‘¬ν”„νŠΈ 메타데이터 ν•„λ“œλ₯Ό μ €μž₯ν•©λ‹ˆλ‹€. ν…œν”Œλ¦Ώμ„ μ΄ˆμ•ˆμœΌλ‘œ μ‚¬μš©ν•œ λ‹€μŒ, νŒ€κ³Ό κ³΅μœ ν•  μ€€λΉ„κ°€ 되면 PromptHub에 ν•„λ“œλ₯Ό λ³΅μ‚¬ν•˜μ„Έμš”.

κ΄€λ ¨ 읽기

좜처

Apply these techniques with a local LLM or your own API keys β€” PromptQuorum works with any backend.

Try PromptQuorum free β†’

← Back to Prompt Engineering

ν”„λ‘¬ν”„νŠΈ λ¬Έμ„œν™” ν…œν”Œλ¦Ώ: νŒ€μ„ μœ„ν•œ 6가지 ν˜•μ‹ | PromptQuorum