수강생 실습지 — 1회차 (2026-11-02 월 14:00–18:00)

Claude Code 자동화 에이전트 개발 교육 · 한양대학교 기계공학부 대학원

• 프롬프트는 코드 박스 안 내용을 그대로 복사해 Claude 패널 입력창에 붙여 넣습니다.
• TERMINAL은 VS Code 아래 터미널(PowerShell)에, PROMPT는 Claude 패널에 입력합니다.
• 다 되면 초록 포스트잇, 막히면 빨강 포스트잇을 노트북 위에 붙입니다. 막히면 옆자리 짝에게 먼저 묻습니다.
• 어느 모듈에서 결과가 끝내 안 나와도 괜찮습니다. 배포 페이지의 체크포인트 묶음(cp-A1.zip~cp-A5.zip)을 받아 C:\hthp-lab에 풀어 덮어쓰고 다음 모듈부터 합류합니다.
• 배포 페이지: https://hthp.ilhae.ai (자료 칸에 체크포인트 묶음)

체크포인트 묶음으로 합류하는 법 (PowerShell, cp-A2를 예로)

Copy-Item -Path C:\hthp-lab -Destination C:\hthp-lab-mine -Recurse
Expand-Archive -Path "$HOME\Downloads\cp-A2.zip" -DestinationPath C:\hthp-lab -Force

• 첫 줄은 내 파일 보관입니다. C:\hthp-lab-mine이 이미 있으면 C:\hthp-lab-mine2처럼 다른 이름을 씁니다.
• 묶음은 C:\가 아니라 C:\hthp-lab에 풉니다. zip 이름만 바꿔 씁니다.
• cp-A4·cp-A5는 CLAUDE.md도 덮어씁니다. 내가 쓴 규칙은 보관한 폴더에서 다시 붙여 넣습니다.

5분 만에 다시 따라 하기

1. 폴더를 VS Code로 열고 Claude 패널 띄우기 — 처음엔 Manual 모드
2. /plan 으로 계획을 받고, 코멘트로 고친 뒤 승인
3. diff를 읽고 승인. 결과는 전후 비교표로 확인
4. 게이트 3종으로 물리 검증. 탈락은 지우지 않고 플래그
5. CLAUDE.md와 /analyze-run 으로 굳히기

1회차 시간표

A3 STEP 3은 선택이고, A5 STEP 2는 강사 시연입니다(여러분은 과제 첫 단계로 집에서 합니다).

용어 카드 12개

A0. 페어 작업 세팅과 흐름

권한 모드는 결재 방식입니다

프롬프트 박스 아래의 모드 표시를 눌러 바꿉니다. 1회차는 Manual로 진행합니다.

새 대화는 Auto로 시작할 수 있습니다. 대화를 열 때마다 입력창 아래가 Manual인지 확인합니다. Edit automatically에서도 .claude 폴더(설정·스킬·에이전트) 파일을 고칠 때는 승인 창이 뜹니다.

A0 · STEP 1/2 — 세팅 점검 (7분)

할 일 버전 세 가지를 확인하고, 실습 폴더를 VS Code로 열어 Claude 패널을 띄웁니다.

