steffen74/to-slides

슬라이드 만들기

하나의 유닛에 대한 슬라이드를 빌드합니다. COURSE-CANVAS.md, RESOURCES.md, DECISIONS.md, AGENTS.md의 ## 에이전트 기반 코스 생성 섹션, 그리고 해당 유닛의 승인된 세션 플랜과 참여자 페이지를 읽습니다. 슬라이드는 항상 플랜을 기반으로 빌드되며, 그 반대는 성립하지 않습니다. 세션 플랜이 아직 승인되지 않은 경우 중단하고 /draft-unit을 제안합니다.

1. 형식을 한 번 정하기

형식은 일반적으로 /setup-course에서 정해집니다. AGENTS.md에 Slides: 줄이 없으면, 기존 자료(이전 덱, 블록 5의 도구)를 바탕으로 추천과 함께 질문합니다:

• 형식 및 도구: 예: claude.ai Slides 아티팩트, .pptx, Google Slides, 마크다운 슬라이드(Marp, reveal.js).

• 덱 위치 및 시청자: 수업 중에만 표시되거나, 이후 참가자에게 공개됩니다. 공개된 덱은 참가자 자료입니다.

• 템플릿: 참고할 기존 덱 또는 디자인 시스템입니다.

• 아웃라인 위치: 세션 플랜 옆에 있는 비공개 폴더(예: slides/<unit>-outline.md)를 권장합니다. 아웃라인에는 샘플 답변이 포함되기 때문입니다.

답변을 - Slides: <format>, <deck location>, <outline location>, <published to participants: yes|no>, template <link> 형식으로 AGENTS.md에 작성하고 DECISIONS.md에 기록합니다.

2. 플랜에서 아웃라인 만들기

슬라이드보다 먼저 아웃라인을 해당 파일에 작성합니다: 타이밍 표(계획 시간, 각 블록별 슬라이드 및 슬라이드 당 시간), 그 다음 세션 플랜의 각 블록에 대한 항목을 순서대로 작성합니다:

• 오프닝: 플랜에 블록이 나열되어 있지 않더라도, 플랜의 블록과 시간을 포함하는 커버 슬라이드와 안건 슬라이드를 만듭니다.

• 인풋 블록: 해당 시간에 맞게 크기가 조정된 섹션(일반적으로 2~3분당 하나의 콘텐츠 슬라이드)을 만듭니다. 각 슬라이드가 주장하는 내용과 그 출처(세션 플랜, 샘플 답변, 캔버스, 참여자 페이지)를 나열합니다. 숫자는 플랜의 샘플 답변에서 가져오거나 다시 계산합니다. 절대 임의로 만들지 않습니다. 플랜에 키워드만 있을 때(예: "척도 유형") 자신의 지식으로 채우지 말고, 슬라이드에 플랜에 내용 누락이라고 표시하고 결정 사항으로 만듭니다.

• 그룹 작업: 참여자 페이지와 동일한 표현으로 된 작업, 시간 제한, 예상 결과, 작업 장소(저장소, 데이터, 시작 노트북), 게시 또는 제출 위치가 포함된 하나의 작업 슬라이드를 만듭니다. learner-instructions를 로드합니다. 참여자 페이지에 작업이 포함되어 있지 않은 경우(세션 중 작업은 종종 세션 플랜에만 있음) 플랜의 표현을 사용하고 플래그를 지정합니다. 이 경우 슬라이드는 학습자가 작업을 볼 수 있는 유일한 장소이며, 덱이 공개되는지 여부와 관계없이 참가자 자료입니다. 합리적인 해석이 두 가지 이상인 모든 작업(예: "평균"이 일별인지 행별인지)에 플래그를 지정하고 결정 사항으로 만듭니다.

• 전체 회의: 질문 또는 피드백 기준이 포함된 하나의 슬라이드를 만듭니다. 수업 중 생성된 콘텐츠(그룹 답변, 차트)는 실시간으로 채울 빈 프레임을 받습니다.

