강의 진행 가이드

이 핸드북 전체(1~13장 + 별첨 A/B/C)를 사용해 강의를 진행할 강사를 위한 자료이다.

사전 준비물 통합 체크리스트

각 장의 setup 문서(3장 · 실습 환경 구축)에 흩어져 있던 항목을 강의 시작 전 한 번에 확인할 수 있도록 모았다. 강의 시작 최소 하루 전에 참가자에게 이 목록을 공지해 현장에서 설치 문제로 시간을 낭비하지 않도록 한다.

전체 시간 배분표

모든 절을 꼼꼼히 다루고, 실습은 참가자가 직접 타이핑(또는 복붙)할 시간을 포함해 산정했다. 휴식 시간은 별도이다.

장별 강사 노트

1장: 왜 AI 에이전트 팀인가? (도입)

이 장은 4장의 기술적 개념에 앞서 "왜 여러 AI가 팀으로 일해야 하는지"라는 동기를 확립하는 도입부다. 단일 AI vs 에이전트 팀 비교표를 보여주며 "혼자 하는 일 vs 팀이 하는 일"의 차이를 체감시키고, 하네스 개념은 "AI 팀을 움직이는 프레임워크"라는 비유로 가볍게 전달한다.

기대 효과 섹션은 이후 6~8장 실습에서 체감할 내용의 미리보기다. 여기서는 "느낌"만 전달하고, 기술적 세부 사항은 4장으로 넘긴다.

2장: Claude Desktop App 시작하기

이 핸드북의 기본 도구이므로, 참가자가 실제로 설치하고 첫 대화를 시작하는 것이 가장 중요하다. 설치가 이미 된 참가자는 구독 플랜 비교와 프로젝트 생성 실습에 집중하게 한다.

Linux 사용자는 데스크톱 앱이 없으므로, 별첨 B(Claude Code CLI)를 참조하도록 안내한다. 이 장에서는 CLI 자체를 다루지 않는다.

3장: 실습 환경 구축

사전 체크리스트를 먼저 확인하고, OS별 설치 스크립트를 실행한 뒤 검증까지 마친다. MacOS/Windows/Linux 세 환경을 모두 커버하므로, 강사는 자신의 OS 기준으로 한 번 시연하고 다른 OS 참가자는 스크립트에 맞춰 따라오게 한다.

설치 검증(bun setup-common.ts)이 통과했는지 반드시 확인한다. 여기서 시간을 아끼면 6~8장 실습이 순조로워진다.

4장: 멀티 에이전트 하네스 개념

이 장은 이후 모든 장에서 쓰는 용어(에이전트, 스킬, 워크플로우, PM, 3-Tier, PM Gateway)의 기준점이므로 속도를 늦춰도 좋다. "에이전트 = 역할을 맡은 직원, 스킬 = 재사용 가능한 작업 절차서" 같은 비유를 화이트보드에 옮겨 그리면서 설명하면 이해도가 올라간다.

5장: ai-workspace-standards 살펴보기

L0→L1→L2 계층 구조와 variant 개념을 전달한다. 초보자에게는 "표준 저장소에서 프로젝트를 찍어내는 템플릿 시스템"이라는 비유가 효과적이다. AGENTS.md와 CLAUDE.md의 역할 차이를 표로 보여주며 정리한다.

6장: co-consult — AI 컨설팅 실습 (오후 핵심 실습)

이 실습은 6장 전체가 기존 variant 활용에 할당된다. PM 에이전트와 대화하며 시장 분석 프로젝트를 진행한다. 7-Phase 워크플로우의 각 단계가 어떻게 자동으로 진행되는지, 그리고 Gate 2·5에서 사용자 승인을 요청하는 흐름을 강조한다.

산출물(deliverables/reports/)이 실제로 생성되는지 확인하게 한다. "AI가 혼자 다 한 것이 아니라, 역할을 나눠 협력한 결과"라는 점을 환기한다.

7장: co-deck — AI 프레젠테이션 실습

11-Stage 파이프라인으로 미니 발표자료를 만든다. theme/style 선택, Gate 2·5 승인, HTML+PDF 산출물 확인까지 진행한다. 6장과 달리 "발표"라는 명확한 산출물이 나오므로 참가자 만족도가 높은 실습이다.

8장: co-consult + co-deck 통합 파이프라인

6장의 보고서를 7장의 입력으로 넘기는 통합 실습이다. "주제 입력 → 30~45분 후 완성 발표자료"라는 전체 흐름을 보여주며, 두 시스템의 에이전트 구성 차이를 비교하게 한다.

9장: 에이전트 만들기와 수정

에이전트 파일 형식(frontmatter, 역할 정의, Tier)을 다루고, agent-lifecycle-manager로 간단한 전문 에이전트를 작성·등록·검증한다. 초보자에게는 "이력서(프론트매터) + 업무 매뉴얼(본문)"이라는 비유가 효과적이다.

10장: 스킬 만들기와 수정

스킬 파일 형식(프론트매터, trigger, steps)을 다루고, skill-lifecycle-manager + skill-creator로 커스텀 스킬을 작성·테스트한다. "요리사의 레시피"라는 비유로 에이전트와 스킬의 관계를 설명한다.

11장: 나만의 에이전트 팀 구성하기

team-builder 스킬의 AI 레이어 5-step(요구사항 인터뷰 → 벤치마킹 → 현재 팀 진단 → 제안서 생성 → 승인)과 스크립트 레이어(bun scripts/team-builder.ts)를 다룬다.

참가자가 미리 자기 도메인을 정해 오면 인터뷰가 빠르다. 제안서를 검토하고 승인(MANDATORY GATE)까지 완료하게 한다.

12장: 워크플로우와 자동화 이해

/sync 명령, Git/GitHub PR 자동화, Hook, CI/CD 기초, dev-sync.ts 동작 원리를 설명한다. 초보자에게는 "자동화 = 반복 업무를 시스템에 위임"이라는 비유로 시작한다.

이 장은 개념 인지(awareness) 목적의 심화·후속 학습 모듈로 프레이밍한다. 실습보다 개념 설명 중심으로 진행하고, CLI에 익숙한 참가자에게는 별첨 B로 심화를 안내한다. 관심 있는 참가자에게는 수업 후 선택적 실습 과제(/sync로 가상 프로젝트 커밋, Hook 동작 확인)를 제안하고, 자동화가 다음 단계의 자기주도 학습 영역임을 강조한다.

13장: 다음 단계 + 마무리

학습 로드맵, 커뮤니티, 응용 시나리오, FAQ로 마무리한다. 하루 전체를 회고하며, 1~12장에서 만든 것(프로젝트, 실습 산출물, 에이전트, 스킬, 팀 제안서)을 연결해 정리한다.

장별 확인 질문

각 장을 마칠 때 아래 질문을 던져 이해도를 확인하라. 정답을 맞히는 것이 목적이 아니라, 참가자가 스스로 설명해보게 하는 것이 목적이다.