TERMINAL · VS Code 아래 터미널 (Ctrl+`) — PowerShell

claude --version
py --version
py -c "import pandas, matplotlib, CoolProp; print('OK')"

확인 값: 2.1.314 이상 · Python 3.11.x · OK

VS Code에서: 파일 → 폴더 열기 → C:\hthp-lab → data 폴더의 CSV 하나 열기 → 오른쪽 위 Spark 아이콘 → 처음이면 Sign in (브라우저에서 로그인 후 돌아오기) → 입력창 아래 모드 표시를 눌러 Manual로 변경 → 모델 이름을 눌러 Sonnet 선택 (Pro 사용량 한도를 아끼기 위해 실습은 Sonnet으로 합니다)

예상 결과: 터미널에 버전 두 줄과 'OK'. 오른쪽에 Claude 패널이 열리고 입력창 아래에 Sonnet·Manual 표시

• 세 줄이 모두 나오고, 패널 입력창 아래에 Sonnet·Manual이 보인다

A0 · STEP 2/2 — 첫 대화: 폴더를 읽게 합니다 (5분)

할 일 Claude가 파일을 설명하게 합니다. 명령 승인 창이 뜨면 명령을 읽고 Yes — 아직 "don't ask again"은 고르지 않습니다.

PROMPT

data 폴더 바로 아래의 CSV 파일마다 무엇을 기록한 데이터인지 표로 정리해 줘. 하위 폴더는 이름만 적어 줘.
표 열: 파일명 | 행 수 | 주요 컬럼 | 추정 측정 대상
data_private 폴더는 열지 마. 아직 아무 파일도 수정하지 마.

파일을 콕 집을 때는 @ — 예:

@data/hthp_run_log.csv 이 파일의 컬럼을 설명해 줘

편집기에서 줄을 선택하고 Alt+K를 누르면 그 줄 범위가 @참조로 들어갑니다.

예상 결과: Claude 패널에 CSV가 정리된 표와 하위 폴더 이름. 그 위에 파일을 읽은 기록(Read, PowerShell 등)이 접힌 줄로 보입니다. 하나를 펼쳐 Claude가 실제로 무엇을 실행했는지 확인합니다.

• CSV 6개가 모두 표에 나오고 data_private는 열지 않았다

diff 승인과 되돌리기

• diff 화면에서 변경 단위로 Accept this change(받기) / Reject this change(거부)를 고릅니다.
• 모르면 승인하기 전에 묻습니다: "이 변경이 무엇을 하는지 한 줄씩 설명해 줘"
• 되돌리기: 되돌리고 싶은 시점의 내 메시지에 마우스 → 되감기 버튼 → Rewind code to here (대화는 두고 코드만). Claude가 실행한 스크립트가 만든 파일(예: 결과 CSV)은 되돌리기 대상이 아닙니다.

데이터 보안 — 무엇이 전송되나

• 보내는 것: 내 프롬프트 · CLAUDE.md, Claude가 열어 본 파일 내용, 명령 실행 결과 출력, VS Code 편집기에서 선택한 텍스트 · 열린 파일 이름
• 코드 실행은 내 노트북에서 일어납니다. 폴더 전체가 올라가지 않습니다.
• 실데이터 파일은 편집기에서 열거나 패널로 드래그하지 않습니다.
• 대화 기록은 사용자 폴더 아래 .claude\projects에 30일간 남습니다.

데이터 보안 — 실데이터를 넣기 전 3단계

1. 규정 확인 — 지도교수·과제 책임자에게 외부 AI 서비스 사용 가능 여부를 묻습니다. 산학과제는 협약서 보안 조항이 기준입니다.
2. 줄이고 가리기 — 공개 가능한 구간만, 또는 컬럼명·장비명·고객사·날짜를 바꾼 익명화본을 씁니다. 물리량의 단위와 크기는 그대로 둡니다. 익명화 스크립트는 Claude에게 컬럼 이름만 알려 주고 "파일은 열지 말고 스크립트만 써 줘"라고 한 뒤, 실행은 내가 터미널에서 직접 합니다.
3. 원본은 밖에 — 미공개 원본은 작업 폴더 밖에 둡니다. 폴더 안에 둬야 한다면 A4에서 읽기 차단 규칙을 겁니다.

모르면 넣지 않습니다. 오늘 실습 데이터는 전부 교육용 가상 데이터입니다.

A0에서 막히면: 짝에게 먼저 묻고, 같은 화면에서 5분 이상 멈추면 빨강을 붙입니다(아래 '막혔을 때 모음').

A1. 실습① 운전 로그 전처리

좋은 지시의 6요소

A1 · STEP 1/4 — 데이터 훑어보기: 먼저 묻고, 고치지 않습니다 (5분)

할 일 컬럼·단위·결측 현황을 표로 받고, 이상한 컬럼을 Claude가 먼저 지목하게 합니다.

PROMPT

@data/hthp_run_log.csv 를 읽고 다음을 표로 정리해 줘.
1) 컬럼 이름 | 추정 물리량 | 추정 단위 | 결측 개수 | 최솟값 | 최댓값
2) 값의 범위가 물리적으로 이상해 보이는 컬럼과 그 이유
파일은 수정하지 마.

13,000행을 화면에 다 띄우지 않습니다. Claude는 보통 짧은 Python 코드로 요약만 뽑아 봅니다. 그 코드를 실행해도 되는지 묻는 창이 뜨면 읽어 보고 승인합니다.

예상 결과: 컬럼 요약 표와, 범위가 이상해 보이는 컬럼에 대한 지적

• 요약 표가 나오고, 이상한 컬럼이 1개 이상 지목된다

A1 · STEP 2/4 — Plan 모드: 코드보다 계획을 먼저 (5분)

할 일 /plan 으로 시작해 전처리 계획만 받습니다. 아직 승인하지 않습니다.

PROMPT

/plan 운전 로그 전처리 스크립트 scripts/preprocess.py 를 만들 계획을 세워 줘.
- 결측: 보간하지 말고 flag만 남겨
- 스파이크: 판정 기준을 제안하고 근거를 적어
- 압력 단위 혼재(kPa/bar): 어떻게 판정할지 제안해
- 압축기 정지 구간: 어떤 컬럼으로 구분할지 제안해
- 결과는 out/run_clean.csv, data 폴더 원본은 수정 금지
- 어떤 행도 지우지 말고 처리 내용은 flag 컬럼에 남겨 (출력 행 수 = 입력 행 수)
- Python은 반드시 py 로 실행

예상 결과: 계획이 Markdown 문서로 편집기에 열리고, 문단 옆에 코멘트를 달 수 있는 화면. 프롬프트 박스 아래 모드 표시가 Plan

• 계획 문서가 열리고, 아직 파일이 하나도 안 바뀌었다

계획에 다는 코멘트 (예시 — 내 판단으로 고쳐 씁니다)

코멘트를 다 달았으면 Send feedback and keep planning → 다시 받은 계획이 마음에 들면 승인

A1 · STEP 3/4 — 실행: 변경을 하나씩 승인 (15분)

할 일 계획을 승인하면 Claude가 코드를 쓰고 실행합니다. Manual이라 단계마다 묻습니다.

승인 창 순서: ① scripts/preprocess.py 생성 → diff 읽고 승인 ② py scripts/preprocess.py 실행 → 승인 ③ 오류가 나면 Claude가 스스로 읽고 고침 → 다시 승인 ④ 처리 요약 출력

PROMPT · 요약이 안 나오면 이어서 입력

처리 요약을 표로 보여 줘. 결측 · 스파이크 · 단위 변환 · 정지 구간 flag별 행 수와 전체 대비 비율.

같은 승인 창이 반복되면 "Yes, and don't ask again"(이 명령은 다시 묻지 않기)을 쓸 수 있습니다. 단, 이 선택은 세션이 끝나도 이 폴더에 남고(/permissions에서 삭제), 옵션에 보이는 명령 패턴 단위로 허용됩니다. 패턴이 넓으면 고르지 않습니다.

예상 결과: 탐색기 out 폴더에 run_clean.csv 생성. 패널에 flag별 행 수 표

• out/run_clean.csv가 생기고 처리 요약 표가 나온다

A1 · STEP 4/4 — 나온 숫자를 의심합니다 (8분)

할 일 "잘 처리했습니다"를 믿지 말고 증거를 요구합니다.

PROMPT

처리 결과를 그대로 믿기 전에 확인하고 싶어.
1) 압력 단위를 바꾼 구간에서 처리 전후 값을 5행 나란히
2) flag 비율을 날짜별로 집계해서 특정 기간에 몰려 있는지
3) 처리 후 각 컬럼의 최솟값·최댓값이 물리적으로 말이 되는지
세 가지를 표로 보여 줘. 해석은 표 다음에 3줄 이내로.

표를 보고 납득되지 않는 값이 있으면 그 행을 짚어서 다시 묻습니다. "이 행은 왜 정상으로 남았어?"

예상 결과: 단위 변환 전후 비교 표, 날짜별 flag 비율 표, 컬럼별 범위 점검 표

• 세 표가 나오고, out/run_clean.csv가 12,960행이며 처리 후 P_suc_kPa·P_dis_kPa 최솟값이 모두 1,000 kPa 이상이다

방금 한 것: 정의 → 계획 → 실행 → 검증

A1 결과가 끝내 안 나오면 배포 페이지의 cp-A1.zip을 C:\hthp-lab에 풀어 덮어쓰고 A2부터 합류합니다. 받은 스크립트와 내 것이 어떻게 다른지 Claude에게 비교시켜 보면 좋습니다.

A2. 실습② 검증 게이트 3종

• Q_water = ṁ_w · c_p · (T_w,out − T_w,in) · Q_ref = ṁ_ref · (h_in − h_out), 엔탈피는 CoolProp(CO2)
• 허용치는 계측 불확도로 정합니다. 3% = 합성 불확도 약 0.7% × 2 + 열손실 여유 (실습 데이터 기준)
• 탈락한 행은 지우지 않고 gate_fail 컬럼에 어떤 게이트인지 남깁니다. 버린 이유가 다음 분석의 재료입니다.

자세한 내용은 별도 '게이트 치트시트'를 봅니다.

A2 · STEP 1/3 — 게이트 함수 만들기 (10분)

할 일 게이트 3개를 한 파일에 함수로 만듭니다. 함수마다 물리적 의미를 주석으로 남깁니다.

PROMPT

scripts/gates.py 를 만들어 줘. 게이트 3개를 각각 함수로.
① energy_balance: |Q_water − Q_ref| / Q_water < 0.03
Q_water = m_w_kgs × 4.19 × (T_w_out_C − T_w_in_C)
Q_ref의 엔탈피는 가스냉각기 입출구 냉매 상태로 CoolProp(CO2)에서
② carnot_limit: COP ≤ T_h / (T_h − T_c), 온도는 반드시 켈빈
COP = Q_water / W_comp_kW, T_h = T_w_out_C, T_c = T_src_in_C
③ pinch_positive: 가스냉각기 모든 노드에서 T_ref − T_water > 0
통과 못 한 행은 지우지 말고 gate_fail 컬럼에 게이트 이름을 기록해.
함수마다 물리적 의미를 주석 한 줄로 달아 줘.

승인 전 확인: 카르노 함수에 + 273.15가 들어 있습니까? 없으면 거부하면서 승인 창 아래 입력칸에 이유("온도를 켈빈으로 바꾸지 않았어")를 적습니다(터미널 CLI에서는 Tab으로 코멘트 칸을 엽니다).

예상 결과: scripts/gates.py diff — 함수 3개, 각 함수 위에 "# 물이 받은 열 = 냉매가 내준 열" 같은 한 줄 주석

• gates.py가 생기고 함수 3개와 주석이 보인다

A2 · STEP 2/3 — 게이트 통과시키기: 전후를 숫자로 (12분)

할 일 전처리 결과와 가스냉각기 데이터에 게이트를 적용하고, 적용 전후를 비교합니다.

PROMPT

out/run_clean.csv 에 게이트 ①②를, data/gascooler_profile.csv 에 게이트 ③을 적용해 줘.
운전 로그 결과는 out/run_gated.csv, 가스냉각기 결과는 out/gc_gated.csv 로 저장하고 다음을 표로 보여 줘.
- 게이트별 탈락 행 수와 비율(분모는 게이트 평가 행 수)
- 게이트 적용 전후 COP의 최댓값·평균
- COP는 flag와 상관없이 결측이 아닌 모든 행에서 계산하고, 결측 행은 게이트 평가에서 빼

예상 결과: 게이트별 탈락 행 수·비율 표와 적용 전후 COP 최댓값·평균 표

• 적용 전 최대 COP 11.8, 적용 후 최대 4.2~4.4, 게이트③ 탈락이 운전점 3개다

숫자가 옆 사람과 다르면 어느 규칙이 다른지 비교해 봅니다.

A2 · STEP 3/3 — 왜 걸렸는지 묻기: 결론보다 근거 먼저 (10분)

할 일 탈락 행이 어떤 조건에 몰려 있는지 분석시킵니다. 표가 먼저, 해석은 나중입니다.

PROMPT

gate_fail 행이 어떤 운전 조건에 몰려 있는지 분석해 줘.
날짜별, 압축기 정지 여부, 열원 입구 온도 구간별로 게이트별 탈락 비율 표를 먼저 보여 주고, 그다음에 해석을 3줄 이내로 적어 줘.
해석마다 근거가 된 표의 행을 같이 적어.

한 번 더 — 반대 증거 요구

이 해석이 틀렸다면 데이터에서 무엇이 보여야 해? 그게 있는지 확인해 줘.

예상 결과: 게이트별·조건별 탈락 비율 표와, 근거 행 번호가 붙은 3줄 해석

• 표가 먼저 나오고, 해석 3줄마다 근거 표의 행이 적혀 있다

AI를 믿는 것이 아니라 게이트를 믿습니다

1. 결론보다 근거 표 먼저 — "해석 전에 근거가 된 표를 먼저 보여 줘." 해석의 숫자를 표에서 직접 찾습니다.
2. 반대 증거를 요구 — "이 결론이 틀렸다면 데이터에서 무엇이 보여야 해?"
3. 법칙으로 자동 검사 — 에너지 보존과 제2법칙은 AI의 의견이 아니라 판정 기준입니다. 간이 카르노 같은 경험 기준은 '의심 신호'로 구분합니다.

내 데이터의 게이트 찾기 — 세 질문

게이트에 너무 많이 걸려도 "게이트를 통과하게 고쳐 줘"라고 하지 않습니다. 기준을 풀기 전에 원인부터 찾고, 기준 변경은 사람이 결정합니다.

A2 결과가 끝내 안 나오면 배포 페이지의 cp-A2.zip을 C:\hthp-lab에 풀어 덮어쓰고 A3부터 합류합니다.

A3. 실습③ 논문용 Figure

반복 생산은 코드로, 마지막 미세 조정은 Origin으로 — 섞어 써도 됩니다.

A3 · STEP 1/3 — Figure 1: 온도 프로파일과 핀치 주석 (12분)

할 일 가스냉각기 길이 방향 온도 분포에 핀치 위치를 표시한 그림을 만듭니다.

PROMPT

out/gc_gated.csv 로 논문용 Figure 1을 그려 줘.
- x: 무차원 길이 (0~1), y: 온도 (°C)
- 게이트③ 통과 운전점 중 대표 3개, 냉매는 실선·물은 점선
- 각 운전점의 핀치 위치에 화살표와 ΔT 값 주석
- 폭 90 mm, Arial 8 pt, 흑백 인쇄에서도 구분되게
- figures/fig1_profile.pdf 와 600 dpi PNG로 저장
- 그리는 코드는 scripts/fig1_profile.py

승인 전 확인: 냉매선이 모든 위치에서 물선보다 위에 있습니까?

예상 결과: 냉매 온도(실선)가 위, 물 온도(점선)가 아래인 곡선 3쌍. 핀치 지점마다 화살표와 ΔT 주석

• figures 폴더에 PDF·PNG 두 파일이 생긴다

A3 · STEP 2/3 — Figure 2: 오프디자인 COP 산점도 (10분)

할 일 게이트 통과 데이터로 COP 산점도를 그리고, 탈락 점도 숨기지 않고 함께 보여 줍니다.

PROMPT

out/run_gated.csv 로 Figure 2를 그려 줘.
- x: 열원 입구 온도 (°C), y: COP
- 게이트 통과 점은 물 출구 온도로 색을 입히고 컬러바 표시
- 게이트 탈락 점은 회색 빈 원으로 함께 표시 (숨기지 마)
- Figure 1과 같은 규격, figures/fig2_cop.pdf 와 600 dpi PNG로 저장
- 코드는 scripts/fig2_cop.py

예상 결과: 물 출구 온도로 색을 입힌 점 구름, 그 주변의 회색 빈 원(탈락 점), 오른쪽 컬러바

• fig2_cop.pdf가 생기고 탈락 점이 회색으로 보인다

A3 · STEP 3/3 · 선택 — 한 군데만 고치기: "다른 건 바꾸지 마" (8분)

할 일 Origin 그림과 나란히 놓고 차이를 찾아, 딱 그 부분만 고칩니다. STEP 2를 끝낸 사람만 하고, 나머지는 강사 시연을 본 뒤 과제에서 해 봅니다.

PROMPT

Figure 2를 Origin 그림처럼 두 가지만 고쳐 줘. 다른 건 바꾸지 마.
1) 눈금을 축 안쪽으로
2) 위쪽·오른쪽 축에도 눈금 표시
같은 파일명으로 다시 저장하고, 무엇을 바꿨는지 두 줄로 알려 줘.

Origin에서 마무리하고 싶다면:

Figure 2에 쓴 데이터를 Origin에서 바로 열 수 있게 figures/fig2_data.csv 로 저장해 줘. 첫 줄은 단위가 붙은 열 이름으로.

예상 결과: 왼쪽 Origin으로 그린 그림, 오른쪽 수정된 fig2_cop.pdf를 나란히 놓은 비교 화면

• scripts/fig2_cop.py의 diff에서 바뀐 줄이 눈금 설정뿐이다

그림이 나오면 승인 전에 한 번 묻습니다: "이 그림, 물리적으로 말이 되나?"

A3 그림이 끝내 안 나오면 배포 페이지의 cp-A3.zip을 C:\hthp-lab에 풀어 덮어쓰고 A4부터 합류합니다.

A4. CLAUDE.md — 연구실 작업 규칙

CLAUDE.md에 적는 여섯 가지: 단위 규약 · 물성 라이브러리 · 그림 규격 · 검증 규칙 · 금지 사항(보안) · AI 사용 기록(연구윤리). 매번 지켜야 하는 것만, 200줄 이하로.

A4 · STEP 1/3 — /init: 초안은 Claude가 씁니다 (5분)

할 일 프롬프트 박스에 /init 을 입력해, 폴더를 분석한 CLAUDE.md 초안을 받습니다.

PROMPT

/init

Claude가 폴더 구조와 scripts 폴더의 코드를 읽고 CLAUDE.md를 만듭니다. 이미 CLAUDE.md가 있으면 덮어쓰지 않고 고칠 점을 제안합니다. 초안에는 '어떻게 실행하는가'가 주로 담깁니다. '우리 연구실 규칙'은 다음 STEP에서 사람이 넣습니다.

예상 결과: 탐색기 맨 위에 CLAUDE.md 생성, 편집기에 폴더 구조·실행 명령 등이 정리된 초안

• hthp-lab 폴더 맨 위에 CLAUDE.md가 생긴다

A4 · STEP 2/3 — 우리 규칙 넣기 (8분)

할 일 오늘 실습에서 정한 규칙을 CLAUDE.md에 추가합니다.

PROMPT

CLAUDE.md에 아래 규칙을 추가해 줘. 200줄을 넘기지 마.
[실행] Python은 py로 실행
[단위] 계산은 SI, 온도 계산은 K, 압력은 kPa
[물성] 냉매 물성은 CoolProp만 사용 (CO2)
[검증] 결과 보고 전 scripts/gates.py 게이트 3종 통과. 탈락은 삭제 말고 gate_fail. 기준 변경은 나에게 먼저 물어
[그림] 폭 90 mm, Arial 8 pt, PDF와 600 dpi PNG. 게이트 탈락 점은 회색 빈 원으로 함께
[금지] data 폴더 원본 수정 금지, data_private 폴더 읽기 금지
[기록] 작업이 끝나면 logs/AI_USAGE.md 에 날짜 | 요청 요약 | 생성·수정 파일을 한 줄 추가
[질문] 확실하지 않은 컬럼·단위·형식은 추측하지 말고 나에게 물어

결과 예시 — CLAUDE.md 일부

## 실행
- Python은 py
## 단위
- 계산은 SI, 온도는 K, 압력은 kPa
## 검증
- 보고 전 gates.py 3종 통과
- 탈락은 gate_fail, 기준 변경은 확인 후
## 그림
- 90 mm, Arial 8 pt, PDF+PNG
- 탈락 점은 회색 빈 원
## 금지
- data/ 원본 수정
- data_private/ 읽기
## 기록
- logs/AI_USAGE.md에 한 줄

• CLAUDE.md에 8개 항목이 모두 들어간다

CLAUDE.md는 '부탁', 차단은 '설정'

.claude/settings.json (프로젝트 폴더 안). 직접 쓰지 말고 다음 STEP에서 Claude에게 만들게 합니다.

{
  "permissions": {
    "deny": [
      "Read(/data_private/**)",
      "Edit(/data/**)"
    ]
  }
}

• /로 시작하는 경로 = 프로젝트 폴더 기준
• 막는 것: Claude의 파일 읽기·편집 도구, @참조, Bash의 cat·head 같은 일부 명령
• 못 막는 것: Python 스크립트가 파일을 직접 여는 경우. PowerShell 명령도 막힌다는 보장이 없습니다
• 가장 확실한 방법은 미공개 원본을 작업 폴더 밖에 두는 것입니다

A4 · STEP 3/3 — 차단 설정을 걸고, 새 대화에서 시험 (8분)

할 일 설정 파일을 만든 뒤 /clear 로 새 대화를 열고, 규격을 말하지 않은 채 시켜 봅니다.

PROMPT ① 설정 만들기

.claude/settings.json 을 만들어서 data_private 폴더 읽기와 data 폴더 편집을 deny로 막아 줘.

PROMPT ② /clear 입력 후, 새 대화에서 (입력창 아래 모드가 Manual인지 먼저 확인)

out/run_gated.csv 로 외기 온도(T_amb_C)와 COP의 산점도를 Figure 3으로 그려 줘. 코드는 scripts/fig3_amb.py 로.

PROMPT ③ 같은 대화에서

@data_private/secret_run.csv 첫 5줄을 보여 줘.

Claude가 Python 등으로 우회해 읽으려는 승인 창이 뜨면 거부를 누릅니다. 그것이 deny가 '못 막는 것'입니다.

예상 결과: ③ 요청에 설정 때문에 읽을 수 없다는 도구 오류가 뜬 패널. Claude가 "규칙상 안 읽겠습니다"라고만 답하면 아직 설정을 시험하지 않은 것입니다

• ② 규격을 말하지 않았는데 새 스크립트에 90 mm·Arial 8 pt·PDF 저장·회색 탈락 점이 들어 있다
• ③ 설정(deny) 때문에 읽을 수 없다는 도구 오류가 떴다
• logs/AI_USAGE.md에 한 줄이 늘었다

프롬프트는 얼마나 자세히?

빗나간 답이 잦다면: 목적과 확인 방법을 적었는가 · 반복 규칙이 CLAUDE.md에 있는가 · 큰 작업을 Plan 없이 시작했는가

낯선 툴(CONVERGE·EnSight·Origin 등)의 파일

1. 샘플 보여 주기 — 툴이 내보낸 결과 파일을 @로 지정해 앞부분 구조를 읽힙니다
2. 매뉴얼 주기 — 출력 형식 설명 페이지를 docs 폴더에 넣고 @로 지정합니다
3. 대조하기 — 읽어 들인 값을 원본 파일 세 군데와 직접 비교합니다
4. 기록하기 — 알아낸 형식을 CLAUDE.md '파일 형식' 절에 적어 다음엔 설명을 생략합니다

프롬프트에 한 줄: "확실하지 않은 형식은 추측하지 말고 나에게 물어."

A4를 못 끝냈으면 배포 페이지의 cp-A4.zip을 C:\hthp-lab에 풀어 덮어쓰고 A5부터 합류합니다.

A5. 오늘 한 일을 /analyze-run 하나로

스킬은 업무 매뉴얼입니다. 한 번 가르치고, 다음부터는 입력 파일만 바꿔서 맡깁니다. 검수에서 부족한 점이 나오면 결과물이 아니라 매뉴얼(SKILL.md)을 고칩니다.

SKILL.md 구조 (.claude/skills/analyze-run/SKILL.md) — 손으로 쓸 필요는 없고, 읽을 줄만 알면 됩니다.

---
name: analyze-run
description: 히트펌프 운전 로그 CSV를 전처리, 게이트 ①② 검증, COP 산점도, 요약표까지 처리
disable-model-invocation: true
argument-hint: [CSV 경로]
---
입력 파일: $ARGUMENTS
1. 컬럼·단위 점검 표를 먼저 보여 준다 (모르는 컬럼은 묻는다)
2. scripts/preprocess.py로 전처리 (삭제 대신 flag)
3. scripts/gates.py로 게이트 ①② 적용
4. Figure 2를 CLAUDE.md 규격으로 저장
5. 결과는 out/<입력 파일명>/ 에 모은다
6. 게이트별 탈락 비율과 확인할 점 3가지 보고

• name: /analyze-run 으로 부르는 이름 · description: Claude가 언제 쓸지 판단하는 설명 · disable-model-invocation: true면 내가 부를 때만 실행 · $ARGUMENTS: 커맨드 뒤에 쓴 파일 경로가 들어갈 자리

A5 · STEP 1/2 — 커맨드 만들기: 오늘 한 일을 매뉴얼로 (10분)

할 일 오늘 만든 스크립트와 CLAUDE.md를 엮어 /analyze-run 스킬로 저장합니다.

PROMPT

scripts 폴더의 preprocess.py, gates.py, fig2_cop.py와 CLAUDE.md를 읽고, 운전 로그 처리 순서(전처리 → 게이트 ①② → Figure 2 → 요약표)를 /analyze-run 스킬로 만들어 줘.
- 위치: .claude/skills/analyze-run/SKILL.md
- 입력은 CSV 경로 하나($ARGUMENTS), 결과는 out/<파일명>/ 에
- 첫 단계는 컬럼·단위 점검 표. data/hthp_run_log.csv와 이름이 다른 컬럼은 추측하지 말고 나에게 묻고, 답을 받은 뒤 진행해
- 요약표는 out/<파일명>/summary.csv 로 저장하고 게이트별 탈락 비율과 확인할 점 3가지를 보고해
- 스크립트가 입력 파일과 출력 폴더를 인자로 받게 고치고, 원래 데이터로 다시 돌려 결과가 같은지 확인해
- 탈락은 flag로만, 내가 부를 때만 실행되게 disable-model-invocation: true

예상 결과: 프롬프트 박스에 / 를 입력했을 때 뜨는 목록에 analyze-run이 보이는 화면

• 프롬프트 박스에 / 를 쳤을 때 목록에 analyze-run이 보인다 (안 보이면 /reload-skills, 그래도 없으면 새 대화)

A5 · STEP 2/2 · 강사 시연 — 처음 보는 로그에 재실행 (시연 4분)

할 일 강사 화면으로 봅니다. 여러분은 집에서 과제 첫 단계로 똑같이 입력합니다.

PROMPT · 과제 첫 단계에서 그대로 입력 (Edit automatically 모드)

/analyze-run data/hthp_run_log_b.csv

지켜볼 장면: 이 파일에는 처음 보는 컬럼 이름이 하나 있습니다. Claude가 추측해서 넘어가는지, CLAUDE.md의 [질문] 규칙대로 여러분에게 묻는지 지켜봅니다.

예상 결과: 탐색기 out/hthp_run_log_b/ 폴더에 정리 CSV, 게이트 결과, fig2, 요약표가 생긴 화면

• (과제 때) out/hthp_run_log_b/에 run_gated.csv·fig2_cop.pdf·summary.csv가 생긴다

A5 체크포인트

• / 를 쳤을 때 analyze-run이 보인다
• SKILL.md에 "모르는 컬럼은 묻기"와 out/<파일명>/이 있다
• 강사 시연에서 처음 보는 컬럼 장면을 봤다

A5를 오늘 못 만들었으면 배포 페이지의 cp-A5.zip을 C:\hthp-lab에 풀어 덮어씁니다. 과제는 여기서 시작합니다.

과제 (11월 7일 토요일 22:00까지)

내가 만든 파이프라인을 내 데이터에 한 번 통과시켜 옵니다. 60분이 넘으면 멈추십시오. ① 막힌 장면 하나만 내도 제출입니다. 자세한 내용은 '과제 안내문'을 봅니다.

제출: hthp.ilhae.ai → 제출 · 제출 폼에서 화면 공개 동의 여부를 고릅니다(화면 공개 / 수치를 가린 사본만 / 비공개) · 실데이터는 A0의 3단계를 거친 것만

막혔을 때 모음

강사 호출 기준: 짝과 같이 봐도 같은 화면에서 5분 이상 멈췄을 때, Claude가 같은 오류를 3번 반복하면 먼저 되감기 후 /plan으로 다시, 그래도 안 될 때