Claude.ai Projects 검토 워크플로우 — PPT 빌드 직전 5 자리 검증
Concept (개념)aidraft2026-05-10

Claude.ai Projects 검토 워크플로우 — PPT 빌드 직전 5 자리 검증

별칭: Review Workflow · 검토 워크플로우 · 5 자리 검증

#review#claude-ai-projects#ppt-pipeline#quality-gate

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 가지 방법:

방법의미권장
AClaude.ai 산출 복사 → 본 세션에서 "06 파일에 반영해줘" 박음 → 본 세션이 자동 반영⭐ 권장
B06 파일의 각 슬라이드 § 끝의 ### 검토 메모 자리에 사용자가 직접 붙여넣기안전
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)

#검토 항목통과 기준
1A 텍스트대제목 ≤ 12 단어 / 본문 ≤ 60 단어 / 청중 (대학생 3·4학년) 어휘 적합
2B 시각 자료슬라이드 1 자리에 주요 시각 1 개 / 보조 시각 ≤ 3 / 도식 라인아트 우선
3C 강사 멘트자연 구어체 (강연톤) / 시간 한도 / 화면 글씨 그대로 읽기 ❌
4D 트랜지션다음 슬라이드 진입 한 줄 / 의문형·연결형 자연스러움
5E ppt-edge-accent-dark 정합색·폰트·레이아웃 6 단 위계 (대제목·중제목·소제목·본문·부연·각주) 정합

→ 5/5 통과 시 ✅ approved → Step D (빌드) 진입 가능. → 4/5 이하 ⚠️ → 사용자 결정 (수정 후 재검토 / 그대로 진행). → 3/5 이하 ❌ → 재작성 필요.


6. 빈도·배치·시점

6.1. 검토 빈도

49 슬라이드 전체를 한 번에 검토 ❌ (compute 제한 + 200K 컨텍스트 안전 한도). 섹션별 배치 검토:

배치슬라이드매수권장 채팅 수
11단 도입부INT-01 ~ INT-0551 채팅
22단 라떼는VCH-01 ~ VCH-10101~2 채팅
3a3단 돌개 — 시간VBC-T-1 ~ T-551 채팅
3b3단 돌개 — 공간VBC-S-1 ~ S-551 채팅
3c3단 돌개 — 연결VBC-C-1 ~ C-551 채팅
3d3단 돌개 — 검증VBC-V-1 ~ V-551 채팅
44단 모방IMI-01 ~ 09a/09b ~ IMI-10111~2 채팅
55단 마무리CLN-01 ~ CLN-0331 채팅
498~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 PromptPhase 1·2·3 시스템 프롬프트02 산출의 입력 자리 — 본 가이드와 직접 무관
02 Slide Content & Script기획·대본 (49 슬라이드)06 의 원천 자료 — 본 가이드 검토 시 참조
03 HTML PPTPlaceholderStep E 배포 시 갱신 — 본 가이드와 무관
06 PPT Slide Build Spec빌드 spec — 본 가이드 검토 대상본 가이드의 input·output 자리
05 Review Workflow (본 가이드)검토 절차서06 의 품질 검증 안전망

→ 5 가이드가 한 파이프라인 으로 정합: 00 (셋업) → 01 (프롬프트) → 02 (기획) → 05 (검토 절차) → 06 (빌드 spec) → 03/.pptx (산출).


10. 다음 단계

본 가이드 박음 완료 → 다음 작업 자리:

  1. 06 spec 작성 — 02 의 49 슬라이드 기획을 빌드 spec 형식으로 변환 (python-pptx 자동화 친화)
  2. 06 작성 완료 시점에 본 가이드 §1~§7 발동 — 8~10 채팅 검토 → 본 세션 반영
  3. 5/5 통과 시 Step D 빌드builders/ppt_vibe_lib.py + 단별 builder 스크립트 작성
  4. Step E 배포vibe.llmwiki.kr/ppt/ 자