매주 쓰는 실험 보고서, AI 프로젝트로 끝내기

일러두기

이 책은 2026년 8월 29일 한 시간 동안 실제로 진행한 실습을 그대로 옮긴 교재다. 실습이 끝났을 때 작업 폴더에 남아 있던 파일 14개를 스냅샷으로 보존하고, 그 파일들이 어떤 순서로, 어떤 프롬프트로 만들어졌는지를 모듈별로 되짚는다. 그래서 이 책의 예시는 꾸며 낸 것이 아니라 실제 산출물의 발췌다. v1.1에서는 실습 세션에 없던 두 모듈 — 검증(Perplexity, 모듈 6)과 자료 RAG(NotebookLM, 모듈 7) — 을 더했다. 이 두 모듈의 예시는 교육용으로 새로 만든 것이다.

대상 독자와 준비물

실습용 샘플 파일 내려받기

이 책의 사례 폴더를 그대로 실습에 쓸 수 있도록 웹판 페이지(aiedu.gdiaxhub.com/book/chem-lab)의 실습용 샘플 파일에서 ZIP(chem-lab-samples-v1.zip) 또는 파일별로 내려받을 수 있다. ZIP을 풀면 일반화학실험보고서-샘플/ 폴더가 생기며, 모듈 4에서 VS Code로 여는 폴더에 그대로 넣으면 된다.

표기 규칙

개인정보와 가상 자료

• 스냅샷에 들어 있던 학생 이름과 학번은 이 책에서 ○○○, 2026XXXXXX로 가렸다.
• 20260829_산염기적정/ 폴더의 실험 자료(조원, 측정값, 회의록)는 AI가 만든 연습용 가상 데이터다. 각 파일 첫 줄에 그 사실이 적혀 있다. 실제 제출 때는 그 줄을 지우고 본인 측정값으로 바꾼다.
• 양식의 원본인 아스피린 합성 보고서는 실제 제출본이다. 서식만 참고하고 내용은 옮겨 쓰지 않는다.

이 책의 사례 폴더

실습이 끝났을 때의 작업 폴더는 다음과 같았다. 이 책 전체가 이 폴더 하나를 설명한다.

일반화학실험보고서/
├── 샘플보고서형식-아스피린합성.hwpx   ← 서식의 원본 (지난 학기 보고서, 모듈 2)
├── 샘플보고서형식-아스피린합성.pdf    ← 위 파일의 PDF (컨텍스트용, 모듈 2)
├── 프로젝트지침.md                     ← 양식을 분석해 만든 지침 프롬프트 (모듈 1·4)
├── 20260829_산염기적정/               ← 8월 29일 실험 한 세트 (모듈 4)
│   ├── 00_실험개요.md
│   ├── 01_회의록_실험전.md
│   ├── 02_실험원자료.md
│   ├── 03_계산정리.md
│   ├── 04_회의록_실험후.md
│   ├── 05_보고서초안.md
│   └── 06_실험보고서.hwpx              ← 완성본
├── 실험보고서작성대.html               ← "웹 서비스 만들어 줘"의 결과 (모듈 5)
├── hwpx_변환.py                        ← JSON → hwpx 변환기 (모듈 5)
└── README.md                           ← 폴더 사용 설명서 (모듈 5)

0.1 세 가지 작업 환경

실습을 시작할 때 화면에는 Claude와 ChatGPT가 둘 다 열려 있었다. 두 도구 모두 채팅창에서 그냥 써도 되지만, 학기 내내 같은 양식의 보고서를 내야 한다면 이야기가 다르다. 매번 양식을 설명하고 지난 대화를 다시 붙여 넣는 일이 반복되기 때문이다.

0.2 오늘 한 시간의 산출물 지도

오늘 만드는 것은 도구 사용법이 아니라 파일이다. 한 시간이 끝났을 때 폴더에는 다음 여섯 종류가 남아야 한다.

0.3 완성본 먼저 보기

이 책의 목표 지점을 먼저 본다. 왼쪽은 양식의 원본인 지난 학기 보고서, 오른쪽은 실습 끝에 만들어진 새 보고서의 첫 부분이다. 머리글 두 줄, 가운데 제목, 네 개의 번호 섹션이 같다는 점이 핵심이다.

                  수업시간: 수요일6,7 학번: 2026XXXXXX 조: 6조 이름: ○○○
                                              실험 날짜; 8월 29일 토요일

