프롬프트 엔지니어링에서 하네스 엔지니어링으로. Claude Code · Claude Desktop App · Antigravity · Antigravity CLI 네 도구를 넘나들며 멀티 에이전트팀을 직접 설계하고 운영하는 2일 실전 워크숍.
이 워크숍은 무엇인가? "프롬프트 엔지니어링만으로는 부족하다"는 문제의식에서 출발해, AI 에이전트에게 좁은 역할을 부여하고 오케스트레이터가 조율하는 멀티 에이전트팀의 설계 방법론을 배우고, Claude Code·Claude Desktop App·Antigravity·Antigravity CLI 네 도구에서 실제로 서브에이전트를 만들고 파이프라인을 구축해보는 이틀에 걸친 실전 워크숍이다.
1일차는 일반 사용자를 대상으로 멀티 에이전트 개념과 실무 도구 실습, 기존 variant 활용에 집중한다. 2일차는 IT전문가를 대상으로 아키텍처 심화, 도구 비교, 기업 운영 전략, 신규 variant 생성부터 캡스톤 프로젝트까지 진행한다.
이 워크숍을 수료한 참가자는 다음을 할 수 있다.
이 워크숍은 이틀 동안 다른 대상층을 대상으로 진행된다. 각 날짜에 맞춰 참가하거나, 이틀 모두 참석해 체계적으로 학습할 수 있다.
AI 도구를 업무에 활용하고 싶은 실무자를 대상으로 한다. 코딩 경험이 많지 않아도, CLI 기본 조작만 익숙하면 충분히 따라올 수 있다.
1일차의 경험을 바탕으로, 아키텍처와 기술적 심화를 다루는 IT전문가 대상 세션이다.
gh auth login이 가능한 GitHub 계정agy) 설치 완료bun --version, git --version 정상 출력 확인git clone https://github.com/5throck/ai-workspace-standards.git을 워크스페이스 루트 위치에 미리 클론| 형태 | 내용 | 1일차 비율 | 2일차 비율 |
|---|---|---|---|
| 강의 | 개념 설명, 패턴 소개, 도구 비교, 모델 비교 | 약 30% | 약 40% |
| 실습 | 참가자 직접 서브에이전트 정의·호출·파이프라인·variant 스캐폴딩 | 약 55% | 약 45% |
| 토론 | 소그룹 토론, 확인 질문, 전체 회고 | 약 15% | 약 10% |
| 시연 | 강사 화면 공유(승격 파이프라인 등 비가역적 작업만) | — | 약 5% |
네 도구(Claude Desktop App, Claude Code, Antigravity Desktop, Antigravity CLI)를 모두 설치한 뒤 참가자를 4개 그룹으로 나누어 각자 다른 도구로 같은 시나리오를 진행한다. 마지막에 결과를 비교하며 "도구 비교" 챕터 내용이 직접 체감된다.
이틀 총 소요 시간 약 12시간 10분 (휴식 제외). 1일차 휴식 2회, 2일차 휴식 2회(각 10~15분)를 포함하면 1일차 약 6시간 5분~6시간 15분, 2일차 약 6시간 45분~6시간 55분이다.
1일차(일반 사용자)는 하네스 엔지니어링 개념과 가드레일, 실무 도구 실습에 집중하고, ai-workspace-standards를 가볍게 소개한 뒤 기존 variant 활용 실습을 충분히 진행한다. 코딩 경험이 적은 참가자도 따라올 수 있도록 구성했다. 2일차(IT전문가)는 1일차의 경험을 바탕으로 ai-workspace-standards 아키텍처 심화, 도구 비교, 기업 운영 전략을 다루고, 신규 variant 생성과 캡스톤 프로젝트를 진행한다.
강의 목표·이틀 전체 로드맵 소개, 사전 준비물 확인
강의
지금 왜 AI인가(도입 통계), AI 활용의 세 단계(사용자→활용자→설계자), 하네스 엔지니어링의 필요성, 멀티 에이전트의 원리, 실무 시간 단축 사례, 이 워크숍 로드맵
강의
Prompt→Context→Harness 흐름, 단일 에이전트 한계, 오케스트레이터·스페셜리스트·핸드오프 계약, 오케스트레이션 패턴 5종, 동적 팀 구성, AGENTS.md 표준
강의 확인질문
위험 작업 3단계 분류, 최소 권한 원칙, 사람 승인 게이트, 격리, 감사 로그
강의
바이브코딩으로 테트리스 만들기(10분) → 단일 프롬프트로 팩맨 시도 후 실패 체험 → 기획·개발·QA 3단계 멀티 에이전트로 재시도(25분) → 시사점 정리: "복잡도가 높을수록 역할 분리의 가치는 기하급수적으로 증가"(5분)
실습(참가자 직접) 시사점
Claude(A)/Antigravity(B)에서 서브에이전트 정의·호출·순차 파이프라인·동적 팀 구성·병렬 실행·모델 티어 비교 (G-1/D-1/D-2/P-1/P-2)
실습(참가자 직접)
저장소 개요, 핵심 파일 4종(AGENTS.md·CONSTITUTION.md·CLAUDE.md·GEMINI.md), variant란 무엇인가, 스캐폴딩으로 프로젝트 만들기 기본
강의
co-consult로 Physical AI 시장조사 프로젝트 스캐폴딩, 4단계 설계 프레임워크 적용, 에이전트팀 가동(7단계 컨설팅 워크플로우), 결과물 검토·핸드오프 추적
실습(참가자 직접)
co-deck으로 한식 세계화 발표자료 스캐폴딩, 발표 주제 프레임 설정, 11단계 파이프라인 가동, 결과물 리뷰·개선, TTS·자동 슬라이드 설정
실습(참가자 직접)
오늘 배운 내용 요약, 두 variant(co-consult vs co-deck) 구조 비교 회고, 2일차 예고(IT전문가 세션)
토론
핵심 개념 요약(오케스트레이션 패턴, 가드레일, AGENTS.md), 6장 기존 variant 활용 실습 성과 공유
토론
서비스 티켓 모델 vs 개발 도구+variant 모델, 칸반 기반 운영, 두 모델 장단점 비교
강의 토론
L0→L1→L2→L3 계층 구조 상세, 포크 모델, 파일별 SSOT 흐름
강의
에이전트·스킬·스크립트 생애주기 관리
강의
방금 학습한 에이전트 생애주기와 스킬 생애주기 다이어그램을 비교하여, 두 생애주기 간의 차이점 3가지를 찾아 옆 사람과 공유하기
미니 실습
워크플로우 구성요소(단계·분기·병렬·취합·게이트·루프), 5가지 도메인별 사례, 패턴 선택 가이드
강의
기존 프로젝트를 L2 variant 구조로 업그레이드하는 절차, 주요 파일 처리 분류, 스냅샷·롤백, 승격과의 방향 차이
강의
네 도구 구조 한눈에 보기, Claude Desktop App vs Code(서브에이전트 정의, teammateMode), Antigravity vs agy(Agent Manager, /goal·/agent·/agents), 멀티 에이전트 지원 범위 비교표, 실습 도구 선택 가이드, AGENTS.md 통합
강의
co-retail Phase A 프로토타입 만들기 — create-l3-scaffold, 도메인 에이전트 정의(researcher·writer), AGENTS.md 로스터 갱신, agent:verify
실습(참가자 직접)
처음부터 만들기(Phase A→B) vs 기존 프로젝트 승격, 두 경로의 차이와 선택 기준
강의
프로토타입 검증(validate-templates·agent:verify), 승격 체크리스트/매니페스트 작성(참가자 실습), 승격 파이프라인 실행(강사 시연)
실습 시연
variant 템플릿이 스테이지·RACI·결정 게이트를 데이터로 선언하는 실행 가능 SOP 구조(ADR-0083·0084) — 4개 구성 그룹, governed/core 등급, 검증 커맨드
강의
본인의 반복 작업을 골라 4단계(문제 정의·가드레일 설계·서브에이전트 구현·검증 회고) 직접 설계
실습(참가자 직접)
1~2명이 자기 워크플로우를 짧게 공유, 참가자 피드백
발표
이틀 전체 회고, Q&A, 용어집/FAQ 안내, 다음 단계 안내
토론
| 블록 | 주제 | 관련 장 | 일정 |
|---|---|---|---|
| 도입 | AI 도입 현황과 통계, AI 활용 3단계, 하네스 엔지니어링 필요성, 멀티 에이전트 원리, 실무 시간 단축 사례 | 1장 | 1일차 |
| 개념 | 하네스 엔지니어링 패러다임, 오케스트레이션 패턴, AGENTS.md 표준 | 2장 | 1일차 |
| 안전 | 가드레일 설계, 위험 작업 분류, 최소 권한, 승인 게이트, 격리 | 3장 | 1일차 |
| 워밍업 | 바이브코딩(테트리스)과 멀티 에이전트(팩맨)로 복잡도에 따른 접근법 차이 체험 | 워밍업 | 1일차 |
| 실습 | 서브에이전트 정의·호출·파이프라인·병렬 실행·모델 티어 비교 | 4장 §1, §2-A/B | 1일차 |
| 설계 | ai-workspace-standards 소개, 핵심 파일 4종, variant 개요 | 5장 (가볍게) | 1일차 |
| 구현 | 기존 variant 활용(co-consult, co-deck 스캐폴딩·가동) | 6장 | 1일차 |
| 운영 | 서비스 티켓 모델 vs variant 모델, 칸반 기반 운영 | 7장 | 2일차 |
| 설계 심화 | L0→L1→L2→L3 계층 구조, 파일별 SSOT 흐름, 에이전트·스킬·스크립트 생애주기 관리 | 8장 §1, §2 | 2일차 |
| 워크플로우 | 워크플로우 구성요소, 5가지 도메인별 패턴 사례, 패턴 선택 가이드 | 9장 | 2일차 |
| 업그레이드 | 기존 프로젝트를 L2 variant 구조로 전환, 주요 파일 처리 분류, 스냅샷·롤백 | 10장 | 2일차 |
| 도구 | Claude Code, Claude Desktop App, Antigravity, Antigravity CLI 비교 분석 | 공통 참고 | 2일차 |
| 창조 | 신규 variant 생성(co-retail 프로토타입), 승격 파이프라인 | 11장, 12장 | 2일차 |
| 운영 모델 | Domain Operating Model — 스테이지·RACI·결정 게이트의 데이터 선언, governed/core 등급 | 13장 | 2일차 |
| 종합 | 캡스톤: 본인 업무에 멀티 에이전트팀 적용하기 | 14장 | 2일차 |
[강사 이름 · 소속 · 직함]
[강사 프로필: AI 에이전트 도입/운영 경험, 주요 관심 분야, 연락처]
이 섹션은 강사가 직접 채워 넣도록 비워둔 영역이다.