MODULE 04 — 에이전트 입문 — 채팅창 밖으로

01개념 · 15분

에이전트란 무엇인가

	채팅	에이전트
자료 입력	첨부 (개수 제한, 손으로)	폴더째 접근
처리 규모	파일 몇 개	파일 수백 개, 반복 작업
결과물	대화창 텍스트	실제 파일 (엑셀·문서·스크립트)
검증	사람이	스스로 실행해보고 고침

핵심 메시지채팅은 상담이고, 에이전트는 파견 직원이다.

CLAUDE.md — 작업 폴더에 두면 에이전트가 매번 읽고 따르는 업무 수칙 파일. 모듈 3 Projects 지침의 "에이전트판".

안전 수칙 4가지① 작업 폴더 분리 (C:\ 통째로 주지 않는다) ② 원본 백업 후 작업 ③ 큰 작업은 "실행 전에 계획부터 보여줘" ④ 회사 자료는 보안 규정 내에서만

02시연 · 25분

로그 30개, 한 번의 지시

관전 포인트를 먼저 알려주고 시연한다 — ① 계획 승인 ② 30개 파일 순회 ③ 스스로 코드를 짜서 집계(그래서 숫자가 정확하다 — 모듈 2의 재계산을 자기가 함) ④ 결과 파일 2개 생성 ⑤ 6/25 장애의 전조를 찾아내는가.

Claude Code — 에이전트 (작업 폴더: module4/)

logs 폴더에 6월 한 달치 애플리케이션 로그가 일별로 있다. 1) 전체 로그를 분석해서 일자별 오류 건수 추이를 집계하고 2) 오류 유형별로 분류한 뒤 3) 6월 중 상태가 나빠진 지점이 있으면 찾아서 원인을 추정해줘. 결과는 ①집계 엑셀 ②운영팀 공유용 보고서(md) 두 파일로 저장해줘. 실행 전에 작업 계획부터 보여줘.

작업 계획
1. logs/ 폴더 파일 목록 확인 (30개 예상)
2. 각 파일에서 ERROR/WARN 라인 추출 → 유형 분류 기준 수립
3. 파이썬 스크립트로 일자별·유형별 집계 (정확한 수치 보장)
4. 추이 분석 — 급증 구간 탐지
5. output/일자별_오류집계.xlsx, output/6월_로그분석_보고서.md 생성
진행할까요? [사용자: 진행해]

logs/ 스캔 — app_20260601.log … app_20260630.log (30개 파일, 총 1,631라인)

집계 스크립트 작성 및 실행 — analyze_logs.py

집계 완료. ERROR 85건 / WARN 114건

■ 핵심 발견 · 6/1~6/17 : 일평균 ERROR 0.4건 — 안정 구간 · 6/18~6/24 : "connection not returned to pool (possible leak)" WARN이 증가 추세 (2 → 4 → 6 → 12 → 20건…) — 장애 전조 · 6/25 : 14시대 pool exhausted ERROR 55건 집중 — 장애 발생. 14:31 셧다운 → 14:36 재기동 기록 · 6/27~ : "stat_summary query disabled" 설정 변경 후 안정화 결론(추정): 6/18부터 커넥션 미반납 누수가 누적되어 6/25 풀 고갈로 이어짐. 전조 단계(WARN 급증)에서 탐지 가능했던 장애로 판단됨.

output/일자별_오류집계.xlsxoutput/6월_로그분석_보고서.md

서브 시연 — CLAUDE.md 효과 (7분)

CLAUDE.md.example을 작업 폴더에 넣고 같은 지시 재실행 → 보고서가 지정 양식(3줄 요약, 두괄식)과 표기 규칙(OMS 약어, 추정 표시)을 따른다. "지시문에 없던 규칙이 어디서 왔나? CLAUDE.md다."

03실습 · 60분

직접 해보기

미션 0

환경 확인

10분

Claude Code / Cowork 실행 → 실습 폴더(module4/ 사본) 연결.
동작 확인 지시 → 안 되는 수강생은 짝꿍·조교 지원.

이 폴더에 뭐가 있는지 구조와 내용 요약해줘

미션 1

로그 폴더 일괄 분석

20분

