진행자 가이드¶

워크샵 진행자를 위한 내부 가이드입니다. 참가자와 공유하지 마십시오.

개요¶

이것은 Antigravity CLI를 위한 5개 모듈, 약 7시간 분량의 실습 워크숍입니다. Antigravity CLI를 평가하거나 도입하려는 개발자 대상(엔지니어, 기술 리드, 솔루션 아키텍트)으로 설계되었습니다.

진행 형식¶

워크숍 사전 체크리스트¶

• [ ] 참가자가 Antigravity CLI를 설치하고 인증을 완료했는지 확인 ( setup.md 참조)
• [ ] 인증 세부 정보 배포 완료 (세션별 상이 — agy-cli 팀과 확인)
• [ ] 참가자가 Git 및 적절한 데모 코드베이스를 준비했는지 확인
• [ ] 진행자가 현재 agy-cli 버전에서 모든 실습을 처음부터 끝까지 실행해 보았는지 확인
• [ ] 화면 공유 / 프로젝션 테스트 완료
• [ ] 모듈 2: 참가자가 dotnet 또는 mvn을 실행할 수 있는지(또는 제공된 컨테이너를 사용할 수 있는지) 확인
• [ ] 모듈 3: pip install google-antigravity 및 gcloud auth application-default login이 정상 작동하는지 확인
• [ ] 모듈 5: uv 및 agents-cli가 설치되어 있는지 확인 (uvx google-agents-cli setup)

agy --print "Say READY" --print-timeout 30s

모듈별 진행 노트¶

모듈 1 — SDLC 생산성 향상 (75분)¶

핵심 메시지: agy는 익숙하지 않은 코드베이스를 파악하는 데 드는 정신적 부담을 덜어줍니다. 단순한 자동 완성이 아닙니다 — 무엇이든 물어볼 수 있는 시니어 엔지니어입니다.

• 데모를 먼저, 실습은 나중에. 참가자들에게 각자의 코드베이스에서 시도해 보라고 요청하기 전에, 본인의 코드베이스에서 섹션 1.1(코드 이해)을 라이브 데모로 보여주세요.
• 흔한 마찰: 참가자들은 완벽한 프롬프트를 작성하려고 노력합니다. 자연스러운 언어를 사용하도록 권장하세요. "이 코드베이스의 인증 아키텍처를 설명해 주세요"보다 "인증이 어떻게 작동하는지 알려줘"가 더 낫습니다.
• AGENTS.md 모멘트: 섹션 1.5는 가치가 높은 데모입니다. 화면에서 실시간으로 AGENTS.md를 생성하고 다음 세션이 즉시 얼마나 더 똑똑해지는지 보여주세요.
• 플러그인 가져오기 데모 (섹션 1.7): agy plugin import gemini를 실시간으로 실행하세요 — 시각적 출력이 매우 인상적입니다. 참고: 가져오기 중에 사용자 지정 테마는 조용히 삭제되며 마이그레이션할 수 없습니다. 참가자가 테마가 왜 넘어오지 않았는지 묻는다면, 이는 예상된 동작입니다 — 오류가 발생한 것이 아니라 구성 요소가 단순히 건너뛰어진 것입니다.

모듈 2 — 레거시 코드베이스 현대화 (90분)¶

핵심 메시지: 엄격한 모드 + 셀프 온보딩은 일주일이 걸리는 마이그레이션을 체계적인 오후 작업으로 바꿔줍니다. 에이전트가 자체 컨텍스트를 작성한 다음 이를 실행합니다.

라이브 데모 스크립트 (권장):

1. .NET 또는 Java 대상 저장소를 복제합니다(시간 절약을 위해 미리 완료).
2. 엄격한 모드로 들어갑니다: /permissions strict
3. 조사 프롬프트를 실행합니다 — 에이전트가 전체 코드베이스를 읽는 모습을 참가자들에게 보여줍니다.
4. 에이전트가 AGENTS.md를 생성하도록 합니다 — 큰 소리로 읽어 실제 컨텍스트를 캡처했음을 보여줍니다.
5. ctrl+g — 생성된 계획을 편집기에서 열고, 사람의 제어를 보여주기 위해 눈에 띄는 편집을 하나 수행합니다.
6. request-review로 전환하고, 1단계만 실행합니다.
7. /rewind를 보여줍니다 — 문제가 발생하면 해당 단계를 되돌립니다.

