01개념 · 15분
AI 바로 알기 — 딱 3가지만
오늘 확인할 것 하나 — 같은 AI인데 왜 결과가 하늘과 땅 차이인가.
| LLM에 대해 알아야 할 3가지 | 그래서 |
|---|---|
| ① 다음 단어 예측기다 | 그럴듯한 거짓말(환각)이 가능하다 → 검증 필요 |
| ② 컨텍스트(대화창 내용)가 아는 것의 전부다 | 자료를 줘야 한다 |
| ③ 일반 지식은 많지만 우리 회사 일은 모른다 | 맥락을 줘야 한다 |
핵심 메시지AI는 검색기가 아니라, 자료를 주고 일을 시키는 신입사원이다.
일 시키는 법 4습관
| 습관 | 내용 | 신입사원 비유 |
|---|---|---|
| ① 역할·맥락 | 너는 누구고, 지금 상황이 뭔지 | 업무 배경 설명 |
| ② 자료 | 파일을 첨부해 판단 근거를 준다 | 관련 문서 전달 |
| ③ 출력 형식 | 표 · 보고서 양식 · 분량 지정 | 산출물 양식 지정 |
| ④ 대화로 다듬기 | 한 번에 안 되면 고쳐 시킨다 | 피드백 |
02시연 · 25분
Before / After — 장애보고서
같은 질문, 두 가지 방식. 탭을 눌러 비교한다.
나 — 프롬프트
장애보고서 어떻게 써?
✳ Claude
장애보고서는 일반적으로 다음 항목으로 구성됩니다.
- 장애 개요: 발생 일시, 시스템, 등급
- 장애 내용: 어떤 현상이 발생했는지
- 원인 분석: 장애의 근본 원인
- 조치 사항: 복구를 위해 수행한 조치
- 재발 방지 대책
명확하고 간결하게 작성하는 것이 중요합니다…
— 뻔한 일반론. 지금까지 우리가 쓰던 방식 —
나 — 프롬프트
너는 주문관리시스템(OMS)의 SM 운영 담당자다. 어제(7/15) 오후에 발생한 장애에 대한 보고서를 작성해야 한다. 첨부한 로그 파일과 담당자 메모를 근거로, 첨부한 보고서 양식 (개요/장애 경위 타임라인/원인 분석/조치 내역/재발 방지 대책)에 맞춰 장애보고서 초안을 작성해줘. - 타임라인은 로그의 실제 시각을 인용할 것 - 원인 분석에는 근거가 된 로그 라인을 인용할 것 - 추정인 부분은 '추정'이라고 명시할 것 [첨부] incident_20260715.log · 담당자메모.txt · 보고서양식.md
✳ Claude
OMS 장애보고서 (초안)
1. 개요
| 시스템 | 주문관리시스템(OMS) | 등급 | 2급 (주요 기능 부분 중단) |
|---|---|---|---|
| 발생 | 2026-07-15 13:38경 (탐지 13:30) | 복구 | 2026-07-15 14:35 |
| 지속 | 약 30분 (전면 영향 기준 14:05~14:35) | 작성 | 운영팀 김대리 |
2. 장애 경위 (타임라인)
| 시각 | 상황 | 근거 |
|---|---|---|
| 13:30 | 콜센터 주문 조회 지연 문의 2건 (최초 징후) | 담당자 메모 |
| 13:38~ | 슬로우 쿼리 경고 발생 시작 — SlowQuery detected: SELECT /* stat_summary */ … elapsed=28,742ms | 로그 13:38:12 |
| 13:45~ | 커넥션 풀 사용량 급증 — active=45/50 | 로그 13:47:33 |
| 14:02~ | 커넥션 풀 고갈, 주문 등록/조회 실패 확산 — pool exhausted (active=50/50) | 로그 14:02~14:19 ERROR 40여 건 |
| 14:20 | 문제 쿼리 세션 강제 종료 + WAS 재기동 결정 | 담당자 메모 |
| 14:25 / 14:28 | WAS 1·2호기 순차 재기동 | 로그 14:24:55, 14:28:47 |
| 14:35 | 정상 확인, 콜센터 정상화 공지 — pool normal: active=7/50 | 로그 14:36:02 |
3. 영향 범위
약 30분간 주문 등록·조회 불가 또는 지연. 콜센터 문의 47건 (메모 기준). 대외 영향: 확인 필요.
4. 원인 분석
- 직접 원인: DB 커넥션 풀 고갈. Timeout waiting for idle object, pool exhausted (로그 14:02:17)
- 근본 원인(추정): 7/14 야간 반영된 통계성 조회 쿼리(stat_summary)가 인덱스를 타지 않아 커넥션을 장시간 점유. 커넥션 미반납(close 누락) 가능성 병존 — DBA 분석 결과로 확정 필요.
5. 조치 내역
- 긴급: 문제 쿼리 세션 종료, WAS 2대 재기동 (14:20~14:35)
- 후속: 해당 쿼리 롤백 완료
6. 재발 방지 대책
| 구분 | 대책 | 담당 | 기한 |
|---|---|---|---|
| 단기 | stat_summary 쿼리 인덱스 추가 검토 | (기입) | 1주 내 |
| 단기 | 커넥션 close 누락 소스 점검 | (기입) | 1주 내 |
| 중기 | 배포 전 슬로우쿼리 사전 점검 절차 추가 | (기입) | 1개월 내 |
— 이어서 다듬기(습관 ④) —
나 — 프롬프트
경영진 보고용 3줄 요약을 맨 앞에 추가해줘
✳ Claude
[경영진 요약]
- 7/15 14시경 OMS 주문 등록·조회가 약 30분간 중단/지연 (2급, 콜센터 문의 47건)
- 원인: 전일 반영된 통계 쿼리의 DB 커넥션 장기 점유(추정) → 커넥션 풀 고갈
- 쿼리 롤백으로 복구 완료. 인덱스 보완·소스 점검을 1주 내 진행 예정
…(이하 보고서 본문 동일)…
03실습 · 60분
직접 해보기
Lv.1 vs Lv.2 비교 체험
15분- 아래 두 프롬프트를 각각 새 대화에서 실행한다.
- 결과의 차이를 실습지에 한 문장으로 적는다.
장애보고서 써줘
너는 주문관리시스템(OMS)의 SM 운영 담당자다. 첨부한 로그와 메모를 근거로, 보고서 양식(개요/타임라인/원인/조치/재발방지)에 맞춰 장애보고서 초안을 작성해줘. 타임라인은 로그의 실제 시각을 인용할 것. [첨부] incident_20260715.log · 담당자메모.txt · 보고서양식.md
장애보고서 초안 만들기 + 3회 다듬기
25분- module1/의 파일 3개(로그·메모·양식)를 첨부하고 본인 방식으로 지시한다.
- 다듬기 지시를 최소 3회 — 예: 타임라인을 표로 / 3줄 요약 추가 / 대책을 단기·중기로 구분.
- 최종본을 파일로 저장한다.
막힐 때결과가 이상하면 → "어느 로그를 보고 그렇게 판단했어?" 라고 물어본다.
예상 결과 화면 보기
✳ Claude
OMS 장애보고서 (초안)
1. 개요
| 시스템 | 주문관리시스템(OMS) | 등급 | 2급 (주요 기능 부분 중단) |
|---|---|---|---|
| 발생 | 2026-07-15 13:38경 (탐지 13:30) | 복구 | 2026-07-15 14:35 |
| 지속 | 약 30분 (전면 영향 기준 14:05~14:35) | 작성 | 운영팀 김대리 |
2. 장애 경위 (타임라인)
| 시각 | 상황 | 근거 |
|---|---|---|
| 13:30 | 콜센터 주문 조회 지연 문의 2건 (최초 징후) | 담당자 메모 |
| 13:38~ | 슬로우 쿼리 경고 발생 시작 — SlowQuery detected: SELECT /* stat_summary */ … elapsed=28,742ms | 로그 13:38:12 |
| 13:45~ | 커넥션 풀 사용량 급증 — active=45/50 | 로그 13:47:33 |
| 14:02~ | 커넥션 풀 고갈, 주문 등록/조회 실패 확산 — pool exhausted (active=50/50) | 로그 14:02~14:19 ERROR 40여 건 |
| 14:20 | 문제 쿼리 세션 강제 종료 + WAS 재기동 결정 | 담당자 메모 |
| 14:25 / 14:28 | WAS 1·2호기 순차 재기동 | 로그 14:24:55, 14:28:47 |
| 14:35 | 정상 확인, 콜센터 정상화 공지 — pool normal: active=7/50 | 로그 14:36:02 |
3. 영향 범위
약 30분간 주문 등록·조회 불가 또는 지연. 콜센터 문의 47건 (메모 기준). 대외 영향: 확인 필요.
4. 원인 분석
- 직접 원인: DB 커넥션 풀 고갈. Timeout waiting for idle object, pool exhausted (로그 14:02:17)
- 근본 원인(추정): 7/14 야간 반영된 통계성 조회 쿼리(stat_summary)가 인덱스를 타지 않아 커넥션을 장시간 점유. 커넥션 미반납(close 누락) 가능성 병존 — DBA 분석 결과로 확정 필요.
5. 조치 내역
- 긴급: 문제 쿼리 세션 종료, WAS 2대 재기동 (14:20~14:35)
- 후속: 해당 쿼리 롤백 완료
6. 재발 방지 대책
| 구분 | 대책 | 담당 | 기한 |
|---|---|---|---|
| 단기 | stat_summary 쿼리 인덱스 추가 검토 | (기입) | 1주 내 |
| 단기 | 커넥션 close 누락 소스 점검 | (기입) | 1주 내 |
| 중기 | 배포 전 슬로우쿼리 사전 점검 절차 추가 | (기입) | 1개월 내 |
본인 업무 자료 적용
20분- 지참한 본인 보고서/메일 1건의 원재료(메모·데이터)를 비슷하게 입력한다.
- 4요소 방식으로 재생성한다.
- 원본과 비교 — 무엇이 좋고 무엇이 부족한가.
자료가 없으면: 담당자메모.txt만으로 "팀장 보고용 메일"을 작성한다.
04공유 · 20분
마무리
- 결과 공유 — 2~3명 화면 공유. 잘 된 프롬프트를 4요소로 분해해본다.
- 선언 — "이번 주에 바로 써볼 내 업무 1개"를 각자 말한다.
- 미니 과제 — 실제 업무 1건을 4요소 방식으로 처리하고, 프롬프트와 결과를 다음 회차에 지참.
다음 회차 — "오늘은 파일 1~2개였다. 다음엔 엑셀과 수천 줄 로그를 다룬다."
클로드코드 시작하기◀ 개요모듈 2 · 파일과 데이터 ▶