산-염기 적정을 이용한 식초 중 아세트산의 정량
1. 초록
　본 실험은 산-염기 중화 반응을 이용하여 시판 식초에 포함된 아세트산을 정량하고,
그 결과를 제품 표시값과 비교함으로써 적정법의 원리와 정량 분석의 신뢰도 평가 방법을
이해하는 것을 목적으로 수행되었다. …

1.1 지침과 컨텍스트

프로젝트를 열면 오른쪽에 지침이 있다. 지침은 프롬프트다. "어떻게, 어떤 형식으로, 어떤 문체로 쓸 것인가"를 적는다. 그 아래 컨텍스트에는 자료를 올린다. 수업 시간에 받은 PDF, 실험 자료, 그리고 수업 녹음을 글로 옮긴 텍스트가 여기에 들어간다.

1.2 따라하기 — 양식을 분석시켜 지침 받기

첨부한 실험 보고서는 내가 거의 매주 쓰는 양식이다.
이 문서의 스타일을 분석해서, 같은 양식으로 보고서를 쓰게 하는
프로젝트용 지침 프롬프트로 자세히 써 줘.

반드시 포함할 것:
- 머리글·제목·섹션 구성과 각 섹션의 순서
- 문단 수와 분량, 각 문단이 시작하는 문형
- 문체(어미, 인칭, 금지 표현), 숫자·단위·화학식 표기
- 표의 형식과 계산식을 쓰는 방식
- 지어내면 안 되는 것과 데이터가 없을 때의 처리

아직 실험 자료가 없다. 산-염기 적정 실험이 있었다고 가정하고,
가상의 측정값으로 위 지침대로 보고서를 한 편 써 줘.

1.3 실제 결과 — 지침에 담긴 것

실습에서 만들어진 지침은 A4 두 쪽 분량이다. 전문은 부록 D에 있고, 여기서는 지침이 무엇을 고정했는지만 본다.

## 역할
너는 금오공과대학교 일반화학실험 수강생의 실험 보고서 작성을 돕는 조교다.
사용자가 실험명·측정값·실험 과정을 주면, 아래 형식과 문체를 정확히 그대로
따르는 완성된 보고서를 작성한다.

## 출력 형식 (항상 이 구조를 지킬 것)
수업시간: {요일}{교시} 학번: {학번} 조: {조}조 이름: {이름}
                                    실험 날짜; {월}월 {일}일 {요일}
                          {실험 제목}
1. 초록
2. 실험 결과 정리
3. 결론
4. 참고 문헌

1.4 실패와 복구

2.1 문제 — 교수의 세 가지 요구

2.2 HWP를 HWPX로

2.3 AI가 내놓는 파일 형식

실습에서 "HWPX로 만들어 줄 수 있어?"라고 물었다. Claude는 한참 "확인해 보겠다"며 시도한 끝에 HWPX 파일을 내놓았지만 한글에서 열리지 않았다. 그래서 "마크다운으로 만들어 줘"로 바꿨다. 이 순서를 기억한다.

2.4 수식 — 두 개의 언어

이 대응표는 실습 마지막에 만들어진 hwpx_변환.py의 변환 규칙에서 그대로 옮긴 것이다(모듈 5).

보고서의 계산식을 LaTeX 형식으로 써 줘.
Overleaf에 붙여 넣으면 그대로 컴파일되는 식으로.

같은 계산식을 한글 수식 편집기용 스크립트로 써 줘.
분수는 {a} over {b}, 곱하기는 TIMES 문법을 쓴다.
계산 과정은 문자식 = 대입식 = 답 순서로 한 줄에.

M(NaOH) = n(KHP) / V = (0.4082 / 204.22) / 0.02015 = 0.09920 M
C(원액) = M(NaOH) × V / V(분취) × 희석배수 = (0.09908 × 0.01263) / 0.02500 × 20 = 1.001 M
질량 백분율(%) = 아세트산 질량 / 용액 질량 × 100 = 60.13 / 1005 × 100 = 5.98 %

2.5 왜 PDF로 제출하는가

한글 파일을 그대로 주면 받는 쪽 환경에 따라 수식 개체와 글꼴이 깨진다. 교수가 PDF를 요구하는 이유가 그것이다. 한글에서 수식까지 넣고 확인한 뒤 파일 → PDF로 저장하기로 마무리한다. 순서는 항상 "AI 초안 → 한글에서 편집·수식 → PDF"다.

3.1 같은 구조, 다른 이름

3.2 따라하기

소스에 올린 샘플 보고서의 양식을 참고해서 산-염기 적정 실험의
가상 보고서를 지침대로 작성해 줘.
수식은 한글 수식 편집기용 스크립트로 써 줘.

3.3 비교 관찰표