8. 총 데모 시간: 약 15분, 이후 참가자들이 직접 실습합니다.

9. 흔한 질문: "전체 마이그레이션을 수행할 수 있나요?" — 네, 하지만 가치는 단순히 실행되는 것을 지켜보는 것이 아니라 검토하고 모델 스티어링하는 데 있습니다. 참가자들이 계획을 편집하도록 권장하세요.

10. 진행자 타이밍 참고: 0~1단계를 함께 수행하는 데 참가자당 약 20분이 소요됩니다. 돌아다니면서 확인하는 동안 참가자들이 2단계를 진행하도록 하세요.

모듈 3 — SDK로 AGY 에이전트 구축 (90분)¶

핵심 메시지: CLI는 개인용입니다. SDK 에이전트는 팀 전체가 호출할 수 있는 전문가 서비스입니다.

• 설정 관문: 시작하기 전에 모든 참가자가 google-antigravity를 설치했고 Vertex AI 또는 AI Studio 인증이 작동하는지 확인하세요. 이것이 가장 흔한 장애물입니다.
• adk web . 모멘트: 참가자들이 브라우저 UI에서 첫 번째 에이전트를 실행하게 되면 분위기가 바뀝니다 — 에이전트가 도구에 반응하는 것을 보게 됩니다.
• 모델 선택 표: 생성을 위해서는 Flash-lite를, 오케스트레이션을 위해서는 Pro를 강조하세요. 비용 절감은 타협이 아니라 기능입니다.
• 연습 11 (파이프라인): asyncio.gather + START_SUBAGENT 다중 에이전트 패턴은 핵심 아키텍처 인사이트입니다. 시작하기 전에 서브에이전트가 어떻게 구성되는지 5분 동안 설명하세요.

모듈 5 — agents-cli를 사용한 ADK 에이전트 (75분)¶

핵심 메시지: agents-cli는 코딩 에이전트를 ADK 전문가로 만들어줍니다. 7단계 수명 주기(스캐폴드 → 빌드 → 평가 → 배포)는 에이전트가 데모에서 프로덕션으로 넘어가는 과정입니다.

• 설정 관문: uv 및 agents-cli가 설치되어 있는지 확인하세요. agents-cli info를 실행하여 확인합니다.
• 평가 루프가 교육의 핵심입니다. 4단계(평가)에 시간을 할애하세요 — 이것이 장난감과 프로덕션 에이전트를 구분하는 요소입니다. 참가자들이 점수 실패를 확인한 다음 반복하도록 하세요.
• google-adk ≠ google-antigravity: 모듈 3에서는 google-antigravity(Antigravity SDK)를 사용합니다. 모듈 5에서는 google-adk(ADK)를 사용합니다. 이들은 서로 다른 패키지입니다. agents-cli scaffold는 올바른 종속성을 자동으로 관리합니다.
• 연습 12 진행 속도: 1~2부(스캐폴드 + 빌드)는 빠르게 진행됩니다. 3~4부(평가 + 수정 루프)에서 시간이 소요됩니다. 5~10회 반복하는 것이 정상임을 강조하세요.

모듈 4 — 다중 에이전트 및 고급 패턴 (60분)¶

핵심 메시지: 서브에이전트 + /btw는 질적인 도약입니다. 이 부분에서 agy는 단순한 챗봇이 아닌 오케스트레이터가 됩니다.

• 서브에이전트 데모는 감탄을 자아내는 순간입니다. 실시간으로 두 개의 에이전트를 생성하고, 둘 다 동시에 실행되는 모습을 보여주세요.
• /btw 데모: 다소 긴 작업(파일 리팩토링)을 시작한 다음, 작업 중간에 /btw를 사용하세요. 주입된 메모가 통합되는 동안 커서가 계속 움직이는 모습을 참가자들에게 보여주세요.
• 예약: 패턴을 개념적으로 설명하고, 라이브 데모는 하지 마세요(지연 시간으로 인해 워크숍에서 어색해질 수 있습니다).

참가자 공통 질문¶

워크숍 중 문제 해결¶

워크숍 이후¶

1. 표준 워크숍 피드백 양식을 사용하여 피드백을 수집합니다.
2. 관찰된 agy-cli 버그나 예기치 않은 동작을 기록하고 agy-cli 팀에 보고합니다.
3. 임시 해결책이 필요했던 실습은 CONTRIBUTING.md에 문서 업데이트가 필요하다고 표시해야 합니다.