문서 · 하네스 라이브러리

개인 실험에서 조직 표준 도구로

하네스는 검증된 평가 틀입니다. 가늠의 하네스 라이프사이클은 한 사람의 실험을 조직 전체가 쓰는 버전 관리된 도구로 끌어올립니다 — 증거와 산출물 중심으로.

라이프사이클

네 단계

프롬프트를 작성하고 샌드박스에서 마음에 들 때까지 돌려봅니다. 저장하면 개인 하네스 — 본인만 보고 실행할 수 있습니다.

// Personal: ganeum bug triage v3
// Owner: ey · Scope: personal
// Last sandbox score: 91 / 100

5개 이상의 대표 입력으로 하네스를 검증합니다. 가늠이 루브릭 점수(format · coherence · accuracy · brevity · actionability)를 계산하고 교차검증 결과를 기록합니다.

// Test cases: 8
// Avg rubric: 91 / 100 (claude=94, gpt=89, gemini=92, llama=88)
// p95 latency: 2.4s · est cost / run: $0.014

팀원 5명 이상이 본인 업무에 사용해 4점 이상으로 평가하면 시스템이 승격을 제안합니다. 승격 시 프롬프트는 특정 버전에 고정되고 changelog에 증거로 기록됩니다.

// Company: bug triage v3 (ey에서 승격)
// Scope: company · Reviewed by: 6 · Avg rating: 4.5 / 5
// Changelog: 2026-04-22 승격 · 2026-04-30 v3.1 오타 수정

모든 수정이 새 버전을 생성합니다. 이전 버전도 그대로 호출 가능합니다 — 과거 산출물이 이전 하네스로 생성됐을 때 재현하려면 필수입니다.

// v3.1 (current)
// v3.0 (deprecated, 호출 가능)
// v2.4 (잠김, 과거 산출물 47건이 사용)

팁

개인 하네스에서 {{repo}}, {{outcome_title}}, {{user_role}} 같은 플레이스홀더를 쓰면 실행 시 가늠이 채워줍니다.

하네스 본문에 시크릿을 적지 마십시오 — 승격되면 공유됩니다. 토큰은 환경 변수 플레이스홀더({{env.API_KEY}})로 참조하십시오.

하네스에 카테고리(살핌 · 엮음 · 합성 · 의사결정 등) 태그를 붙이십시오. 산출물 등록 화면의 자동 추천이 상위 3개를 표시합니다.

조직 하네스가 드리프트(평균 평점이 14일간 3.5 미만)되면 자동으로 살핌 플래그가 붙습니다.

샌드박스의 교차검증(트라이앵귤레이션)과 루브릭 채점 방식을 확인하십시오.