시연과 같은 과제를 본인이 지시문을 작성해 실행 (시연 프롬프트 참고 가능).
확인 질문에 답하기 — 6월에 무슨 일이 있었나? 전조는 언제부터였나?
에이전트의 답을 원본 로그 1~2개를 직접 열어 검증.

예상 결과 화면 보기

Claude Code — 에이전트 (작업 폴더: module4/)

logs 폴더에 6월 한 달치 애플리케이션 로그가 일별로 있다. 1) 전체 로그를 분석해서 일자별 오류 건수 추이를 집계하고 2) 오류 유형별로 분류한 뒤 3) 6월 중 상태가 나빠진 지점이 있으면 찾아서 원인을 추정해줘. 결과는 ①집계 엑셀 ②운영팀 공유용 보고서(md) 두 파일로 저장해줘. 실행 전에 작업 계획부터 보여줘.

작업 계획
1. logs/ 폴더 파일 목록 확인 (30개 예상)
2. 각 파일에서 ERROR/WARN 라인 추출 → 유형 분류 기준 수립
3. 파이썬 스크립트로 일자별·유형별 집계 (정확한 수치 보장)
4. 추이 분석 — 급증 구간 탐지
5. output/일자별_오류집계.xlsx, output/6월_로그분석_보고서.md 생성
진행할까요? [사용자: 진행해]

logs/ 스캔 — app_20260601.log … app_20260630.log (30개 파일, 총 1,631라인)

집계 스크립트 작성 및 실행 — analyze_logs.py

집계 완료. ERROR 85건 / WARN 114건

■ 핵심 발견 · 6/1~6/17 : 일평균 ERROR 0.4건 — 안정 구간 · 6/18~6/24 : "connection not returned to pool (possible leak)" WARN이 증가 추세 (2 → 4 → 6 → 12 → 20건…) — 장애 전조 · 6/25 : 14시대 pool exhausted ERROR 55건 집중 — 장애 발생. 14:31 셧다운 → 14:36 재기동 기록 · 6/27~ : "stat_summary query disabled" 설정 변경 후 안정화 결론(추정): 6/18부터 커넥션 미반납 누수가 누적되어 6/25 풀 고갈로 이어짐. 전조 단계(WARN 급증)에서 탐지 가능했던 장애로 판단됨.

output/일자별_오류집계.xlsxoutput/6월_로그분석_보고서.md

미션 2

회의록 일괄 표준화

15분

회의록 폴더의 파일들을 표준 양식(일시/참석/결정사항/액션아이템 담당·기한)으로
통일해서 minutes_clean 폴더에 저장하고,
전체 회의의 액션아이템만 모은 추적표를 엑셀로 만들어줘.

예상 결과 화면 보기

Claude Code — 에이전트

회의록/ 스캔 — 6개 파일, 작성 양식 4종 혼재 확인

표준화 완료 → minutes_clean/ (6개 파일)

액션아이템 추적표: 총 14건 추출 · 완료 표시 가능 6건 / 진행중 5건 / 기한 미지정 3건 — 확인 필요 표시 · 예: "슬로우쿼리 분석 결과 공유 — 이주임, 6/26" (6/23 회의록)

minutes_clean/ (6건)output/액션아이템_추적표.xlsx

포인트 — "6건이라 손으로도 되지만, 60건이면?" 규모 확장의 감각.

미션 3

나만의 CLAUDE.md

15분

CLAUDE.md.example을 복사해 본인 팀 규칙 3가지 이상으로 수정 (보고서 양식·용어·금지사항).
미션 1 또는 2를 재실행 → 결과 차이 확인.

04공유 · 20분

마무리

논의 — "이건 채팅으로는 못 하는 일인가?" 각자 답해보기.
발표 — 본인 업무 중 "폴더째 시킬 일" 후보 2개씩 → 다음 모듈들의 재료.
미니 과제 — 본인 PC의 실제 폴더 1개(보안 무관)로 정리·분석 1건 실행.

다음 회차 예고 + 설치 공지"다음 주엔 소스 코드가 든 폴더를 준다. 개발하라는 게 아니다 — 시스템을 이해하는 데 쓴다." + Codex 설치 안내 배포.