refs #739: govern Smilegate few-shot references

docs/design/739-game-target-contract/README.md

@@ -116,7 +116,32 @@ system prompt와 MCP 도구 설명으로 다음 절차를 안내한다.
 - 생성 SQL에서 `NONE`의 prefix 전용 객체 차단 확인
 - 운영 서비스 health와 Portal ReAct 실제 응답 확인
 
-## 8. 변경 이력
+## 8. Few-shot 참조 거버넌스
+
+Few-shot 원문 SQL은 실행 이력 그대로 검색하지 않는다. 특히 특정 게임의 물리 객체명이
+포함된 예제는 다른 게임 또는 게임 미지정 질의의 벡터 후보가 될 수 있으므로, 예제는
+검증·정규화·승인 단계를 거쳐야 한다.
+
+`SG_QA_VECTOR_EXAMPLE`에는 다음 참조 메타데이터를 둔다.
+
+| 필드 | 내용 |
+|---|---|
+| `REFERENCE_STATUS` | `DRAFT`, `APPROVED`, `RETIRED`. 검색은 `APPROVED`만 사용한다. |
+| `REFERENCE_KIND` | `SQL_TEMPLATE`, `NO_TARGET`, `OBJECT_UNAVAILABLE`, `METADATA_POLICY` |
+| `TARGET_TYPE` | `NONE`, `SINGLE`, `MULTI`, `ALL`, `ANY`. 현재 game query plan과 일치하는 예제만 벡터 순위에 포함한다. |
+| `OBJECT_ROLE` | 물리 테이블명이 아닌 `GAME_USER_MASTER` 등 논리 객체 역할 |
+| `INSPECTION_STATUS`, `INSPECTION_NOTE` | 전수 실행·정책 검토 결과와 사유 |
+| `VERIFIED_AT`, `VERIFIED_BY` | 승인 감사 이력 |
+
+물리 테이블명은 Few-shot의 의미 규칙으로 저장하지 않는다. `SQL_TEMPLATE`은
+`<RESOLVED_GAME_USER_MASTER>` 같은 논리 placeholder를 사용하며, 실제 객체는 오직
+현재 `queryPlan.targets[*].userMasterObjectName`에서만 해석한다. `NO_TARGET`과
+`OBJECT_UNAVAILABLE` 예제는 SQL 패턴이 아니라 범위 경계 안내로 프롬프트에 포함한다.
+
+기존 예제는 삭제하지 않는다. 실행 가능성, 게임 범위 일치, 물리 객체 의존성을 전수
+검사해 `RETIRED`로 분리하고, 검증된 정규화 예제만 `APPROVED`로 전환한다.
+
+## 9. 변경 이력
 
 - Redmine: `#739`
 - Backoffice branch: `smilegate`