두 결과를 보고 직접 채운다. 정답은 없고, 이번 학기 내가 어느 쪽을 먼저 열지 정하는 근거가 된다.

3.4 고쳐 달라고 말하기

- 초록이 네 문단이다. 세 문단, 500~700자로 다시 써 줘.
- 3문단에 "재미있었다"가 있다. 지침의 문체 규칙대로 소감 표현 없이 고쳐 줘.
- 결과표 오른쪽 열은 계산값만 두어야 한다. 원자료를 왼쪽으로 옮겨 줘.

4.1 왜 폴더인가

4.2 따라하기 A — 설치와 폴더 열기

4.3 따라하기 B — Claude Code 설치와 로그인

4.4 따라하기 C — 첫 대화와 권한

이 폴더의 문서를 파악해 봐.

첫 작업에서 Claude Code는 "파일을 내 마음대로 만져도 되느냐"고 묻는다. 세 가지 중 하나를 고른다.

실습에서 놀란 점 하나는 Claude Code가 HWPX 파일을 읽어 냈다는 것이다. 채팅 프로젝트에서 실패했던 형식이 폴더에서는 읽혔다. 압축을 풀어 XML 본문을 읽기 때문이다.

@샘플보고서형식-아스피린합성.hwpx 를 보고,
이 양식대로 보고서를 쓰게 하는 프로젝트 지침을 마크다운 파일로 만들어 줘.

4.5 조작 치트시트

4.6 따라하기 D — 날짜별 실험 세트 만들기

여기서부터가 매주 반복할 부분이다. 실습에서는 아직 실제 실험 자료가 없었으므로 "8월 29일 실험이 있었다고 가정"하고 가상 자료부터 만들게 했다.

2026년 8월 29일에 산-염기 적정 실험이 있었다고 가정하고,
@20260829_산염기적정 폴더에 실험 개요, 실험 전·후 회의록,
원자료 기록지, 계산 정리를 각각 마크다운 파일로 만들어 줘.
모든 문서 첫 줄에 "가상 자료"임을 표시해.

- [x] KHP 몰질량 204.22 g/mol — 교재 부록표와 대조 확인
- [x] 뷰렛 소비량 = 최종 − 초기, 4회 모두 재계산 일치
- [x] 표준편차를 n−1(표본표준편차)로 계산했는지 확인 → 정정 없음
- [x] 희석 배수 20배 적용 누락 여부 확인 → 적용됨
- [x] 유효숫자: 뷰렛 4자리(12.63), KHP 4자리 → 최종 결과 3자리(5.98 %)로 통일

## 미해결 / 보고서에서 다룰 점
1. 1회차 과적정 데이터를 버린 근거를 본문에 명시할 것 (임의 배제가 아니라 사전 합의된 기준).
2. w/w와 w/v 중 어느 기준으로 비교할지 결론에서 명확히 밝힐 것.

@03_계산정리.md 의 계산식을 LaTeX로, 그리고 한글 수식 편집기용으로 각각 변환해 줘.
적정 소비량 3회를 차트로 그리고, 실험 순서를 SVG 순서도로 그려 줘.

@20260829_산염기적정 폴더의 자료로, @프로젝트지침.md 의 형식대로
보고서를 작성해 05_보고서초안.md로 저장하고,
@샘플보고서형식-아스피린합성.hwpx 의 서식을 그대로 써서 06_실험보고서.hwpx로 만들어 줘.

2. 실험 결과 정리
KHP의 질량(1회, g)        0.4082     NaOH 표준용액의 농도(M)     0.09908
KHP의 질량(2회, g)        0.4113     희석 식초의 농도(M)         0.05007
식초 분취량/희석 부피(mL)  5.00/100.0 원액 식초의 농도(M)         1.001
적정 소비량 평균(mL)      12.63      아세트산의 질량 백분율(%)   5.98
 식초의 밀도: 1.005 g/mL,  적정 소비량의 표준편차: 0.076 mL (RSD 0.60 %)

4.7 실패와 복구

5.1 바이브 코딩

실험 보고서 작성용 웹 서비스를 만들어 줘.

실습에서는 이 한 문장만 보냈다. Claude Code는 폴더의 지침과 샘플을 이미 알고 있었으므로 맥락을 따로 설명하지 않았다.

5.2 실제 결과 — 파일 세 개

python hwpx_변환.py 보고서.json              # 보고서.hwpx 로 저장
python hwpx_변환.py 보고서.json 제출본.hwpx   # 이름 지정

5.3 Codex 확장 설치

