refs #749: compare HMM Select AI annotation profiles

docs/design/749-hmm-select-ai-no-annotation-profile/architecture.md

@@ -0,0 +1,49 @@
+# 비교 설계
+
+[개요](README.md) · [실행 절차](cookbook.md) · [측정 결과](results.md) · [문제 해결](troubleshooting.md)
+
+## 비교 대상
+
+| 속성 | annotation 사용 | annotation 제외 |
+|---|---|---|
+| 프로파일 | `HMM_HR_DATA_GPT54_PROFILE` | `HMM_HR_DATA_GPT54_NOANN_PROFILE` |
+| provider | `oci` | 동일 |
+| model | `openai.gpt-5.4-mini` | 동일 |
+| object list | HMM HR 5개 객체 | 동일 |
+| temperature | `0.1` | 동일 |
+| max tokens | `1500` | 동일 |
+| annotations | `true` | `false` |
+
+credential 이름과 compartment OCID는 비밀값은 아니지만 환경 종속값이므로 문서에 복사하지 않고
+DB 원본 프로파일을 기준으로 검증한다. credential 원문이나 토큰은 조회·출력하지 않는다.
+
+## 측정 방식
+
+```text
+run 1: annotation → no annotation
+run 2: no annotation → annotation
+run 3: annotation → no annotation
+```
+
+호출 순서를 번갈아 배치해 첫 호출 캐시와 일시적 모델 지연이 한쪽에만 몰리는 현상을 줄인다.
+각 호출은 `DBMS_CLOUD_AI.GENERATE(prompt, profile, action)` 한 번의 경과 시간을
+`DBMS_UTILITY.GET_TIME`으로 측정한다.
+
+- `showprompt`: 모델에 전달되는 metadata prompt 크기와 구성 비용 비교
+- `showsql`: 실제 SQL 생성 시간과 성공 여부 비교
+
+생성 SQL은 실행하지 않는다. SQL 생성 품질은 `SELECT`/`WITH` 시작 여부, 길이와 주요 객체 사용을
+검토한다. VPD 결과 행 비교는 운영 프로파일 전환을 결정한 뒤 별도 MCP 회귀 검증에서 수행한다.
+
+## 안전 경계
+
+- 기존 프로파일에는 `SET_ATTRIBUTE`, disable, drop을 실행하지 않는다.
+- 비교 프로파일이 이미 있으면 덮어쓰지 않고 정의를 검증한다.
+- 벤치마크는 DDL/DML을 생성하거나 실행하지 않고 `showprompt`와 `showsql`만 호출한다.
+- 새 프로파일은 운영 MCP 설정에 자동 연결하지 않는다.
+
+Oracle 공식 문서에 따르면 `annotations=true`는 table/column annotation을 LLM metadata에 포함하며,
+프로파일 속성은 `DBA_CLOUD_AI_PROFILE_ATTRIBUTES`에서 확인할 수 있다.
+
+- [Oracle DBMS_CLOUD_AI package](https://docs.oracle.com/en/database/oracle/oracle-database/26/arpls/dbms_cloud_ai1.html)
+- [Oracle DBMS_CLOUD_AI views](https://docs.oracle.com/en-us/iaas/autonomous-database-serverless/doc/dbms-cloud-ai-views.html)