> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sifi.life/llms.txt
> Use this file to discover all available pages before exploring further.

# 자주 하는 실수 — 시간 낭비 피하기

***

## 실수 1: 하나의 대화에서 여러 작업

| 상황                       | 결과                       |
| ------------------------ | ------------------------ |
| EDA → ETL → 대시보드를 한 대화에서 | 컨텍스트 오염 → 환각, 잘못된 테이블 참조 |

**해결**: 작업마다 새 대화를 시작하세요. → [프롬프트 5대 원칙 — 원칙 1](prompt-principles#원칙-1-작업마다-새-대화-context-isolation) 참조

> **실습**: 새 대화를 시작하고 이렇게 프롬프트를 보내보세요:
>
> ```
> (새 대화에서) @smart_tv.bronze.viewing_logs에서 지역별 시청 시간 평균을 구해줘.
> ```

***

## 실수 2: 모호한 프롬프트

```
❌ "데이터를 분석해줘"
❌ "대시보드를 만들어줘"
❌ "모델을 학습해줘"
```

**해결**: 5가지를 명시 → 테이블, 관점, 차트 타입, 출력 형태, 라이브러리

***

## 실수 3: "Always Allow" 클릭

"Always allow"를 누르면 **앞으로 모든 작업이 무승인으로 실행**됩니다. DROP TABLE도.

**해결**: **"Allow in this thread"만 사용**. → [시작하기 — 승인 옵션](getting-started#승인-옵션-중요) 참조

> **이미 "Always Allow"를 눌렀다면?** 브라우저에서 페이지를 새로고침(F5)하면 해당 대화의 "Always Allow" 설정이 초기화됩니다. 새 대화를 시작하면 다시 승인을 요청합니다.

***

## 실수 4: 에러 후 같은 말 반복

```
❌ 에러 발생 → "다시 해줘" → 같은 에러 → "다시 해줘" → 무한 루프
```

**해결**: **Stop** 후 **구체적으로** 뭐가 잘못됐는지 알려주세요.

```
✅ "Stop. 이 테이블은 비어있어. 
   대신 @smart_tv.silver.viewing_sessions를 사용해줘."
```

***

## 실수 5: 테이블 이름 직접 타이핑

오타 → 에러 → 시간 낭비

**해결**: `@`를 입력하면 자동완성 드롭다운이 나타납니다. 항상 자동완성으로 선택하세요.

***

## 실수 6: 실행 중 페이지 새로고침

**에이전트 세션이 즉시 사망합니다.** 복구 불가.

**해결**: 실행이 끝날 때까지 기다리세요. 브라우저 탭 전환도 주의 (일시 중지됨).

***

## 실수 7: Unity Catalog 메타데이터 미비

COMMENT가 없는 테이블을 Genie Space에 넣으면:

* `total_viewing_min`이 "분"인지 "건수"인지 모름
* `hdr_viewing_pct`가 "0~~1"인지 "0~~100"인지 모름

**해결**: **테이블/컬럼에 COMMENT를 먼저 추가**하세요. 이것이 Genie 정확도의 90%입니다.

```
@smart_tv.gold 스키마의 모든 테이블과 컬럼에 한국어 COMMENT를 달아줘.
```

***

## 실수 8: Custom Instructions에 규칙 50개+

너무 많은 규칙 → Genie Code가 우선순위를 못 정함 → 규칙 무시

**해결**: **핵심 10\~15개만** 간결하게. 나머지는 프롬프트에서 상황별로 지시.

***

## 실수 9: 안전 가드레일 누락

프롬프트에 "DROP하지 마"를 안 쓰면 → Genie Code가 기존 테이블을 덮어쓸 수 있음

**해결**: Custom Instructions에 안전 규칙을 넣거나, 매 프롬프트에 포함:

```
- 기존 테이블 DROP/DELETE/UPDATE 금지
- CREATE OR REPLACE로 새 테이블 생성
- 테스트 시 LIMIT 1000
```

***

## 실수 10: Plan을 확인 안 하고 바로 Allow

Agent Mode가 보여주는 Plan(실행 계획)을 확인하지 않고 바로 Allow → 예상과 다른 작업 수행

**해결**: **Plan을 반드시 읽고** 의도한 작업이 맞는지 확인 후 Allow.

> 💡 **화면 참고**: Agent Mode Plan — 각 스텝을 확인하는 모습

> **실습**: Plan 단계에서 이렇게 요청할 수 있습니다:
>
> ```
> 실행하기 전에 Plan만 보여줘. 아직 실행하지 마.
> 어떤 테이블에 어떤 작업(SELECT/CREATE/DROP)을 할 건지 목록으로 알려줘.
> ```

***

## 다음 단계

* **[보안 제한사항](security-limitations)** — 뭐가 되고 뭐가 안 되는지 미리 알면 삽질을 피할 수 있습니다.