두 개를 모두 두는 이유는 사용량이다. 한쪽 한도가 차면 다른 쪽에서 이어서 한다. 실습에서도 "최대한 써라, 모자라면 옮겨라"가 원칙이었다.

5.4 과제

주기율표를 시각화하고, 원소를 누르면 그 원소를 설명하는 페이지로 가는
웹 서비스를 만들어 줘. 추가로,
- 원소 두 개를 골라 조합하면 어떤 화합물이 만들어지는지 보여 주고
- 그 화합물의 성질(산·염기, 상태, 용도)을 표시하고
- 예: H와 O를 고르면 H₂O가 만들어지는 과정을 시각화한다.

과제의 요령은 "무엇을 만들지"보다 "열어서 무엇이 보여야 하는지"를 적는 것이다. 위 프롬프트의 마지막 줄처럼 구체적인 예 하나를 넣으면 결과가 크게 좋아진다.

6.1 보고서의 바깥에 있는 사실

폴더 안의 측정값(뷰렛 눈금, 질량)은 모듈 4의 검산으로 끝난다. 그러나 보고서에는 폴더 밖에서 온 사실도 들어 있다.

6.2 따라하기

다음 값들을 공식 물성 DB나 교과서 원문에서 확인해 줘.
- KHP(프탈산수소칼륨)의 몰질량
- 페놀프탈레인의 변색 pH 범위
[출력] 값 | 단위·조건 | 원문 제목 | 발행처 | 직접 URL
[규칙] 원문에서 찾지 못하면 '확인 불가'로 표시하고 추정하지 않는다.
블로그·요약 사이트가 아니라 원출처를 우선한다.

다음 참고문헌이 실제로 존재하는지 확인해 줘. 저자, 정확한 제목, 판, 출판사,
해당 내용이 있는 장을 원문 서지 기준으로 알려 줘. 없으면 '실존 확인 불가'로.
D. C. Harris, Quantitative Chemical Analysis, 9th ed.

6.3 실패와 복구

7.1 RAG — 올린 자료 안에서만

7.2 따라하기

05_보고서초안의 수치와 사실 주장을 하나씩 뽑아,
각 주장이 다른 소스(교재·원자료·지침) 어디에 근거하는지 대조 표로 만들어 줘.
[출력] 주장 | 근거 소스·인용 | 일치/불일치/소스에 없음
[규칙] 소스에 없는 내용은 일반 지식으로 채우지 말고 '소스에 없음'으로 표시해.

이 노트북의 소스로 산-염기 적정 시험 대비 요약 브리핑과
예상 문답(FAQ) 10개를 만들어 줘. 각 답에 소스 인용을 붙여 줘.

7.3 실패와 복구

6.1 주간 루틴

6.2 제출 전 점검표

지침(부록 D)의 규칙을 점검 항목으로 바꾼 것이다. 매주 같은 표를 쓴다.

6.3 폴더 관리 세 가지

A. 프롬프트 모음

이 책에 나온 프롬프트를 순서대로 모았다. 주황색 부분만 바꿔 쓴다.

B. 파일 형식

C. 한글 수식 스크립트 치트시트

hwpx_변환.py의 latex_to_eqn() 규칙을 표로 옮겼다.

실습 사례의 식 세 개:

M(NaOH) = {n(KHP)} over {V} = {{0.4082} over {204.22}} over {0.02015} = 0.09920 M
C(원액) = {M(NaOH) TIMES V} over {V(분취)} TIMES 20 = {0.09908 TIMES 0.01263} over {0.02500} TIMES 20 = 1.001 M
질량 백분율(%) = {아세트산 질량} over {용액 질량} TIMES 100 = {60.13} over {1005} TIMES 100 = 5.98 %

D. 프로젝트지침.md 전문

스냅샷의 프로젝트지침.md를 그대로 옮겼다. 실명·학번은 들어 있지 않다.

수업시간: {요일}{교시} 학번: {학번} 조: {조}조 이름: {이름}
                                    실험 날짜; {월}월 {일}일 {요일}

                          {실험 제목}

1. 초록
2. 실험 결과 정리
3. 결론
4. 참고 문헌

- 대한화학회, 「일반화학실험」, 자유아카데미, {해당 실험} 부분.
- 금오공과대학교 일반화학실험Ⅰ, 「{N}주차 {실험명}」, {연도}, p.{쪽}~{쪽}.

E. 스냅샷 파일 목록

2026-08-29 실습 종료 시점 폴더의 파일과 SHA-256 앞 12자. 원본은 docs/textbook/chem-lab-sample/snapshot-2026-08-29/에 보존되어 있다.

F. 용어