• 비디오 체크: RESOURCES.md의 퀴즈 링크(및 형식이 허용하는 경우 QR 코드)를 표시하고, 질문은 표시하지 않습니다. 답변과 설명은 발표자 노트에만 포함합니다. 유닛에 퀴즈가 아직 없으면 먼저 /to-quiz를 제안합니다.

• 휴식, 전망: 각각 하나의 슬라이드입니다. 전망 슬라이드는 참여자 페이지의 표현으로 숙제를 반복합니다.

학습자가 작업을 수행하기 전에 샘플 답변을 노출할 모든 슬라이드를 표시합니다. 이러한 슬라이드는 작업 슬라이드 뒤에 숨겨진 슬라이드나 백업 슬라이드로 배치하거나, 공개된 덱에서 제외합니다.

아웃라인에 필요한 결정 사항(과부하된 블록, 누락된 내용, 모호한 작업, 덱 공개 여부)을 각각 옵션과 권장 사항과 함께 나열하고, 아웃라인에 대해 이미 실행할 수 있는 course-checks의 슬라이드 체크 결과를 함께 표시합니다. 이를 보여주고 강사를 기다립니다. 이것이 중단 지점입니다. 콘텐츠 편집은 먼저 세션 플랜에, 그 다음 아웃라인에 반영됩니다.

3. 빌드

정해진 형식과 템플릿으로 덱을 빌드합니다:

• 모든 슬라이드에 요점을 명시하는 제목을 포함합니다(예: "대부분의 예측 오류는 공휴일에 발생함"). 주제만 제시하지 않습니다(예: "결과").
• 텍스트는 적게 사용합니다. 강사가 말할 내용은 발표자 노트에 포함하며, 세션 플랜에서 가져옵니다.
• 모든 링크, 저장소 이름, 명령어 및 마감일은 RESOURCES.md의 진실 공급원과 정확히 일치해야 합니다.
• 라이브 데모는 데모 실패 시를 대비해 대체 슬라이드(스크린샷 또는 예상 출력)를 포함합니다.

4. 확인 및 인계

course-checks의 슬라이드 체크(플랜 및 참여자 페이지와의 일관성, 타이밍, 조기 샘플 답변 없음, 링크)를 실행합니다. 실패한 항목을 수정한 후, 확실하지 않은 슬라이드 목록과 함께 덱을 보여줍니다.

덱은 미러입니다. 세션 플랜과 참여자 페이지의 사실을 반복하며, 그 공백도 포함합니다. 각 덱을 RESOURCES.md의 해당 사실 미러에 추가하여, 페이지 수정 시 해당 사실을 반복하는 덱에도 변경 사항이 적용되도록 합니다.

덱이 참가자에게 공개되는 경우, 승인된 덱을 핸드북에 게시합니다: PDF로 내보내고(슬라이드 도구를 수동으로만 내보낼 수 있는 경우 강사에게 내보내기를 요청하고 정확한 저장 위치를 알려줌), 유닛 이름으로 이름을 지정하고(예: week-02-slides.pdf), AGENTS.md의 핸드북 에셋 경로에 배치하고, 내보내기에서 발표자 노트와 숨겨진 답변 슬라이드를 제거한 후, 유닛의 참여자 페이지 자료 아래에 링크합니다. 이후 덱이 변경되면 새로 내보내야 합니다. 핸드북의 PDF는 덱의 미러입니다.

강사가 덱을 승인하고, RESOURCES.md에 해당 유닛에 대한 덱이 초안 상태로 나열되며, 그 위치가 세션 플랜에 링크되고, 공개되는 경우 PDF가 유닛의 참여자 페이지에 링크되면 완료됩니다. 덱이 참가자에게 공개되는 경우 다음으로 /walk-through <unit>을 제안하고, 그렇지 않으면 /review-unit <unit>을 제안합니다.