개념 이해부터 Claude Code/Claude Desktop App/Antigravity 실습, 기업 내 운영 전략, ai-workspace-standards로 직접 variant 만들어보기까지
강사용 자료
이 워크숍이 무엇을 다루는지, 누구를 위한 것인지, 이틀 일정이 어떻게 구성되는지, 참가자가 워크숍 후 어떤 역량을 갖추게 되는지 한눈에 확인할 수 있는 소개 자료이다.
이 핸드북 전체로 강의를 진행할 때 참고할 통합 체크리스트, 절별 시간 배분, 실습 중 시연 전용 구간 안내, 장별 확인 질문을 모았다.
bun·git·gh·claude·agy 등 실습에 필요한 도구를 OS별 스크립트로 한 번에 설치하고, 설치 도구 목록·문제 해결까지 정리했다.
설치 스크립트를 돌리기 전에 직접 확인해야 하는 구독 플랜, 계정, 시스템 요구사항, Git/GitHub 설정을 체크리스트로 모았다.
입문 과정을 마친 수강생이 중복 학습 없이 워크숍을 활용하도록, 입문 챕터를 본 워크숍 챕터에 매핑하는 스킵 맵과 빠른 시작 체크리스트를 제공한다.
1일차 개념 일반 사용자 — 기초 개념 학습
왜 지금 AI를 배워야 하는지, AI 활용의 세 단계(사용자→활용자→설계자), 하네스 엔지니어링의 필요성, 멀티 에이전트의 원리, 실무 시간 단축 사례, 이 워크숍의 로드맵을 읽고 동기를 확립한다.
하네스 엔지니어링이 왜 필요한지, 단일 에이전트의 한계, 오케스트레이터·스페셜리스트·핸드오프 계약이라는 멀티 에이전트팀의 뼈대, 5가지 오케스트레이션 패턴을 읽고 이해한다.
서브에이전트에게 무엇을 허용하고 무엇을 막을지, 위험 작업 3단계 분류(읽기/쓰기/파괴적), 최소 권한 원칙, 사람 승인 게이트, 격리와 감사 로그를 다룬다.
바이브코딩으로 테트리스를 만들고, 단일 프롬프트로 팩맨에 실패한 뒤 기획·개발·QA 3단계 멀티 에이전트로 재시도하며 "복잡도가 높을수록 역할 분리의 가치는 기하급수적으로 증가"를 체험한다.
1일차 실습 일반 사용자 — 직접 에이전트팀 가동
서브에이전트 정의·호출·병렬 실행·자동화를 Claude Code, Claude Desktop App, Antigravity CLI, Antigravity Desktop, Codex CLI, Codex Desktop App 여섯 도구로 나란히 참조한다.
Claude Desktop App/Code에서 서브에이전트 정의(.claude/agents), Agent(Task) 툴 호출, Agent Teams 병렬, 훅 자동 발화를 다룬다.
Antigravity Desktop/명령줄 인터페이스(CLI)에서 동적 서브에이전트 생성, Agent Manager, /goal·/agent 커맨드, 세션 간 병렬을 다룬다.
Codex Desktop App/CLI에는 네이티브 서브에이전트가 없다 — PM이 agents/<name>.md를 역할 컨텍스트로 읽고 순차적으로 역할을 전환하는 방식, 세션 간 병렬, 훅 없는 프롬프트 자체 강제를 다룬다.
리뷰어·작성자 서브에이전트, 파이프라인, Agent Teams 병렬 실행, 모델 티어 비교까지 Claude Desktop App/Code에서 직접 해본다.
같은 AGENTS.md 명세를 Antigravity Desktop/명령줄 인터페이스(CLI)에서 자연어 목표로 구현하는 실습이다.
같은 AGENTS.md 명세를 PM이 agents/<name>.md 역할 컨텍스트로 읽어 순차 전환하는 방식으로 Codex Desktop App/CLI에서 직접 해본다.
variant 개발도구형 모델을 실제로 구현하는 ai-workspace-standards 저장소의 구조, 핵심 문서 5종, 13개 variant, 세션 시작 체크리스트와 스캐폴딩 흐름을 살펴본다.
워크스페이스 클론, bun 설치, new-project.ts 사용법, 세션 시작 체크리스트를 빠르게 참조한다.
co-consult로 시장조사 컨설팅 프로젝트를 진행하고, co-deck으로 발표자료를 자동 제작해본다.
2일차 개념 IT 전문가 — 아키텍처 심화와 전략
전사 서비스 티켓형 운영과 variant 개발도구형 운영을 나란히 비교하며 각각의 강점과 한계를 읽어본다.
배포와 SSOT(L0→L1→L2→L3 4-tier) 체계를 다룬다.
에이전트·스킬·스크립트 생애주기 관리 절차를 다룬다.
AGENTS.md 구조, 작성 가이드, 도구별 구현 매핑을 다룬다.
Layout Reconstruction, 플랫폼 패리티 등 아키텍처 실전 동작을 다룬다.
아직 구현되지 않은 고도화 로드맵을 다룬다. L3 프로젝트 업그레이드는 10장에서 독립적으로 다룬다.
다양한 도메인에서 실제로 쓰이는 멀티 에이전트 워크플로우 사례 — 코드 리뷰·시장 조사·프레젠테이션·이슈 트리아지·PR 검증 — 와 패턴 카탈로그, 선택 가이드를 다룬다.
이미 만든 L3 프로젝트를 최신 템플릿으로 업그레이드하는 절차(upgrade-project.ts)와 파일 처리 5분류, 안전장치를 다룬다.
2일차 실습 IT 전문가 — 신규 생성과 승격
co-retail이라는 신규 베리언트(variant)를 Phase A 프로토타입으로 처음부터 직접 설계한다. create-l3-scaffold.ts로 에이전트 팀 구성을 만드는 과정을 경험한다.
co-retail 프로토타입을 정식 templates/ 베리언트(variant)로 승격하는 파이프라인을 단계별로 따라간다. PROMOTION_CHECKLIST와 reconcile 과정을 확인한다.
variant 템플릿이 스테이지·RACI·결정 게이트를 데이터로 선언하는 실행 가능한 SOP 구조(ADR-0083·0084)를 다룬다. 4개 구성 그룹과 governed/core 등급, 검증 커맨드를 익힌다.
본인이 반복하는 실제 작업 하나를 골라, 개념부터 가드레일·서브에이전트 구현·검증까지 처음부터 끝까지 직접 설계해보는 마무리 실습이다.
공통 참고
같은 규칙을 훅·프롬프트·스킬 세 계층에 거는 3계층 강제 모델, 편집 전 사실을 강제하는 GateGuard, 검증 스크립트 가족과 fail-closed vs warn의 구분, 플랫폼별 강제력 차이와 차단 시 대응법.
Decision Record와 증거 장부, 스펙 레지스트리의 관련성 게이트와 E1–E5 면제, git으로 추적되는 거버넌스 백로그 티켓, 연결 없는 ADR을 잡아내는 반영 검증까지 — 결정을 일급 자산으로 다루는 전 과정.
스킬·에이전트·ADR 사이의 관계를 기계가 읽는 그래프로 유도하는 시스템. 데이터 원천, 노드/엣지 스키마, 관계 어휘 10종, 3계층 모델, 생성·검증 파이프라인과 실전 워크플로우를 상세히 다룬다(ADR-0060).
같은 멀티 에이전트팀 개념이 네 도구에서 각각 어떻게 다르게 구현되는지, 훅·병렬 실행·격리 방식 차이를 비교한다.
오케스트레이터·핸드오프·SSOT·tier·L0/L1/L2·variant·스캐폴딩·포크 모델 등 핸드북 전체에서 반복되는 용어를 정의와 함께 모았다.
실습 중 흔히 겪는 문제(순차 호출 실패, 훅 미발화, 인지적 중첩, 스캐폴딩 오류, 비용·타임아웃 등)를 증상별로 모아 원인과 해결책을 연결한다.