Claude.ai Projects 검토 워크플로우 — PPT 빌드 직전 5 자리 검증
별칭: Review Workflow · 검토 워크플로우 · 5 자리 검증
05 — Claude.ai Projects 검토 워크플로우 가이드
★ 기준 지침: 본 가이드는
06_PPT_Slide_Build_Spec.md의 빌드 직전 품질 검증 자리 — 자동 빌드 (Step D, python-pptx) 의 마지막 안전망. 선행 단계:00_Claude_Projects_Setup_Guide.md§1~§3 (Projects 셋업) 완료 본 가이드 발동 시점: 06 spec 작성 완료 후, .pptx 빌드 직전 다음 단계: 본 가이드 통과 → Step D (python-pptx 빌드) → Step E (vibe.llmwiki.kr/ppt/ 배포)
0. 왜 검토 워크플로우인가
| 이유 | 설명 |
|---|---|
| AI 출력의 검증 부재 | Claude Code 가 작성한 강사 멘트·시각 가이드·트랜지션은 자동 검증 ❌ — 사람의 마지막 점검 필요 |
| 빌드 직전 안전망 | 빌드 후 발견되는 오류는 재빌드 비용 큼 — 빌드 직전 검토가 가장 효율적 |
| 200K 컨텍스트 활용 | Claude.ai Projects 의 대용량 컨텍스트 + 대화형 검토 = 5~10 슬라이드 한 채팅 검토 가능 |
| 빌더와 검토자 분리 | 작성한 Claude Code 와 검토하는 Claude.ai Projects 가 분리 → 객관적 점검 효과 |
| 강의 품질 보장 | 49 슬라이드 강의의 품질 KPI 직접 영향 |
→ 검토 통과 슬라이드만 빌드 → 빌드 실패율 ↓ / 강의 품질 ↑.
1. 4 단계 워크플로우
1.1. Step 1 — Projects 에 06 파일 업로드
1. claude.ai → 좌측 [Projects] → 기존 프로젝트 또는 새로 만들기
→ 권장: "Vibe Coding 강의 — 국민대 2026-05-11" (00 가이드 §2.1 에서 박은 자리)
2. [+ Add Content] → 06 파일 업로드:
d:/Dropbox (개인용)/wiki_강의_vibe_coding/96_ppt_lecture/20260511 국민대 강의/06_PPT_Slide_Build_Spec.md
3. (선택) 함께 업로드 권장:
- 02_Slide_Content_and_Script.md (기획·대본 컨텍스트)
- INTRO_5slides_guide_원본.md (사용자 지침 원본 — Ground Truth)
- 01_PPT_Planning_Prompt.md (시스템 프롬프트)
→ 컨텍스트 풍부할수록 검토 정확도 ↑.
1.2. Step 2 — 검토 프롬프트 박음 (5 자리 검토 기준)
새 채팅 시작 → 다음 프롬프트 박음:
06_PPT_Slide_Build_Spec.md 의 [Slide 1] 부터 [Slide N] 까지 *위 → 아래* 순서로
다음 5 자리 검토해주세요:
A. 텍스트 (대제목·중제목·본문)
→ 명료성 / 길이 / 청중 적합성
B. 화면 구성·시각 자료
→ 90 분 강의 (도입부 / 라떼는 / 돌개 / 모방 / 마무리) 자리에 적합한지
C. 강사 멘트
→ 자연 구어체인지 / 시간 (40~100 초) 안에 박힐 수 있는지
→ 화면 글씨 그대로 읽기 ❌ 검증
D. 트랜지션
→ 다음 슬라이드 진입이 부드러운지
E. ppt-edge-accent-dark 정합
→ 색·폰트·레이아웃이 스킬 표준에 맞는지
→ 검정 배경 / 맑은 고딕 / 22-20-16-14pt / 줄간격 1.5
각 슬라이드별 판정:
- ✅ 그대로 가도 좋은 자리
- ⚠️ 수정 권장 자리 (구체적 수정 의견 포함)
- ❌ 큰 재작성 필요 자리 (재작성 방향 제시)
산출 형식: 각 슬라이드별 "검토 메모" 작성
→ 06 파일에 *그대로 붙여넣기* 가능한 형식
1.3. Step 3 — Projects 에서 검토·반복
| 흐름 | 행동 |
|---|---|
| 슬라이드 1 검토 | Claude.ai 가 5 자리 (A~E) 분석 + 판정 |
| 수정 의견 박음 | 사용자가 동의 또는 추가 의견 제시 |
| 슬라이드 2 → N | 같은 패턴 반복 (200K 컨텍스트로 한 채팅 가능) |
| 대화형 발전 | 의견 충돌 시 사용자가 결정자 — 검토는 제안 일 뿐 |
권장 배치 크기: 한 채팅에 5~10 슬라이드 (200K 컨텍스트 안전 한도).
1.4. Step 4 — 검토 결과 본 세션 (Claude Code) 으로 가져옴
검토 결과를 06 파일에 반영하는 3 가지 방법:
| 방법 | 의미 | 권장 |
|---|---|---|
| A | Claude.ai 산출 복사 → 본 세션에서 "06 파일에 반영해줘" 박음 → 본 세션이 자동 반영 | ⭐ 권장 |
| B | 06 파일의 각 슬라이드 § 끝의 ### 검토 메모 자리에 사용자가 직접 붙여넣기 | 안전 |
| C | 검토 결과를 별 파일 06_Review_Notes.md 로 저장 → 본 세션이 06 와 합쳐서 갱신 | 점진적 |
권장: 방법 A — 빠르고 정합 정확. 본 세션이 검토 의견을 해당 슬라이드 자리 에 자동 반영하면서 동시에 통과/수정/재작성 상태도 갱신.
2. Custom Instructions 추가 권장 (Projects 측)
Projects 의 Custom Instructions 에 다음 내용 추가 (00 가이드 §2.2 에 박힌 기존 지침과 함께 작동):
본 검토 작업 시 추가 정합:
- 강의 표어 "AI-Native Vibe Coding: No Design, No Code" 정합 강조
- 청중: 국민대 컴퓨터공학과 3·4학년 (90 분 특강)
- 강사: 돌개 (시니어 + AI Native 복귀자, 41 년 경력)
- 5 단 구성:
· 1단 도입부 (5 슬라이드, 10 분)
· 2단 Part 1 라떼는 (10 슬라이드, 17 분)
· 3단 Part 2 돌개 (20 슬라이드, 40 분)
· 4단 Part 3 모방 (11 슬라이드, 15.5 분)
· 5단 마무리 (3 슬라이드, 7.5 분)
- "박음" 어휘 자제 (작성·기록·반영·표시·포함 등 일반 한국어 사용)
- 강사 멘트 기준:
· 자연 구어체 / 화면 글씨 그대로 읽기 ❌
· 비유·예시 박음 권장
· 시간 한도 (40~100 초) 준수
- ppt-edge-accent-dark 스킬 정합:
· 검정 배경 (#000000)
· 골드 (#FFD700) — 강조 1~2 자리/슬라이드
· 네온 그린 (#39FF14) — 진화·새 흐름
· 코랄 (#FF8B6E) — 아이콘/일러스트 한정
· 맑은 고딕 단일 / 22-20-16-14pt / 줄간격 1.5
→ 검토 정확도 + 본 강의 정체성 정합 동시 보장.
3. 본 세션 (Claude Code) 복귀 명령 일람
검토 끝나고 본 세션 복귀 시 다음 중 하나로 박음:
| 명령 | 본 세션 동작 |
|---|---|
| "Claude.ai 검토 결과 박았어. 06 파일에 반영해줘" | 본 세션이 검토 결과를 06 파일 각 슬라이드 자리에 반영. 검토 메모 § 갱신 |
| "5 슬라이드 모두 approved. 빌더 진행해줘" | builders/ppt_vibe_lib.py + build_intro_5slides.py 작성 + python-pptx 빌드 시작 |
| "Slide 3 만 수정 박았어, 다른 자리 그대로" | 부분 갱신 (3 번 슬라이드만 06 갱신, 나머지 유지) |
| "검토 결과 요약 보여줘" | 본 세션이 06 의 검토 메모 § 만 추출하여 요약 |
| "재검토 필요 슬라이드만 알려줘" | ⚠️ 또는 ❌ 판정 자리만 추출 |
4. 참조 자리 (검토 시 4 파일)
| 파일 | 역할 |
|---|---|
06_PPT_Slide_Build_Spec.md ★ | 검토 대상 — 슬라이드 빌드 spec + 강사 멘트 |
02_Slide_Content_and_Script.md | 기획·대본 (참조 — 변경 시점·근거 추적) |
INTRO_5slides_guide_원본.md | 사용자 지침 원본 (도입부 5 슬라이드 — Ground Truth) |
01_PPT_Planning_Prompt.md | 시스템 프롬프트 (Phase 1·2·3 양식) |
00_Claude_Projects_Setup_Guide.md | 셋업 SSOT |
→ 06 만 수정 대상, 나머지는 읽기만.
5. 검토 KPI — 통과 기준 (5/5)
| # | 검토 항목 | 통과 기준 |
|---|---|---|
| 1 | A 텍스트 | 대제목 ≤ 12 단어 / 본문 ≤ 60 단어 / 청중 (대학생 3·4학년) 어휘 적합 |
| 2 | B 시각 자료 | 슬라이드 1 자리에 주요 시각 1 개 / 보조 시각 ≤ 3 / 도식 라인아트 우선 |
| 3 | C 강사 멘트 | 자연 구어체 (강연톤) / 시간 한도 / 화면 글씨 그대로 읽기 ❌ |
| 4 | D 트랜지션 | 다음 슬라이드 진입 한 줄 / 의문형·연결형 자연스러움 |
| 5 | E ppt-edge-accent-dark 정합 | 색·폰트·레이아웃 6 단 위계 (대제목·중제목·소제목·본문·부연·각주) 정합 |
→ 5/5 통과 시 ✅ approved → Step D (빌드) 진입 가능. → 4/5 이하 ⚠️ → 사용자 결정 (수정 후 재검토 / 그대로 진행). → 3/5 이하 ❌ → 재작성 필요.
6. 빈도·배치·시점
6.1. 검토 빈도
49 슬라이드 전체를 한 번에 검토 ❌ (compute 제한 + 200K 컨텍스트 안전 한도). 섹션별 배치 검토:
| 배치 | 단 | 슬라이드 | 매수 | 권장 채팅 수 |
|---|---|---|---|---|
| 1 | 1단 도입부 | INT-01 ~ INT-05 | 5 | 1 채팅 |
| 2 | 2단 라떼는 | VCH-01 ~ VCH-10 | 10 | 1~2 채팅 |
| 3a | 3단 돌개 — 시간 | VBC-T-1 ~ T-5 | 5 | 1 채팅 |
| 3b | 3단 돌개 — 공간 | VBC-S-1 ~ S-5 | 5 | 1 채팅 |
| 3c | 3단 돌개 — 연결 | VBC-C-1 ~ C-5 | 5 | 1 채팅 |
| 3d | 3단 돌개 — 검증 | VBC-V-1 ~ V-5 | 5 | 1 채팅 |
| 4 | 4단 모방 | IMI-01 ~ 09a/09b ~ IMI-10 | 11 | 1~2 채팅 |
| 5 | 5단 마무리 | CLN-01 ~ CLN-03 | 3 | 1 채팅 |
| 합 | 49 | 8~10 채팅 |
6.2. 검토 시점
| 시점 | 행동 |
|---|---|
| 06 spec 첫 작성 직후 | 1차 전수 검토 (8~10 채팅) — 가장 큰 자리 |
| 수정 후 재검토 | 변경 슬라이드만 부분 검토 (1~2 채팅) |
| 빌드 직전 최종 점검 | 통합 점검 (1 채팅) — 5/5 통과 확인 |
→ 본 가이드의 4 단계는 반복 작동 가능 (검토 → 수정 → 재검토 사이클).
7. 검토 워크플로우 → 빌드 진입 다리
[06 spec 작성 완료]
↓
[Step 1] Projects 업로드
↓
[Step 2] 검토 프롬프트 박음 (5 자리 A~E)
↓
[Step 3] Projects 에서 검토·반복 (8~10 채팅)
↓
[Step 4] 검토 결과 본 세션 (Claude Code) 반영
↓
[5/5 통과?]
├─ ✅ → Step D (python-pptx 빌드) → Step E (배포)
└─ ⚠️/❌ → 06 spec 수정 → Step 2 로 회귀
8. 운영 체크리스트 — 사용자용
검토 시작 전 다음 5 자리 확인:
- 06 spec 파일 작성 완료
- Projects 에 06 + (02 + 원본 지침) 업로드 완료
- Custom Instructions 갱신 (§2 추가 정합 박힘)
- 검토 프롬프트 (§1.2) 준비
- 본 세션 복귀 명령 (§3) 머릿속에 박힘
→ 5/5 ✅ 시 검토 시작.
9. 본 가이드와 다른 가이드 정합
| 가이드 | 역할 | 본 05 와의 관계 |
|---|---|---|
| 00 Claude Projects Setup | 프로젝트·Custom Instructions 셋업 SSOT | 본 가이드 발동 전제 — Projects 가 이미 셋업되어 있어야 함 |
| 01 PPT Planning Prompt | Phase 1·2·3 시스템 프롬프트 | 02 산출의 입력 자리 — 본 가이드와 직접 무관 |
| 02 Slide Content & Script | 기획·대본 (49 슬라이드) | 06 의 원천 자료 — 본 가이드 검토 시 참조 |
| 03 HTML PPT | Placeholder | Step E 배포 시 갱신 — 본 가이드와 무관 |
| 06 PPT Slide Build Spec ★ | 빌드 spec — 본 가이드 검토 대상 | 본 가이드의 input·output 자리 |
| 05 Review Workflow (본 가이드) | 검토 절차서 | 06 의 품질 검증 안전망 |
→ 5 가이드가 한 파이프라인 으로 정합: 00 (셋업) → 01 (프롬프트) → 02 (기획) → 05 (검토 절차) → 06 (빌드 spec) → 03/.pptx (산출).
10. 다음 단계
본 가이드 박음 완료 → 다음 작업 자리:
- 06 spec 작성 — 02 의 49 슬라이드 기획을 빌드 spec 형식으로 변환 (python-pptx 자동화 친화)
- 06 작성 완료 시점에 본 가이드 §1~§7 발동 — 8~10 채팅 검토 → 본 세션 반영
- 5/5 통과 시 Step D 빌드 —
builders/ppt_vibe_lib.py+ 단별 builder 스크립트 작성 - Step E 배포 —
vibe.llmwiki.kr/ppt/자