파일이 생성되었다고 성공은 아니다: 검증하고 테스트하며 파이프라인 완성하기
2026.06.01
📒 소개
앞선 글에서는 작게 만든 강의준비 파이프라인을 범용적으로 사용할 수 있도록 다시 살펴보기 시작했고, HWPX 강의계획서의 서식 문제도 수정했습니다.
하지만 여기서 끝내기에는 마음이 놓이지 않았습니다.
파일이 만들어진다고 해서 파이프라인이 완성된 것은 아니기 때문입니다.
특히 강의준비 파이프라인은 여러 단계가 이어져 있습니다.
강의 요청 정리
↓
강의계획서 생성
↓
HWPX 제출 문서 생성
↓
PPTX 교안 생성
여기서 어느 한 단계라도 조용히 실패하면, 겉으로는 파일이 생성되어도 실제 수업 자료에는 문제가 생길 수 있습니다.
그래서 마지막으로 하고 싶었던 일은 명확했습니다.
실제 강의를 넣어보고, 단일 차시와 다차시 모두 테스트하면서, 문제가 생기면 원인까지 수정하고 다시 검증하기
이번 글은 파이프라인을 검증하고, 테스트하고, 수정하는 과정을 반복하며 전체 흐름을 안정화한 마무리 기록입니다.
▶️ 진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
이번에는 기존 파이프라인을 바로 믿지 않고, 검증계획을 기준으로 실제 산출물을 만들어보며 확인했습니다.
도구 | 활용 방식 |
|---|---|
Claude Code Plan Mode | 수정 전 검증 계획 수립 |
Codex | 파이프라인 구조 분석과 수정 방향 점검 |
Python | HWPX 생성 코드 검증 및 가드 추가 |
Node.js / pptxgenjs | PPTX 교안 생성 테스트 |
한컴오피스 한글 | 생성된 HWPX 파일 열림과 서식 확인 |
Git | 수정 결과를 커밋으로 기록 |
이때 /lesson-intake도 함께 검증했습니다.
다만 /lesson-intake는 처음부터 있던 기능이 아니라, HWPX 생성 보강 이후 강의 내용 입력 단계에서 _요청서 양식.md를 매번 수동 작성하는 일이 번거로워서 나중에 추가한 입력 자동화 단계입니다.
사용한 프롬프트 1: 전체 검증 계획 세우기
지금부터는 바로 코드를 수정하지 말고 plan mode로 진행해줘.
현재 강의준비 파이프라인이 단일 차시와 다차시 강의 모두에서 안정적으로 작동하는지 검증하고 싶어.
검증 범위는 다음과 같아.
1. 요청서 생성 단계가 정상인지
2. lesson-prep이 요청서를 읽고 강의자료를 생성하는지
3. HWPX 강의계획서가 양식에 맞게 생성되는지
4. PPTX 교안이 정상적으로 생성되는지
5. 파일이 생성되더라도 내용 누락이나 셀 충돌 같은 조용한 실패가 없는지
6. 문제가 발견되면 증상만 고치지 말고 재발 방지까지 포함해서 수정해줘.
이 프롬프트의 핵심은 “바로 수정하지 말고 먼저 검증하라”는 것이었습니다.
기능을 계속 붙이다 보면 파이프라인이 잘 돌아가는 것처럼 보일 수 있습니다. 하지만 실제로는 특정 경우에만 성공하거나, 파일 안쪽에서 일부 내용이 빠질 수 있습니다.
그래서 이번에는 검증 대상을 두 가지로 나누었습니다.
시나리오 A: 단일 차시 강의
시나리오 B: 다차시 강의
1차 테스트: 단일 차시 강의
먼저 단일 차시 강의로 테스트했습니다.
마이크로비트로 우리 교실 온습도 측정하기
대상: 초등 5~6학년
시간: 90분
확인한 항목은 다음과 같습니다.
단계 | 확인 내용 | 결과 |
|---|---|---|
요청서 | 필수 항목과 섹션 구조 | 정상 |
조합 설정 | 강의 스타일, 수업 형태, 양식, 테마 선택 | 정상 |
HWPX | 강의계획서 생성 및 열림 | 정상 |
PPTX | 교안 생성, 슬라이드 수와 파일 크기 확인 | 정상 |
단일 차시 경로는 큰 문제 없이 통과했습니다.
2차 테스트: 다차시 강의에서 문제 발견
다음은 다차시 강의였습니다.
스스로 달리는 로봇: 링크비트 카 자율주행 4차시
대상: 초등 3~4학년
형태: 4차시 수업
PPTX 교안 생성은 정상적으로 보였습니다.
하지만 HWPX 강의계획서를 확인하는 과정에서 문제가 발견되었습니다.
다차시 강의계획서에서 일부 차시 내용이 제대로 들어가지 않았습니다.
특히 4차시 내용이 조용히 누락되는 문제가 있었습니다.
겉으로는 파일이 생성되었기 때문에 성공처럼 보였지만, 실제로는 내용이 빠진 상태였습니다.
원인: 옛 양식 기준 좌표가 코드에 남아 있었다
문제를 추적해보니 원인은 HWPX 양식 구조와 코드의 매핑이 맞지 않는 것이었습니다.
현재 기본 HWPX 템플릿은 6행 구조를 기준으로 정리되어 있었습니다.
그런데 코드 안에는 예전 9행 양식에서 사용하던 다차시 좌표가 남아 있었습니다.
현재 템플릿: 6행 구조
기존 코드 일부: 예전 9행 양식 기준 좌표 사용
결과: 일부 셀 범위 초과, 셀 충돌, 4차시 누락
더 위험했던 점은 이 문제가 오류로 멈추지 않았다는 것입니다.
파일은 만들어졌고, 명령도 성공한 것처럼 끝났습니다.
하지만 안쪽 내용은 일부 빠져 있었습니다.
이때 가장 크게 느낀 것이 있습니다.
조용한 실패가 가장 위험하다.
사용한 프롬프트 2: 조용한 실패를 막는 수정 요청
다차시 HWPX 생성에서 일부 차시 내용이 누락되는 문제가 있어.
현재 문제를 단순히 데이터만 바꿔서 통과시키지 말고,
다음에 같은 문제가 생기지 않도록 코드 차원에서 막아줘.
조건은 다음과 같아.
1. 행이나 열 범위를 벗어나는 매핑이 있으면 오류로 알려줘.
2. 같은 셀에 서로 다른 데이터가 중복으로 들어가면 오류로 알려줘.
3. 문제가 있을 때는 파일을 생성하지 말고 실패 처리해줘.
4. 오류 메시지에는 어떤 키가 어떤 셀에서 문제가 생겼는지 보여줘.
5. 정상 단일 차시와 정상 다차시 흐름에는 영향이 없도록 회귀 테스트해줘.
이 요청을 바탕으로 fill_lesson_form.py에 가드를 추가했습니다.
수정 방향은 단순했습니다.
이전: 문제가 있어도 skip 또는 성공 처리
수정: 범위 초과·셀 충돌 감지 시 오류 출력 후 중단
이제 데이터와 양식이 맞지 않으면 조용히 넘어가지 않고, 코드가 스스로 멈추고 이유를 말해주게 되었습니다.
문서와 기준도 함께 수정
코드만 고친다고 끝은 아니었습니다.
이번 검증에서 문서와 기준도 함께 수정했습니다.
첫째, lesson-prep/SKILL.md에 다차시 작성 방식을 명확히 정리했습니다.
단일 차시와 다차시 모두 교육내용 리스트를 사용한다.
리스트 요소 1개는 한글 셀 안의 한 줄로 들어간다.
세부 항목은 줄 단위로 나누고, 단계 사이에는 빈 줄을 넣을 수 있다.
둘째, 검증 기준도 현실화했습니다.
처음에는 PPTX 파일 크기를 1MB 이상으로 잡았지만, 실제 생성된 PPTX는 텍스트와 도형 중심이라 1MB가 되지 않는 경우가 있었습니다.
그래서 기준을 바꿨습니다.
PPTX 크기 기준: 1MB 이상 → 50KB 이상
슬라이드 수 기준: 35~45장 고정 → 30장 이상
여기서 또 하나 배웠습니다.
검증 기준도 검증 대상이다.
너무 비현실적인 기준은 정상 산출물도 실패로 판단하게 만들 수 있었습니다.
최종 실사용 테스트
마지막으로 실제 강의 주제를 넣어 전체 흐름을 다시 확인했습니다.
일반인을 위한 AI 이해: LLM AI와 에이전틱 AI
대상: 성인 입문자 20명
시간: 120분
테마: modern
결과는 정상적으로 생성되었습니다.
산출물 | 결과 |
|---|---|
HWPX 강의계획서 | 정상 생성, 한글에서 확인 |
PPTX 교안 | 40장 생성 |
교육내용 줄바꿈 | 한글 셀 안에서 깔끔하게 표시 |
이 테스트를 통해 단일 차시, 다차시, 실제 강의 주제까지 전체 흐름이 안정적으로 잡힌 것을 확인했습니다.
결과와 배운 점
결과
이번 검증과 수정 과정을 통해 파이프라인은 다음 상태가 되었습니다.
구분 | 결과 |
|---|---|
단일 차시 경로 | 통과 |
다차시 경로 | 오류 발견 후 수정, 통과 |
발견한 핵심 문제 | 다차시 HWPX에서 4차시 내용 조용히 누락 |
재발 방지 | 코드 가드, 안내 문서 수정, 검증 기준 현실화 |
최종 확인 | 실제 AI 입문 특강으로 HWPX와 PPTX 생성 확인 |
처음에는 파일이 만들어지는지만 보려고 했지만, 최종적으로는 “다시 같은 문제가 생기지 않게 막는 것”까지 확인했습니다.
🎁 배운 점과 나만의 꿀팁
이번 과정에서 가장 크게 배운 것은 세 가지입니다.
1. 파일 생성은 성공의 끝이 아니다
자동화에서 파일이 생성되면 성공처럼 보입니다.
하지만 이번에는 파일 안쪽에서 4차시 내용이 빠지는 문제가 있었습니다.
그래서 앞으로는 이렇게 확인하려고 합니다.
생성되었는가?
열리는가?
내용이 모두 들어갔는가?
서식이 유지되는가?
오류가 조용히 넘어가지 않는가?
2. 증상 해결과 원인 해결은 다르다
이번 문제도 데이터 형식만 바꾸면 당장은 통과시킬 수 있었습니다.
하지만 예전 좌표 매핑이 코드에 남아 있다면 다음에 또 같은 문제가 생길 수 있었습니다.
그래서 데이터만 고치는 대신, 코드가 잘못된 매핑을 감지하도록 수정했습니다.
3. 검증은 한 번이 아니라 반복이다
이번 과정은 한 번에 끝나지 않았습니다.
계획하기
↓
테스트하기
↓
오류 발견하기
↓
수정하기
↓
다시 테스트하기
↓
문서와 기준까지 정리하기
이 반복을 거치면서 파이프라인이 점점 믿을 수 있는 구조가 되었습니다.
😒 과정 중에 어떤 시행착오를 겪었나요?
가장 큰 시행착오는 “겉으로 성공한 결과”를 처음에는 너무 쉽게 믿었다는 점입니다.
HWPX도 만들어지고 PPTX도 만들어지면 성공이라고 생각하기 쉬웠습니다.
하지만 다차시 HWPX에서 4차시가 빠지는 문제처럼, 실제 자료로 열어보지 않으면 모르는 문제가 있었습니다.
또 하나는 검증 기준이 너무 이상적이었다는 점입니다.
처음에는 PPTX 크기를 1MB 이상으로 잡았지만, 이미지가 적고 도형과 텍스트 중심이면 정상 파일도 1MB가 되지 않았습니다.
그래서 실제 산출물을 기준으로 검증 기준을 다시 조정했습니다.
🎇 도움이 필요한 부분이 있나요?
아직 더 발전시키고 싶은 부분은 남아 있습니다.
HWPX 양식이 여러 개일 때 자동 선택하는 방식
PPTX 디자인 테마를 더 쉽게 추가하는 구조
활동지 PDF 자동 생성 연결
새 기능을 추가할 때마다 돌릴 수 있는 검증 체크리스트
파이프라인 전체를 더 쉽게 설명하는 사용 가이드
현재는 전체 흐름이 잡혔고, 이제부터는 기능을 더 붙이기보다 유지 가능한 구조로 다듬는 것이 중요하다고 느꼈습니다.
🎉 앞으로의 계획이 있다면 들려주세요.
이번 연재를 통해 제 강의준비 파이프라인은 다음 흐름까지 정리되었습니다.
작게 시작하기
↓
HWPX 생성 기능 보강하기
↓
범용화 필요성 발견하기
↓
HWPX 서식 기준 다시 잡기
↓
검증하고 테스트하며 안정화하기
아직 완벽한 파이프라인은 아닙니다.
하지만 이제는 어디가 핵심 흐름이고, 어디를 조심해서 확장해야 하는지 보이기 시작했습니다.
앞으로는 이 파이프라인을 실제 강의 준비에 계속 사용하면서, 반복되는 부분은 더 자동화하고 강의 스타일과 양식은 더 유연하게 선택할 수 있도록 다듬어가려고 합니다.
도움 받은 글
이번 글은 앞에서 작성한 글들과 이어지는 마무리 기록입니다.
이번 과정을 한 문장으로 정리하면 이렇게 남길 수 있을 것 같습니다.
자동화는 파일을 만드는 데서 끝나는 것이 아니라, 실패를 발견하고 다시 반복하지 않게 만드는 과정까지 포함해야 완성된다.




다차시 HWPX에서 4차시가 조용히 누락되는 문제를 발견하고, 증상만 고치는 대신 코드 가드까지 추가하신 흐름이 인상적이에요. "조용한 실패가 가장 위험하다"는 통찰과 함께 검증 기준까지 현실화하신 부분에서 파이프라인을 오래 유지 가능하게 만드시는 시야가 느껴집니다. 이 검증 패턴 자체가 다른 자동화 작업에도 두루 쓰일 것 같아요.