AI LITERACY · ANTIGRAVITY 101 · 입문자용

AI에게
코드를 시키는
시대가 왔다.

Google Antigravity — 2025년 11월 18일 공개된, 에이전트가 계획·실행·검증까지 해주는 새로운 IDE.
오늘 우리는 그 첫 화면을 같이 켭니다.

주최OZ코딩스쿨 과정AI리더캠프 6기 대상완전 초보자 · 노코드 환영
WHAT YOU'LL GET · 3시간 후 결과물

3시간 뒤 — 당신은 이 4가지를 가집니다.

"코딩을 배우는" 수업이 아닙니다. "AI에게 코드를 시키는 법"을 배우는 수업. 한 줄도 직접 쓸 필요가 없을 수 있습니다.

OUTPUT 01 · 도구
Antigravity 설치 + 첫 실행
PC 또는 Mac에 완전 무료로 설치. Public Preview라 카드 등록도 없습니다.
OUTPUT 02 · 사고법
Manager View vs Editor View
"코드를 쓰는 화면"과 "에이전트를 지휘하는 화면" — 두 시점으로 일하는 법.
OUTPUT 03 · 산출물
Artifacts 5종을 검토하는 눈
에이전트가 만든 결과물을 사람이 읽을 수 있는 형태로 보고 → 댓글 → 수정 지시.
OUTPUT 04 · 본인 결과
수업자료 퀴즈 생성 서비스 MVP
한 줄도 안 짜고 — Antigravity에 시켜서 — 입력, 생성, 저장, 복사까지 되는 작은 서비스 완성. 캡처 인증.

→ 수업 끝날 때 본인 화면에 "내가 시킨 것"이 진짜로 돌아가고 있어야 정상입니다.

GLOSSARY · 시작 전 용어 8개

"이게 뭐지?" 용어 — 미리 풀어드립니다.

강의 내내 등장합니다. 30초만 미리 훑어두면 흐름을 놓치지 않습니다.

01 · Agent (에이전트)
"스스로 일하는 AI 비서". 지시 하나에 계획 → 실행 → 검증까지 알아서 합니다.
02 · IDE
Integrated Development Environment. 코드를 쓰는 작업장. VS Code, Cursor가 대표. Antigravity도 IDE.
03 · Artifact (산출물)
에이전트가 만든 검토 가능한 결과물. Task List, Plan, Code Diff 등 5종. Google Docs처럼 댓글 가능.
04 · Workspace (작업공간)
하나의 프로젝트 폴더 = 하나의 워크스페이스. Antigravity가 "이 안에서만" 일하도록 경계 짓는 곳.
05 · MCP
Model Context Protocol. AI가 외부 도구·서비스를 쓸 수 있게 연결하는 표준 통로.
06 · Subagent
메인 에이전트가 부르는 "전문 보조". 대표적으로 Browser Subagent — 진짜 크롬을 조작.
07 · Walkthrough
에이전트가 작업하면서 찍은 영상·스크린샷 요약본. "내가 뭐 했는지" 자동 보고서.
08 · Vibe Coding (바이브 코딩)
"느낌으로 시키는 코딩". Andrej Karpathy가 만든 말. 코드를 한 줄도 안 짜고 AI에게 다 시키는 흐름.
WEB BASICS · 앞에서 보이는 곳과 뒤에서 일하는 곳

서비스는 가게처럼 생각하면 쉽습니다.

손님이 보는 매장 앞쪽이 프론트엔드, 직원이 주문을 처리하는 주방·창고·계산대 뒤쪽이 백엔드입니다.

Frontend · 손님이 보는 화면
버튼, 글자, 카드, 입력칸, 화면 이동
  • 인스타 피드에서 사진과 좋아요 버튼이 보이는 부분
  • 배달앱에서 메뉴를 고르고 장바구니에 담는 화면
  • 퀴즈 서비스에서 문제를 보고 정답을 누르는 화면
  • 주로 HTML, CSS, JavaScript, React가 담당
+
Backend · 뒤에서 처리하는 일
로그인, 저장, 검색, 결제, 권한 확인
  • 내 비밀번호가 맞는지 확인
  • 내가 저장한 퀴즈를 DB에서 다시 꺼내오기
  • 남의 자료를 내가 못 보게 막기
  • 주로 Node.js, Supabase, DB, 서버가 담당

한 문장 정리: 프론트엔드 = 보이는 화면, 백엔드 = 뒤에서 저장하고 확인하는 시스템.

WEB BASICS · 초등학생도 이해하는 비유

웹 화면은 종이 인형 놀이처럼 만들 수 있습니다.

무엇을 놓을지, 어떻게 꾸밀지, 눌렀을 때 무엇이 일어날지만 나누면 됩니다. 브라우저는 이 셋을 읽어서 우리 눈앞에 보여주는 앱입니다.

HTML
무엇이 있는지 적는 종이
제목, 설명, 버튼, 입력칸, 이미지처럼 화면에 놓을 물건의 이름표입니다.

예: 제목, 저장 버튼, 검색창
CSS
예쁘게 꾸미는 색연필
색, 크기, 간격, 정렬, 모바일에서 줄바꿈을 정합니다.

예: 버튼은 주황색, 제목은 크게, 카드는 2줄로
JavaScript
눌렀을 때 움직이는 규칙
클릭, 저장, 계산, 검색, 팝업 열기 같은 행동을 만듭니다.

예: 저장 버튼을 누르면 목록에 추가
COMPONENT · 화면 조각을 재사용하기

컴포넌트는 레고 블록입니다.

똑같은 버튼과 카드를 매번 새로 만들면 힘듭니다. 한 번 만든 화면 조각을 이름 붙여두고 계속 재사용하는 것이 컴포넌트입니다.

예시 01 · 버튼
SaveButton
저장, 삭제, 복사 버튼 모양을 통일합니다. 색과 글자만 바꿔 재사용합니다.
예시 02 · 카드
LessonCard
수업자료 제목, 요약, 생성일, 열기 버튼을 한 덩어리로 묶습니다.
예시 03 · 입력 폼
QuizForm
강의안을 붙여넣고 "퀴즈 만들기"를 누르는 입력 영역입니다.
예시 04 · 목록
SavedList
저장한 자료들을 줄줄이 보여줍니다. 데이터가 늘어나도 모양은 같습니다.
왜 쓰나
고치기 쉬움
버튼 디자인을 바꿀 때 버튼 컴포넌트 하나만 고치면 여러 화면이 같이 바뀝니다.
AI에게 말하기
"조각으로 나눠줘"
Antigravity에는 "Header, InputForm, ResultCard, SavedList로 나눠줘"라고 말하면 됩니다.
WEB STACK · 자주 듣는 이름 3개

React·Next.js·Node.js는 역할이 다른 친구입니다.

셋 다 개발에서 자주 보이지만 같은 뜻이 아닙니다. 화면 블록, 서비스 틀, 실행 엔진으로 나눠서 보면 됩니다.

React
화면 레고 블록 도구
버튼, 카드, 검색창 같은 컴포넌트를 만들고 조립합니다.

예: QuizCard 1개를 만들어 퀴즈 10개에 반복 사용.
Next.js
React로 서비스 만드는 설명서
페이지 이동, 로그인 화면, 서버 요청, 배포 구조를 정해줍니다.

예: /login, /dashboard, /api/save를 규칙대로 만듦.
Node.js
JavaScript를 서버에서 돌리는 엔진
원래 JavaScript는 브라우저에서 돌지만, Node.js는 내 컴퓨터와 서버에서도 돌게 합니다.

예: 개발 서버 실행, 파일 읽기, API 만들기.

한 문장 정리: React = 화면 조각 만들기, Next.js = 서비스 전체 틀, Node.js = 서버에서 JS 실행.

CONCEPT MAP · 언어와 도구의 차이

언어·라이브러리·프레임워크는 요리로 비유하면 쉽습니다.

프로그래밍 언어

요리사에게 말하는 한국어·영어 같은 것. 컴퓨터에게 명령하는 말입니다. 예: JavaScript, Python.

라이브러리

필요할 때 꺼내 쓰는 주방 도구입니다. 칼, 믹서기처럼 내가 필요할 때 부릅니다. 예: React, Chart.js.

프레임워크

식당 운영 매뉴얼입니다. 주문 받는 곳, 주방, 냉장고 위치까지 규칙을 정해줍니다. 예: Next.js, Django.

런타임

요리가 실제로 만들어지는 주방입니다. 코드가 진짜 실행되는 장소입니다. 예: Browser, Node.js.

초보자 프롬프트: "처음엔 HTML/CSS/JS로 간단히 만들고, 화면이 복잡해지면 React 컴포넌트로 나눠줘. 로그인·저장이 필요하면 Next.js/Supabase를 검토해줘."

SELF-CHECK · 시작 전 3문항

시작 전, 스스로 답해보세요.

정답 없습니다. 단, 이 3문항의 답이 수업 전후로 달라지는 게 정상입니다.

Q 01 · 경험
"코딩 해본 적 있나요?"
없어도 OK. 사실 없는 사람이 더 빨리 시작합니다 — 선입견이 없으니까. VS Code? Cursor? 들어만 봤어도 충분.
Q 02 · 동기
"왜 AI 코딩을 배우려고요?"
취업? 업무 자동화? 사이드 프로젝트? 이유가 구체적일수록 학습 속도가 다릅니다. 막연한 불안 → 학습 멈춤.
Q 03 · 목표
"오늘 끝나면 뭘 만들고 싶나요?"
아주 작은 것이라도 "이걸 만들어보고 싶다"가 있으면 진도가 꽂힙니다. 없어도 됩니다 — 6장에 난이도별 프로젝트 사다리가 있어요.

→ 수업 끝나고 다시 답해보세요. 답이 달라졌다면 — 오늘은 성공입니다.

WHY THIS MATTERS

"코드 못 짜는데 만들고 싶은 게 있다" — 바로 그 사람을 위한 도구.

기존 코딩 학습
문법 → 라이브러리 → 프로젝트
  • HTML, CSS, JS, React, DB, API… 최소 6개월 공부
  • "내가 만들고 싶은 거"에 도달하기 전에 대부분 이탈
  • 실패 = 자존감 하락 → 포기
Antigravity 방식
"이거 만들어줘" → 결과물 → 검토
  • 오늘 3시간 안에 첫 결과물
  • "무엇을 만들지"만 결정 → 나머진 에이전트
  • 실패 = AI한테 다시 시키면 끝
PART 01

Antigravity는
무엇인가.

"에이전트가 코드를 짜는 IDE." — 한 줄로 끝나면 좋겠지만, 입문자에게는 너무 압축된 문장입니다. 이번 파트에서 — Google이 왜 이 도구를 만들었고, 무엇이 새로운지를 차근차근 풀어봅니다.

ONE-LINER

한 줄로 정의하면 —

Google이 만든,
AI 에이전트가 코드를 짜고 · 실행하고 · 검토해주는
새로운 IDE.
— Antigravity = "반(反)중력". 코드를 직접 들어 올리던 무게를 — AI가 들어 올린다는 비유.
2025
11월 18일 공개 (Gemini 3와 동시)
Free
Public Preview · 카드 등록 없음
VS Code
Fork — 익숙한 사람은 30초면 적응
SHIFT · 도구의 세대 교체

코드를 "쓰는" 도구에서, 코드를 "지휘하는" 도구로.

YESTERDAY · 어제의 도구
"빨리 쓰게 도와주는" 도구
  • VS Code · IntelliJ — 자동완성, 단축키
  • Copilot · Cursor — 줄 단위 추천
  • 핵심 = 사람의 손가락 속도를 빠르게
  • 코드는 사람이 직접 한 줄씩 검수
TOMORROW · 내일의 도구
"지휘하게 도와주는" 도구
  • Antigravity — 에이전트가 자율 실행
  • 여러 작업을 동시에 5개 병렬
  • 핵심 = 사람의 검토·판단 속도
  • 코드는 에이전트가 작성 + 사람이 승인
OFFICIAL QUOTE · Google Antigravity 발표문

Google이 직접 한 말.

"The tools of yesterday focused on helping you
write code faster;
the tools of tomorrow need to help you
orchestrate it."
— Google Antigravity 공식 발표문 (2025-11-18)

한국어로 옮기면 — "어제의 도구는 코드를 빨리 쓰게 했다면, 내일의 도구는 코드를 지휘하게 한다."
이 한 문장이 — Antigravity의 모든 것입니다.

FACTS · 우선 외울 5가지 숫자

Antigravity 핵심 사실 — 숫자로 빠르게.

11.18
2025년 11월 18일 공개
Gemini 3 발표와 동시
$0
Public Preview · 완전 무료
카드 등록 없음, 가입만 하면 OK
5
최대 5개 에이전트 병렬 실행
한 사람이 5명 팀처럼 일하기
5종
Artifacts: Task List · Plan ·
Walkthrough · Diff · Recording
3 OS
macOS · Windows · Linux
모두 지원
7+
지원 모델: Gemini 3.5 Flash,
Gemini 3, Claude, GPT-OSS
LINEAGE · 어디서 왔나

Fork는 원본 공책을 복사해서 새 버전으로 키우는 것입니다.

Antigravity는 VS Code를 기반으로 만든 fork입니다. 그래서 VS Code의 익숙한 편집기·단축키·확장 생태계를 가져오고, 그 위에 AI 에이전트 지휘 기능을 얹었습니다.

VS Code 원본 공책 편집기 단축키 확장 프로그램 fork = 복사해서 새 길 Cursor AI 자동완성 중심 Antigravity VS Code 기반 + Agent-first 계획 · 실행 · 브라우저 검증 다른 VS Code 기반 도구들 우리가 사용 YOU 초보자도 익숙한 UI

쉬운 예: 카카오톡을 복사해서 "수업용 단체 채팅 앱"으로 바꾸면 fork입니다. 원본의 좋은 점은 가져오고, 목적에 맞는 기능을 새로 붙입니다.

HOW IT WORKS · 에이전트의 4단계

에이전트는 이 4단계를 알아서 합니다.

STEP 01 · 이해
📥 받기
사용자의 자연어 지시를 받습니다.
"수업자료 퀴즈 생성 서비스 만들어줘".
STEP 02 · 설계
🗂️ 계획
Task List · Implementation Plan을 먼저 작성. 사람이 검토 후 승인.
STEP 03 · 작업
⚙️ 실행
파일 생성·수정·터미널 실행을
자율 진행. 진행 상황을 카드로 노출.
STEP 04 · 검증
✅ 보고
결과를 Walkthrough · Code Diff로 정리. 사람이 댓글 → 수정 요청.

🎯 핵심: 사람은 "무엇을"·"승인할지"만 결정. 코드 한 줄도 안 짜도 OK.

CORE FEATURES · 외울 5가지

Antigravity의 5대 핵심 기능.

기능 01
🎛️ Manager View
"미션 컨트롤" 화면. 여러 에이전트를 한눈에 지휘. 카드 그리드 + 모델 선택 + 입력창.
기능 02
📝 Editor View
"코드 작업" 화면. VS Code 스타일 + Agent Side Panel 우측. 실제 코드를 보며 작업.
기능 03
📦 Artifacts
5종 산출물(Task List · Plan · Walkthrough · Diff · Recording). Google Docs처럼 댓글 가능.
기능 04
🌐 Browser Subagent
에이전트가 진짜 크롬을 조작. 빨간 점이 클릭하는 모습이 보입니다. 자동 녹화.
기능 05
🎬 Walkthroughs
에이전트가 한 일을 영상·스크린샷으로 자동 정리. "내가 뭐 했는지" 보고서.
+ BONUS
⚡ 5개 병렬 실행
한 사람이 5개 에이전트를 동시에 굴립니다. 5인 팀 = 1인.
MODELS · 2026.05 · Gemini 3.5 Flash

새로운 제미나이 3.5는 에이전트가 오래 일하게 만든 모델입니다.

Google Korea 블로그 기준, Gemini 3.5 Flash는 2026년 5월 19일부터 Antigravity, Google AI Studio, Android Studio의 Gemini API, Gemini 앱, 검색 AI 모드에서 제공됩니다.

NEW · 핵심
Gemini 3.5 Flash
빠른 속도를 유지하면서 코딩과 에이전트 작업 성능을 크게 끌어올린 최신 Flash 모델입니다.
왜 중요?
장기 작업에 강함
앱 만들기, 코드베이스 유지보수, 여러 단계의 계획·실행·수정 같은 긴 작업을 더 안정적으로 처리하도록 소개되었습니다.
Antigravity 연결
하네스 + 서브에이전트
Antigravity 하네스와 결합해 여러 subagent가 협업하는 다단계 코딩 워크플로우에 쓰입니다.
초보자 비유
빠른 팀장형 AI
단순 답변만 하는 AI가 아니라, 일을 쪼개고 여러 보조 AI를 움직이며 결과를 확인하는 팀장에 가깝습니다.
3.5 Pro
2026년 6월 예정
Google은 3.5 Pro도 준비 중이며, 2026년 5월 19일 글에서 다음 달 정식 출시 예정이라고 밝혔습니다.
수업에서 쓰는 법
Plan mode에 적합
"먼저 계획 → 구현 → 브라우저 검증 → GitHub PR 요약"처럼 긴 루틴을 맡길 때 특히 의미가 큽니다.
VS · 다른 AI 코딩 도구

Cursor · Copilot과 무엇이 다른가.

GitHub Copilot
"줄 단위 자동완성"
VS Code 안에서 한 줄씩 추천. 사람이 운전, AI는 옆자리.
📅 2021 · 월 $10 · MS 인수
Cursor
"파일 단위 채팅"
VS Code fork. 파일·프로젝트 맥락 이해. 사람이 주도, AI는 부조종사.
📅 2023 · 무료 + 유료 · Anysphere
Antigravity
"미션 단위 자율"
에이전트가 계획·실행·검증까지 자율. AI가 주도, 사람은 매니저.
📅 2025 · 무료 (Public Preview) · Google

🎯 결론: 코딩 경험이 적을수록 — Antigravity 같은 "자율 모드"가 더 빨리 결과물을 줍니다. 한 줄 한 줄 자동완성을 받아 적을 게 아니라면.

PART 02

설치와
첫 실행.

어렵지 않습니다. 10분이면 — 다운로드부터 첫 채팅까지 끝납니다. 이 파트에서 우리는 함께 설치 화면을 한 장씩 따라가 봅니다.

DOWNLOAD · 4 steps

다운로드 — 4단계면 끝.

STEP 01
🌐 사이트 열기
antigravity.google 주소를 브라우저에 입력. Google 공식 페이지가 열립니다.
STEP 02
💻 OS 선택
macOS · Windows · Linux 중 본인 OS 선택. 자동 감지되기도 합니다.
STEP 03
⬇️ 설치 실행
받은 파일을 더블클릭 → "응용 프로그램"으로 드래그. (Mac 기준 1분 소요)
STEP 04
▶️ 실행
앱 아이콘 클릭. 환영 화면이 뜨면 — 설치 성공입니다.

⚠️ 주의: macOS는 첫 실행 시 "확인되지 않은 개발자" 경고가 나올 수 있습니다. 시스템 설정 → 개인정보 → 보안에서 "확인 후 열기".

UI MOCKUP · 첫 실행 화면

앱을 켜면 — 이런 화면이 뜹니다.

Welcome to Antigravity
에이전트 우선 IDE — 코드를 짓는 새로운 방법
Public Preview · Free · No credit card required
설치 완료 후 첫 화면 — "Get Started" 버튼을 누르면 설정 마법사로 이동합니다
UI MOCKUP · Setup 1/3 · Theme

테마 선택 — Dark 추천.

화면 색상은 언제든 바꿀 수 있습니다(Mac: Cmd + , / Win: Ctrl + ,). 처음에는 Dark로 — 코드 가독성과 눈 피로도 측면에서 가장 무난합니다.

Choose your theme
언제든 변경할 수 있어요 (Mac: Cmd + , / Win: Ctrl + ,)
🌙 Dark Selected
눈 피로 적음 · 코드 가독성 우수
☀️ Light
밝은 환경에서 글자 선명
UI MOCKUP · Setup 2/3 · Autonomy Level

자율성 모드 — "Review-driven"이 추천.

에이전트가 얼마나 자유롭게 일하게 할지 결정하는 단계입니다. 초보자는 "Review-driven"으로 시작하세요. 익숙해지면 변경 가능.

🔒
Secure
보안 모드
가장 제한적. 모든 행동을 사람이 일일이 검토. 속도는 느리지만 가장 안전.
Agent-driven
에이전트 주도
거의 자율. 사람 개입 최소. 속도 빠르지만 실수 위험. 익숙해진 뒤에.
🛠️
Custom
커스텀
직접 항목별로 ON/OFF. 파일 접근, 터미널, 브라우저 — 각각 별도 설정.

🎯 결정: 처음에는 Review-driven. 한 달 정도 써보고 — 확신이 서면 Agent-driven으로 옮기세요.

STEP 3/3 · Sign-in & Open Folder

로그인 → 폴더 열기 → 첫 채팅.

STEP 01
🔑 Google 계정 로그인
평소 쓰는 Google 계정으로 로그인. 이메일 1개면 충분합니다. 2단계 인증이 켜져 있어도 OK.
STEP 02
📜 약관 동의
개인정보·코드 사용 정책 동의. 중요: 무료 Public Preview는 학습용 데이터로 일부 활용될 수 있습니다.
STEP 03
📁 폴더 열기 (Open Folder)
바탕화면에 "my-first-antigravity" 폴더를 새로 만들고 — 그 폴더를 선택하세요. 이게 워크스페이스입니다.
STEP 04
💬 첫 채팅
상단의 "Ask anything..." 입력창에 — 한국어로 — "안녕? 너는 뭘 할 수 있어?"라고 입력해보세요.
EXERCISE 01 · 5분 실습

첫 명령 — "go to antigravity.google"

진짜 명령은 이걸로 시작해보세요. 에이전트가 — 브라우저를 열고 — 그 페이지로 갈 겁니다. 본인이 시킨 게 진짜로 동작하는 첫 순간.

🎯 실습 — 입력창에 입력하고 Enter, 직접 결과 보기
  • Manager View에서 입력창 클릭. 그 안에 → go to antigravity.google and tell me what you see
  • Enter 또는 ↑ 화살표(Submit) 클릭.
  • 화면에 "에이전트 카드"가 하나 생깁니다. "Running" 배지를 확인하세요.
  • Browser Subagent 창이 자동으로 열립니다. 빨간 테두리가 둘러진 Chrome 창.
  • 에이전트가 페이지를 본 뒤, 채팅창에 한국어로 "Antigravity 다운로드 페이지가 보입니다" 같은 답을 합니다.
  • 👏 축하합니다 — 처음으로 AI에게 "임무"를 줘서 — 결과물을 받은 순간입니다.

💡 안 되면? — Browser Subagent용 Chrome 확장이 필요할 수 있습니다. 5장에서 자세히 다룹니다.

PART 03 · 가장 중요한 파트

두 가지
화면을 익힙니다.

Antigravity의 모든 작업은 — Manager View(지휘 화면)와 Editor View(작업 화면) 사이를 오가며 일어납니다. 이 두 화면이 손에 익으면 — 나머지는 자연스럽게 따라옵니다.

OVERVIEW · 두 화면, 두 시점

Manager는 "지휘", Editor는 "작업".

🎛️ MANAGER VIEW
"미션 컨트롤"
  • 여러 에이전트를 한 번에 5개까지 굴리는 카드 그리드
  • "Ask anything" 입력창으로 새 작업 시작
  • 모델 선택 (Gemini · Claude · GPT-OSS)
  • Plan 모드 vs Fast 모드 토글
  • 비유 = 팀장의 책상
📝 EDITOR VIEW
"실제 코드 작업"
  • VS Code 스타일 — 파일 트리 · 코드 · 터미널
  • 우측 Agent Side Panel: Cmd/Ctrl + L
  • 인라인 AI 명령: Cmd/Ctrl + I
  • Artifacts 결과를 직접 검토 · 수정
  • 비유 = 개발자의 책상

💡 화면 전환: Mac Cmd+E / Windows Ctrl+E

UI MOCKUP 1 · Manager View · 전체 화면

🎛️ Manager View — 미션 컨트롤.

Antigravity My Workspace
Gemini 3 Pro ▾
Mission Control
📥Inbox3
📁Workspaces
🎮Playground
Account
⚙️Settings
📚Docs
Start a new conversation
Ask anything... build a lesson quiz generator service
@ files / workflow 🌐 Browser Plan ▾
ACTIVE AGENTS · 3 / 5
Build Login Form ● Running
Creating HTML structure and validation logic...
8 / 11 tasks · ~2min left
Refactor API Layer ⚠ Review
Done. 4 files changed. Awaiting your approval.
Review needed →
Write README.md ✓ Done
Generated 3 sections. View Walkthrough.
2 min ago · 6 tasks
상단: 모델 선택 + Open Editor · 좌측: Inbox / Workspaces / Playground / Settings · 중앙: 입력창 + 에이전트 카드 그리드
UI MOCKUP 2 · Agent Card · Detail

에이전트 카드를 클릭하면 — 이렇게 보입니다.

Build Login Form
Started 2 min ago · Gemini 3 Pro · High
● Running
📌 Currently: Building login form with email validation, password strength meter, and "Forgot password" link.
PROGRESS · 8 / 11 TASKS
ARTIFACTS · 3
📋
Task List
11 items
📐
Plan
Architecture
🎬
Walkthrough
0:42
① 이름 + 상태
에이전트마다 이름이 자동 생성됩니다. 상태 배지: Running / Pending Review / Completed.
② 현재 작업 한 줄
"지금 뭘 하고 있는지" 자연어로 표시. 클릭하지 않아도 즉시 파악 가능.
③ 진행률
총 태스크 중 몇 개를 끝냈는지 막대그래프로. 호버하면 남은 시간 추정.
④ Artifacts 썸네일
3개 이상이면 스크롤. 클릭 → 해당 산출물 상세 뷰로 점프.
⑤ Approve / Reject / Comment
에이전트의 결과물을 승인하거나 거부·수정 요청. 핵심 컨트롤.
UI MOCKUP 3 · Editor View · 전체 화면

📝 Editor View — VS Code + Agent.

File · Edit · View · Run
README.md index.html style.css app.js
Mac: Cmd+E · Win: Ctrl+E · Manager
EXPLORER
📁 lesson-kit-builder
📁 src
📄 main.js
📁 components
📄 index.html
📄 style.css
📁 assets
🖼️ logo.svg
📄 README.md
📄 package.json
1
2
3
4
5
6
7
8
9
10
11
12
<!-- Portfolio site by Antigravity -->
<!DOCTYPE html>
<html lang="ko">
<head>
  <meta charset="UTF-8" />
  <title>Daniel · Portfolio</title>
</head>
<body>
  <section class="hero">
    <h1>Hi, I'm Daniel.</h1>
    <p>Frontend Engineer</p>
  </section>
$ npm run dev
vite v5.4.0 ready in 312 ms
➜ Local: http://localhost:5173/
➜ press h to show help
$
Agent · Cmd/Ctrl+L Sonnet 4.5
YOU
Hero 섹션에 다크 그라데이션 배경 추가해줘
ANTIGRAVITY
style.css.hero 클래스에 그라데이션 추가했어요. 3개 파일이 변경되었습니다 — Diff 검토하시겠어요?
ARTIFACT
📐 Code Diff style.css · +12 / -3
Ask anything...
좌측: 파일 트리 · 중앙: 코드 + 터미널 · 우측: Agent Side Panel (Mac: Cmd+L / Win: Ctrl+L 토글)
UI MOCKUP 4 · Inline Edit · Mac: Cmd+I / Win: Ctrl+I

코드 위에서 — "이 줄만 고쳐줘".

Editor View에서 코드 한 줄을 선택 → Mac: Cmd + I / Win: Ctrl + I를 누르면 — 그 자리에 작은 입력창이 떠오릅니다. 파일 전체를 건드리지 않고 부분만 수정 지시.

index.html — Editor View
14
15
16
17
18
19
20
21
  <section class="projects">
    <h2>My Projects</h2>
    <p>3 cards here</p>
  </section>
  <section class="contact">
    <h2>Contact</h2>
  </section>
</body>
Cmd/Ctrl+I
Ask Antigravity to edit this line...
Esc to cancel
선택된 줄이 노란색으로 강조되고 — 그 자리에 작은 프롬프트 입력창이 떠오릅니다
UI MOCKUP 5 · Model Selector

상단 우측의 드롭다운 — 7개 모델.

📌 일반 작업
Gemini 3 Pro · High
기본값. 95%의 작업에는 이거 하나면 충분합니다.
⚡ 빠른 일
Gemini 3 Flash
간단한 변경, 자동완성. 응답 1-2초.
💻 코딩 + 리팩터링
Claude Sonnet 4.5
복잡한 코드 변경 — Thinking 모드 켜면 더 좋음.
🧠 깊은 추론
Claude Opus 4.5
버그 원인 분석, 아키텍처 설계. 가장 똑똑함.
PLAN MODE · 먼저 생각하고, 그다음 실행

Plan mode는 코딩 전에 멈춰 세우는 안전장치입니다.

Antigravity의 Fast mode는 바로 실행, Plan mode는 먼저 조사하고 작업 목록과 구현 계획을 만든 뒤 사람이 검토하게 합니다. 초보자는 큰 작업일수록 Plan mode가 기본입니다.

Fast mode

작은 변경
바로 파일 수정
빠르지만 실수 발견이 늦음
예: 버튼 문구 변경, 변수명 수정

Plan mode

요구사항 해석
Task List + Implementation Plan
사람 승인 후 구현
예: 새 서비스, DB 설계, 여러 파일 수정

기억할 문장: "새 기능·여러 파일·삭제 가능성·DB 작업은 Plan mode."

TOOL CHOICE · 어디에 무엇을 시킬까

Gemini·Claude·Antigravity Plan mode는 역할이 다릅니다.

일반 Gemini

아이디어 정리, 문제 정의, 시장/고객 관점, 빠른 초안에 좋습니다. 보통은 대화형이라 로컬 파일을 직접 고치거나 브라우저 검증까지 맡기는 도구는 아닙니다.

Claude

긴 문서 읽기, 복잡한 로직 설명, 리팩토링 리뷰, PRD 비판에 강합니다. 설계 품질을 올릴 때 좋지만, 채팅만 쓰면 실행은 사람이 옮겨야 합니다.

Antigravity Plan mode

파일, 터미널, 브라우저, GitHub, Artifact를 연결해 실제 작업을 진행합니다. 계획을 먼저 받고 승인한 뒤 구현·검증까지 이어가는 IDE 에이전트입니다.

Gemini에 시킬 일

“이 아이디어의 문제 정의, 고객 페르소나, IA, Critical UJ, PRD를 만들어줘.”

Claude에 시킬 일

“이 PRD에서 빠진 정책, edge case, 데이터 구조 리스크를 찾아줘.”

Antigravity에 시킬 일

“이 PRD를 바탕으로 Plan부터 만들고, 승인 후 파일을 구현하고, 브라우저에서 Critical UJ를 검증해줘.”

CONTEXT · @ 멘션으로 정보 첨부

@로 에이전트에게 맥락을 줍니다.

Agent 채팅창에 @를 입력하면 자동완성이 떠요. 파일·터미널·에러·MCP 서버까지 한 번에 첨부.

로그인 폼 검증 로직을 다시 짜줘. @
SUGGESTIONS · 자주 쓰는 멘션
📂@workspace
전체 프로젝트 워크스페이스를 컨텍스트로 포함
📄@file
특정 파일 (이름·경로로 검색)
⌨️@terminal
현재 터미널 출력 첨부 (에러 디버깅에 최고)
⚠️@problems
Problems 패널의 모든 에러·경고 첨부
✂️@selection
현재 에디터 선택 영역 텍스트
🔎@codebase
인덱싱된 모든 파일을 시맨틱 검색
MCP 서버 멘션
@Supabase · @Firebase · @Linear · @Vercel · @Cloudflare
설정한 MCP 서버를 멘션으로 호출. 예: @Supabase users 테이블 스키마 보여줘
💡 초보자 팁: @workspace는 마지막에
전체 워크스페이스를 매번 첨부하면 토큰 많이 쓰고 느려요. 처음엔 @file·@selection으로 좁게, 모를 때만 @workspace.
WORKFLOWS · / 로 호출하는 저장된 프롬프트

/로 자주 쓰는 작업을 한 줄에.

/를 입력하면 저장된 워크플로우 목록이 나옵니다. 매번 같은 프롬프트를 다시 쓰지 않아도 됨.

/
WORKFLOWS · 기본 제공 + 내가 만든 것
🧪/generate-unit-tests
선택 코드/파일의 유닛 테스트 자동 생성
🩹/fix-errors
Problems 패널 에러를 일괄 수정
📖/explain
선택 코드 블록을 자연어로 설명
♻️/refactor
가독성·성능 위주로 리팩토링
📝/document
JSDoc/docstring 코멘트 추가
🚀/deploy
커스텀 배포 워크플로우 트리거
📁 파일 위치
전역 / 워크스페이스
· 전역: ~/.gemini/antigravity/global_workflows/
· 프로젝트: .agents/workflows/
✏️ 직접 만들기
내 워크플로우 = .md 파일
자주 쓰는 프롬프트를 my-workflow.md로 저장 → /my-workflow로 호출.
💡 팀에 공유하기
.agents/workflows/를 git에 커밋하면 팀원 모두가 같은 단축 명령을 쓸 수 있어요.
NEW · April 2026 v1.23.2 · 3-column 리디자인

Manager Surface — 3-column 새 UI.

▲ Antigravity · Walkthroughs · my-workspace NEW
📚 Walkthroughs 8
React + TypeScript 셋업
완료 · 3분 소요
Next.js 프로젝트 생성
진행 중 · Step 3/6
Tailwind 도입
대기 중
shadcn/ui 컴포넌트
대기 중
ESLint + Prettier
대기 중
Supabase 연동
대기 중
▶ Next.js 프로젝트 생성 3/6
진행률50%
의존성 매니저 결정
npm 선택됨 · 12초
create-next-app 실행
완료 · 1분 4초
3
App Router vs Pages Router
사용자 결정 대기 중 →
4
TypeScript 활성화
대기 중
5
초기 페이지 스캐폴딩
대기 중
🎯 Decision 대기 중
Step 3 결정
App Router를 쓸까요, Pages Router를 쓸까요?
Pages Router
레거시. 기존 Next 12 코드와 호환. 학습 자료가 더 많음.

💬 왜 이걸 묻나요? Walkthrough는 중요한 결정에서만 멈춥니다. 사소한 건 알아서 결정해요.

🆕 v1.23.2부터: 왼쪽=목록 / 가운데=진행 / 오른쪽=결정 — 탭 전환 없이 한 화면에서 비교·결정.

NEW · Walkthroughs · 대화형 셋업 가이드

Walkthroughs — 20분 셋업이 3분으로.

Manager Surface에 새로 추가된 기능. 프로젝트 초기화, 라이브러리 도입, 아키텍처 결정을 step-by-step으로 안내합니다.

📦 프로젝트 초기화
"새 React 앱 만들기"
의존성 매니저 → 라우터 선택 → TypeScript → 초기 폴더 구조까지 한 번에.
🏗️ 아키텍처 결정
"Firebase vs Supabase?"
두 옵션을 한 화면에 띄워 탭 전환 없이 비교. 통합 비용·기능·학습곡선까지.
📚 라이브러리 도입
"shadcn/ui 깔기"
설치 → config → 첫 컴포넌트 import까지 가이드. 모르는 게 있으면 멈춰서 물어봄.
🤔 사용자 결정 지점
중요할 때만 stop
사소한 건 알아서. 중요한 결정만 "어느 방향이 좋으세요?" 물어봄.
⏱️ 시간 절약
React+TS+Tailwind
기존: ~20분 · Walkthroughs: ~3분. 거의 7배.
📂 직접 만들기
.agents/walkthroughs/
팀 표준 셋업을 .md 파일로 저장 → 팀원 누구나 같은 방식으로 시작.

📍 출처: Antigravity Lab — April 2026 Update Notes · React + TypeScript + Tailwind 셋업 벤치마크 기준.

EXERCISE 02 · 5분 실습

실습 — Hello World.

시나리오 — Cmd/Ctrl+E로 화면 전환
  • Manager View에서 입력: Hello World HTML 페이지 만들어줘. 다크 모드, 가운데 정렬.
  • Submit ↑ → 에이전트 카드가 생기고 작업 시작.
  • Mac: Cmd + E / Win: Ctrl + E로 Editor View로 전환. 새로 만들어진 index.html 파일을 확인.
  • Mac: Cmd + L / Win: Ctrl + L로 Agent Side Panel 열기. "잘 됐는지 미리보기 띄워줘"라고 입력.
  • localhost 주소를 열어 브라우저에 "Hello World"가 다크 배경에 뜨면 성공.
PART 04

Artifacts와
검증.

에이전트가 만든 결과물을 — 사람이 검토할 수 있는 형태로 자동 변환. 이게 바로 Antigravity의 "Artifacts"입니다. Google Docs처럼 댓글로 피드백할 수 있다는 게 핵심.

WHAT · 정의

Artifacts = "검토 가능한 산출물".

에이전트가 일을 끝내면 — "내가 뭘 만들었는지"를 사람이 읽을 수 있는 형태로 자동 정리합니다. 코드만 던지지 않고 — 작업 과정 + 결과를 함께 패키징.

왜 필요한가
"AI가 뭘 했는지" 이해하기 위해
코드만 보면 — 무엇이 바뀌었는지, 왜 바뀌었는지 파악이 어렵습니다. Artifacts는 맥락을 함께 보여줍니다.
어떻게 다른가
"읽고 댓글 가능"
Google Docs처럼 — Artifact의 한 줄을 선택해 💬 댓글로 수정 요청. 에이전트가 그걸 반영해 다시 작업.
언제 만들어지나
자동 — 작업 시작 시
사용자가 작업을 시킬 때마다 — Task List와 Plan이 먼저 만들어집니다. 코드 작성 전에 검토 단계.
총 5종
Task List · Plan · Walkthrough · Diff · Recording
작업 종류에 따라 — 일부 또는 전부가 생성됩니다. 다음 슬라이드에서 하나씩.
FIVE TYPES · 5종 산출물

Artifacts 5가지 — 각자 역할이 다릅니다.

📋 01 · Task List
작업 목록 (체크리스트)
에이전트가 만들 단계별 계획. "이 순서대로 할게요"의 미리보기.
📐 02 · Implementation Plan
구현 계획서 (기술 문서)
아키텍처·파일 구조·라이브러리 선택 등 기술 결정을 문서화. 코딩 시작 전에 검토.
🎬 03 · Walkthrough
스크린샷 + 영상 요약
"내가 뭘 했는지" 자동 영상 + 단계별 캡처. 증거 기록으로도 활용.
📝 04 · Code Diffs
변경 사항 비교
옛 코드 / 새 코드를 좌우로 비교. 빨강 = 삭제, 초록 = 추가. Git 사용 경험 무관 OK.
🎥 05 · Browser Recordings
브라우저 녹화본
Browser Subagent가 한 모든 클릭·입력을 동영상으로 자동 저장. 디버깅 + 증거.
+ 공통 기능
💬 댓글 · 공유 · 버전 관리
모든 Artifact는 — Google Docs처럼 댓글, 링크 공유, 변경 이력 추적이 됩니다.
UI MOCKUP · Task List Artifact

📋 Task List — 체크리스트로 진행 상황 한눈에.

📋 TASK LIST · ARTIFACT
Build Login Page
2 / 4 done
Create HTML structure
index.html · 28 lines added · 2 min ago
Add CSS styles (dark theme)
style.css · 64 lines added · 1 min ago
Validate email format with regex
⚡ In progress · ~30s left
💬 1
Connect to /api/login backend
Pending
Add "Forgot password" flow
Pending · subtask of #4

💡 한 항목에 댓글을 달면 — 에이전트가 그걸 반영해 해당 단계만 다시 작업합니다.

UI MOCKUP · Implementation Plan Artifact

📐 Implementation Plan — 기술 결정을 문서화.

Implementation Plan · Build Login Page

v1.0 · Generated by Antigravity · Gemini 3 Pro · 2 min ago

## Architecture

UI · index.html
Validation · validator.js
API · /api/login
DB · users table

가장 단순한 구조로 시작합니다. 추후 OAuth 추가 시에는 Validation 단계 사이에 Auth Provider를 끼울 수 있도록 — validator.js를 인터페이스로 분리해 두었습니다.

## Files to change

  • src/index.html — 새 파일 · 폼 구조
  • src/style.css — 새 파일 · 다크 모드 스타일
  • src/validator.js — 새 파일 · 이메일·비번 정규식
  • api/login.js — 새 파일 · POST /api/login
  • README.md — 수정 · "Login Page" 섹션 추가

## Decisions

  • 비밀번호 해시: bcrypt (saltRounds = 10)
  • 이메일 검증: RFC 5322 단순 정규식 (서버에서 재검증)
  • 프레임워크 없이 — 바닐라 HTML/CSS/JS만 사용 (사용자 요청)

💡 이 단계에서 "bcrypt 말고 argon2 써줘" 같은 댓글을 달면 — 코딩 시작 전에 결정이 바뀝니다.

UI MOCKUP · Code Diff Viewer

📝 Code Diff — 빨강 vs 초록으로 변경 비교.

— BEFORE · style.css
 .hero {
  background: black;
  color: white;
   padding: 60px 40px;
 }
 
 .hero h1 {
  font-size: 32px;
   font-weight: 700;
 }
+ AFTER · style.css
 .hero {
+  background: linear-gradient(180deg, #0a0a0a, #1a1a2e);
+  color: #f5f5f7;
+  min-height: 100vh;
   padding: 60px 40px;
 }
 
 .hero h1 {
+  font-size: clamp(40px, 6vw, 72px);
   font-weight: 700;
 }

💡 읽는 법: 좌측은 옛 코드, 우측은 새 코드. 빨강(−) = 삭제됨, 초록(+) = 추가됨. Git 몰라도 OK.

UI MOCKUP · Walkthrough Viewer

🎬 Walkthrough — "내가 한 일"의 영상 보고서.

Walkthrough · login-page-v1.mp4
0:24 / 1:12 · Speed 1x

STEPS · 6 chapters

  1. Open browser at localhost:5173
  2. Click email field, type "test@user.com"
  3. Tab to password field
  4. Type "wrongpass" → see red error
  5. Type valid password → green check
  6. Click "Login" → success redirect

💡 영상은 자동 챕터 분할됩니다. 우측 단계명 클릭 → 해당 시점으로 점프. 보고서·증거·디버깅 모두에 활용.

WORKFLOW · 5단계

댓글 피드백 — 5단계면 끝.

STEP 01
📂 Artifact 클릭
에이전트 카드 안의 Artifact 썸네일 클릭. 큰 화면으로 열림.
STEP 02
✏️ 텍스트 선택
댓글 달고 싶은 줄·단락을 드래그 → 선택.
STEP 03
💬 댓글 입력
우측에 뜨는 💬 아이콘 클릭 → "이 부분 더 간단히" 같은 한국어 자연어.
STEP 04
📤 제출
Submit. 에이전트가 댓글을 읽고 → 해당 부분만 다시 작업.
STEP 05
✅ 반영 확인
Diff에 새 변경사항이 추가됨. 마음에 들면 Approve.

💡 팁: "이 부분 다시 해줘"보다 — "이 부분에서 ~~~을 ~~~으로 바꿔줘"가 정확도 훨씬 높습니다.

NEW · 2026.04 v1.23.2 · Browser Agent 안정성 ↑

Browser Agents — 4월에 크게 좋아진 4가지.

초기에 가장 자주 망가지던 부분이 Browser Agent였습니다. 4월 업데이트로 SPA·React·멀티 탭·폼 처리가 모두 안정화되었어요.

개선 01 · JS 초기화 감지
jQuery / React 로딩 완료 정확히 감지
기존: DOM이 안 잡혀 클릭 실패 · 신규: waitForNavigation 로직 강화로 SPA·대시보드도 안정.
개선 02 · 멀티 탭 안정화
GitHub Actions + Vercel 동시 OK
병렬 탭에서 컨텍스트 잃지 않음. 빌드 로그 보면서 배포 대시보드도 동시에 — 진짜 매니저처럼.
개선 03 · 폼 입력/제출 분리
Fill → Inspect → Submit 3단계
기존: 한 번에 전송 (위험) · 신규: 입력하고 → 무엇이 들어갔는지 보고 → 그 다음 제출. 비밀번호 노출 사고 방지.
개선 04 · 통합 Permissions
v1.22.2부터 Allow/Deny/Ask 통합
에이전트의 모든 액션(파일·터미널·브라우저·MCP)을 한 화면에서 통제. 보안 사고 시 빠른 차단.
🐢 그래도 빠르진 않아요
각 단계당 2~5초 소요. 복잡한 워크플로우는 1~2분 걸립니다. 그래도 사람이 직접 하는 것보다 정확도가 높고 자동 녹화되니 검증 편함.
EXERCISE 03 · 8분 실습

실습 — Todo 앱 시키고 Task List 검토.

🎯 시나리오 — Plan 모드로 시키고, Task List에 댓글 달기
  • Manager View 입력창 → Plan 모드 ON (드롭다운에서 선택).
  • 입력 → 간단한 todo 앱 만들어줘. 추가·삭제·완료 체크. localStorage에 저장.
  • Submit → 에이전트가 먼저 Task List를 만들어 보여줍니다 (코드 작성 전).
  • Task List 한 줄을 선택 → 💬 댓글: "완료된 항목은 취소선 처리해줘"
  • Submit 후 — Task List가 업데이트되었는지 확인.
  • Approve → 에이전트가 실제 코딩 시작. 끝나면 Walkthrough를 함께 보세요.
PART 05

Browser
Subagent.

가장 인상적인 기능. 에이전트가 — 진짜 크롬 브라우저를 열고, 클릭하고, 입력합니다. 빨간 점이 화면 위에서 움직이는 모습이 — 처음엔 좀 무섭고, 나중엔 신기합니다.

WHAT

Browser Subagent — "크롬을 조작하는 AI".

정의
메인 에이전트가 부르는 보조 에이전트
"브라우저로 ~~~ 해줘" 한 줄이면 — 자동으로 호출됩니다. 별도 설정 불필요.
동작 방식
실제 Chrome 창이 열림
Antigravity Chrome 확장이 설치되어 있어야 함. 첫 사용 시 자동 안내.
시각화
"빨간 테두리 + 빨간 점"
Agent Control 모드. 사용자가 어디 클릭하는지가 시각적으로 강조 — 사람이 따라보기 쉽게.
자동 녹화
모든 행동이 영상으로 저장
자동 → Walkthrough Artifact로 변환. 디버깅·증거·사용자 시연에 활용.
UI MOCKUP · Chrome with Agent Control

🌐 빨간 테두리 = "AI가 조작 중".

🤖 AGENT CONTROL · Antigravity is operating this tab ⏺ REC 0:14
🌐 Login · example.com ✕
https://example.com/login

💡 시각 신호: ① 굵은 빨간 테두리 ② 상단 "Agent Control" 라벨 ③ 빨간 점(AI 커서) ④ 우측 REC 표시 — 4가지로 사용자가 즉시 인지 가능.

USE CASES · 4가지 활용

언제 쓰는가 — 4가지 시나리오.

USE CASE 01
🧪 UI 검증
방금 만든 화면이 — 진짜로 동작하는지 자동 클릭 테스트. "이 버튼 클릭하면 뭐가 뜨는지 보여줘".
USE CASE 02
🔁 E2E 테스트
로그인 → 게시글 작성 → 댓글 달기까지 — 사용자 흐름 전체를 자동화. 매번 손으로 안 해도 됨.
USE CASE 03
📊 데이터 스크래핑
"이 사이트 표를 CSV로 뽑아줘". 단, Robots.txt와 이용약관은 사용자 책임.
USE CASE 04
🎬 사용자 플로우 녹화
"신규 가입 흐름을 1분 영상으로 만들어줘" → 자동 녹화 → Walkthrough Artifact로 발표 자료에 바로.
SAFETY · 반드시 지켜야 할 4가지

⚠️ 안전 가이드 — 사고 방지.

에이전트가 진짜 클릭·입력을 한다는 건 — 계정·결제·민감정보도 만질 수 있다는 뜻. 시작 전에 이 4가지를 꼭 외우세요.

RULE 01 · 도메인
🔒 신뢰 도메인만
  • 본인 사이트, localhost, 검증된 공개 사이트
  • 은행·SNS·이메일은 로그인된 채로 두지 말 것
  • 의심 도메인은 Allowlist에서 빼기
RULE 02 · 비밀번호
🔑 비밀번호 입력 사이트 주의
  • 실제 비밀번호를 채팅에 직접 적지 말 것
  • 테스트 계정·더미 데이터로만 시연
  • 녹화본에 비번이 노출됐다면 즉시 변경
RULE 03 · Allowlist
📋 도메인 화이트리스트
  • Settings → Browser → Allowlist에 도메인 등록
  • 그 외 도메인은 자동 차단
  • 업무용 / 개인용 워크스페이스 분리
RULE 04 · 녹화 관리
🎥 녹화본 정기 삭제
  • 녹화에는 화면 그대로가 담깁니다
  • 외부 공유 전 — 민감 정보 가리기
  • 월 1회 — 오래된 녹화 자동 삭제 설정
EXERCISE 04 · 5분 실습

실습 — "antigravity.google" 캡처.

🎯 시나리오 — Browser Subagent로 공식 사이트 캡처해서 README에 붙이기
  • Manager View 입력창 → "🌐 Browser" 토글 ON.
  • 입력 → antigravity.google에 가서 다운로드 섹션을 스크린샷으로 찍고, README.md에 "## Install" 섹션과 함께 추가해줘.
  • Submit. 빨간 테두리 Chrome이 자동 실행됩니다.
  • 빨간 점이 스크롤·클릭하는 모습을 그대로 보세요. (개입 안 해도 됩니다)
  • 녹화가 끝나면 — Walkthrough Artifact로 자동 정리됩니다.
  • README.md에 이미지가 들어갔는지 Editor View에서 확인. 끝!

💡 처음에는 — 개입하지 말고 끝까지 지켜보세요. 에이전트가 어떻게 일하는지 감을 잡는 가장 좋은 방법.

PART 06 · IDEA TO AGENT WORK

아이디어를
Antigravity 작업으로 바꾸는 법.

초보자가 가장 많이 막히는 지점은 코드가 아니라 무엇을 정확히 시킬지입니다. Gemini나 Claude로 기획을 정리하고, 그 결과를 Antigravity가 실행 가능한 작업 지시서로 바꾸는 루틴을 손에 익힙니다.

문제 정의누구의 어떤 불편을 없앨지
페르소나사용자의 상황·목표·제약
IA화면·정보·기능 구조
UJ / Critical UJ성공 경로와 절대 실패하면 안 되는 경로
User Flow클릭·입력·오류 흐름
정책 / PRD범위, 데이터, 권한, 수용 기준
프롬프트 추출Gemini·Claude 결과를 실행 지시로 변환
Antigravity 작업Plan 승인 → 구현 → 검증 → GitHub
ROLE SPLIT · 도구별로 시킬 일 나누기

세 도구를 한 팀처럼 씁니다.

처음부터 Antigravity에 "앱 만들어줘"라고 던지면 결과가 흔들립니다. 먼저 Gemini나 Claude로 생각을 정리하고, Antigravity에는 실행 가능한 산출물을 줍니다.

Gemini / Claude가 잘하는 일

  • 막연한 아이디어를 문제 정의로 정리
  • 고객 페르소나와 Job Story 만들기
  • IA, User Journey, User Flow 초안 만들기
  • PRD, 정책, 수용 기준을 문서화
  • Antigravity에 줄 최종 프롬프트로 압축

Antigravity가 잘하는 일

  • 파일 생성·수정, 패키지 설치, 터미널 실행
  • 브라우저로 직접 UI를 열어 클릭 테스트
  • Task List, Implementation Plan, Code Diff 작성
  • 스크린샷·녹화 Walkthrough로 검증 증거 제공
  • GitHub 커밋, PR 설명 초안, README 정리
STEP 01 · Problem Definition

문제 정의는 "불편 + 증거 + 성공 기준".

앱 아이디어를 바로 기능 목록으로 쓰지 마세요. 먼저 사용자가 지금 어떤 방법으로 버티는지, 어디서 시간을 잃는지, 성공을 어떻게 판단할지 적습니다.

1. 대상 사용자

누가 이 문제를 겪나요? 직업, 상황, 빈도, 디지털 숙련도를 적습니다. 예: "매주 3개 이상 수업 자료를 만드는 강사".

2. 현재 불편

지금은 어떤 도구와 꼼수로 해결하나요? 복붙, 엑셀, 카톡, 노션, 수기 입력 같은 현재 행동을 적습니다.

3. 손실과 증거

시간, 비용, 오류, 스트레스를 숫자로 적습니다. 예: "매주 2시간", "누락 3건", "학생 문의 10개".

4. 성공 기준

완성 후 무엇이 달라져야 하나요? 예: "10분 안에 수업 자료 요약본과 퀴즈 5개 생성".

STEP 02 · Persona

페르소나는 마케팅 캐릭터가 아니라, 설계 기준입니다.

이 사람이 어떤 화면을 무서워하고, 어떤 버튼을 기대하고, 언제 포기하는지 알면 Antigravity가 만든 UI를 검토할 기준이 생깁니다.

PROFILE
누구인가
이름은 가명. 중요한 건 역할, 숙련도, 사용하는 기기, 주 사용 시간대. "모바일 우선"인지 "데스크톱 업무"인지까지.
JOB
무엇을 끝내려 하나
When [상황], I want to [동기], so I can [결과] 형식으로 1문장. 기능보다 사용자의 목적을 먼저.
PAIN
어디서 막히나
처음 진입, 입력, 결제, 저장, 공유, 삭제 같은 단계별 불안과 실수 지점을 적습니다.
TRIGGER
언제 켜나
매일 아침, 수업 직전, 고객 문의 직후처럼 실제 사용 타이밍. 알림과 첫 화면 설계에 직접 영향.
SUCCESS
성공이라고 느끼는 순간
저장 완료, 공유 링크 복사, 그래프 확인, 업무 시간 단축처럼 사용자 눈에 보이는 완료 신호.
DESIGN RULE
UI 기준으로 변환
예: "초보자라 전문 용어 금지", "모바일 한 손 사용", "삭제 전 확인 모달 필수". 이게 Rules가 됩니다.
STEP 03 · Information Architecture

IA는 화면 지도입니다.

IA를 먼저 정하면 Antigravity가 파일과 컴포넌트를 아무렇게나 만들지 않습니다. 정보, 기능, 액션이 어느 화면에 있어야 하는지 합의합니다.

Global

상단/하단 내비게이션
로그인 상태
설정 / 도움말
공통 오류 메시지

Core Screens

대시보드: 오늘 할 일, 최근 결과
생성 화면: 입력 폼 + 미리보기
상세 화면: 결과 편집, 저장, 공유
히스토리: 과거 결과 검색

Data Objects

User
Project
GeneratedResult
ShareLink
STEP 04 · User Journey / Critical UJ

User Journey는 전체 여정,
Critical UJ는 망치면 안 되는 핵심 길.

모든 화면을 완벽하게 만들려 하지 말고, 먼저 사용자가 "이 앱 쓸 만하다"라고 느끼는 가장 짧은 성공 경로를 고정합니다.

USER JOURNEY · 전체 여정
처음 발견부터 재방문까지
  • 문제 인식 → 검색/추천 → 첫 방문
  • 가입/로그인 → 첫 입력 → 결과 확인
  • 수정 → 저장 → 공유 → 다시 사용
  • 감정: 기대, 불안, 확신, 재사용 의지
CRITICAL UJ · 핵심 성공 경로
이 한 길은 반드시 성공
  • 첫 입력 폼을 30초 안에 이해
  • 결과 생성이 실패해도 복구 가능
  • 결과 저장과 공유 링크 복사가 확실
  • 이 경로는 Browser Subagent로 꼭 녹화 검증
STEP 05 · User Flow

User Flow는 클릭 순서예외 처리입니다.

Happy Path

홈 진입
목표 선택
필수 정보 입력
생성 버튼 클릭
결과 저장

Edge Cases

빈 입력 제출
네트워크 실패
API 키 없음
결과가 너무 김
새로고침 후 복구

검증 지시

각 flow별 테스트 데이터 제공
성공/실패 toast 확인
모바일 390px 화면 확인
Walkthrough에 캡처 첨부
STEP 06 · Policy & PRD

정책과 PRD는 에이전트의 작업 울타리입니다.

초보자일수록 "알아서 잘"이라는 말을 줄여야 합니다. 범위, 데이터, 금지 행동, 완료 기준을 PRD에 적어야 Antigravity가 안전하게 움직입니다.

PRD 01
MVP 범위
이번 버전에 꼭 들어갈 기능 3개와 절대 안 할 기능 3개. "결제는 제외", "관리자 페이지는 제외"처럼 선명하게.
PRD 02
데이터 정책
저장할 데이터, 저장하지 않을 데이터, 더미 데이터 여부, 개인정보 포함 여부. 테스트 계정 사용 원칙 포함.
PRD 03
권한 정책
파일 접근은 workspace-only, 터미널은 Request Review, 삭제 명령은 Deny. Antigravity 설정과 연결.
PRD 04
수용 기준
"Given / When / Then" 형식. 예: 빈 입력이면 생성 버튼 비활성화, 성공 시 저장 toast 표시.
PRD 05
검증 방식
브라우저 수동 테스트, 콘솔 에러 0개, 모바일 캡처, README 실행 방법까지 완료 기준으로 적습니다.
PRD 06
GitHub 기준
커밋 단위, 브랜치 이름, PR 설명, 이슈 링크. 처음부터 협업 방식까지 포함합니다.
STEP 07-A · Planning Prompt

Gemini나 Claude에는 기획 산출물을 뽑게 합니다.

복사해서 쓰는 기획 프롬프트

너는 초보자를 돕는 시니어 PM이야. 내 아이디어를 Antigravity로 구현할 수 있게 아래 산출물을 순서대로 만들어줘. 아이디어: [여기에 만들고 싶은 앱] 대상 사용자: [모르면 가정해줘] 제약: 초보자, 1일 안에 MVP, 무료 도구 우선 산출물: 1. 문제 정의: 대상, 현재 불편, 손실, 성공 기준 2. 고객 페르소나 1명 3. IA: 화면 목록, 핵심 기능, 데이터 객체 4. User Journey와 Critical User Journey 5. User Flow: happy path와 edge case 6. 정책 및 PRD: MVP 범위, 데이터/권한 정책, 수용 기준 7. 마지막에 Antigravity에 붙여넣을 실행 프롬프트

좋은 출력인지 확인하는 기준

  • 기능명보다 사용자의 상황과 성공 기준이 먼저 나온다
  • 화면 목록과 데이터 객체가 분리되어 있다
  • Critical UJ가 1개로 좁혀져 있다
  • 수용 기준이 테스트 가능한 문장이다
  • 마지막 실행 프롬프트에 파일, 검증, 금지사항이 포함된다
STEP 07-B · Execution Prompt

Antigravity에는 "계획부터 검증까지" 명령합니다.

Antigravity 마스터 프롬프트

아래 PRD를 바탕으로 MVP를 구현해줘. 작업 방식: 1. 먼저 Task List와 Implementation Plan을 작성하고 내 승인 전에는 코드 수정하지 마. 2. 파일 구조를 제안하고, 기존 파일을 읽은 뒤 최소 변경으로 구현해. 3. 구현 후 브라우저에서 Critical User Journey를 직접 실행해 검증해. 4. 콘솔 에러, 반응형 390px/1440px, 빈 입력 edge case를 확인해. 5. 마지막에 Code Diff 요약, 실행 방법, 남은 리스크를 README에 정리해. 6. GitHub 커밋 메시지와 PR 본문 초안도 작성해. PRD: [Gemini/Claude가 만든 PRD 붙여넣기]

왜 이렇게 시키나

  • "먼저 Plan"은 초보자의 안전장치입니다
  • Critical UJ 검증은 말뿐인 완료를 막습니다
  • 콘솔·반응형·edge case는 하네스의 최소 테스트입니다
  • README와 PR 초안은 GitHub 협업까지 이어줍니다
  • 이 프롬프트는 프로젝트가 커질수록 더 중요해집니다
STEP 08 · Antigravity Work Loop

실행할 때는 5번 루프만 기억하세요.

LOOP 01
Plan 받기
Task List와 Implementation Plan을 먼저 읽고, 틀린 범위는 댓글로 수정.
LOOP 02
작게 승인
한 번에 전체 앱이 아니라 1~2개 화면 단위로 승인. 리스크를 줄입니다.
LOOP 03
Artifact 검토
Diff, Screenshot, Browser Recording을 보고 "진짜 됐는지" 판단.
LOOP 04
댓글로 수정
코드 직접 수정 전, Artifact에 댓글. "버튼 문구를 더 명확히"처럼 구체적으로.
LOOP 05
GitHub 저장
작동 확인 후 commit → push → PR. 다음 실습의 되돌리기 지점이 됩니다.
PRACTICE LADDER · 쉬운 것부터 어려운 것까지

재밌는 프로젝트는 난이도별로 올라갑니다.

LEVEL 1 · 30분

HTML/CSS/JS · 저장 없음
  • 랜덤 명언 카드 생성기
  • 다크/라이트 토글 페이지
  • 포모도로 타이머
  • MBTI 스타일 퀴즈
  • 프로필 카드 생성기

LEVEL 2 · 1~2시간

localStorage · CRUD
  • Todo + 태그 + 검색
  • 메모장 SPA
  • 습관 트래커
  • 가계부 CSV 업로드
  • 수업 퀴즈 생성기

LEVEL 3 · 반나절

API · 차트 · 인증
  • 날씨 + 지도 대시보드
  • 유튜브 자막 요약 도구
  • 이미지 갤러리 + 필터
  • AI 레시피 추천 앱
  • 스터디 플래너 + 통계

LEVEL 4 · 1~3일

Firebase/Supabase · 배포
  • 팀 프로젝트 이슈 트래커
  • 실시간 투표/랭킹 앱
  • 강사용 수업 자료 빌더
  • 예약/문의 CRM
  • 3D 미니 게임 + 리더보드
PART 06 · 실습 프로젝트

작은 문제를 풀어
서비스 MVP로.

포트폴리오는 예쁘지만 문제 해결 연습이 약합니다. 오늘은 강사·학생이 바로 쓸 수 있는 수업자료 퀴즈 생성 서비스를 만들며 기획 → 구현 → 검증 루프를 익힙니다.

PROJECT · 본 수업의 결과물

목표 — "수업자료 퀴즈 생성 서비스".

긴 강의안이나 회의록을 붙여넣으면 핵심 요약, 객관식 퀴즈, 체크리스트를 만들어 저장하는 작은 서비스입니다. 백엔드 없이 시작하고, 나중에 Supabase로 업그레이드합니다.

문제 · 반복 노동
자료 정리 시간이 너무 김
강의자료를 요약하고 퀴즈로 바꾸는 일을 매번 손으로 합니다. 결과 기준도 사람마다 달라집니다.
MVP · 45분
입력 → 생성 → 저장 → 복사
텍스트 입력, 요약/퀴즈 생성, localStorage 저장, 검색, Markdown 복사까지 구현합니다.
난이도 · 입문+
백엔드 없이 시작
처음엔 HTML/CSS/JS와 브라우저 저장소만 사용. DB는 뒤에서 Supabase로 붙입니다.
WORKFLOW · 5 steps

서비스 제작 흐름 — 5단계.

STEP 01
문제 정의
누가, 어떤 자료 정리에 시간을 쓰는지 정의. 성공 기준은 "3분 안에 퀴즈 5개".
STEP 02
IA / UJ
입력 화면, 결과 화면, 저장 목록. Critical UJ는 붙여넣기 → 생성 → 저장 → 복사.
STEP 03
Plan 승인
Antigravity Plan mode에서 Task List와 Implementation Plan을 보고 범위 조정.
STEP 04
구현 + 검증
빈 입력, 짧은 입력, 저장/삭제, 모바일 화면까지 브라우저에서 직접 확인.
STEP 05
GitHub 저장
commit → push → README 정리. 다음 단계에서 Supabase DB로 업그레이드.
UI MOCKUP · Manager View · 첫 프롬프트

서비스는 문제·사용자·검증까지 적습니다.

Antigravity · lesson-kit-builder
Gemini 3 Pro · High
Start a new conversation
수업자료 퀴즈 생성 서비스 MVP를 만들어줘. 문제: 강사/학생이 긴 자료를 요약하고 퀴즈로 바꾸는 시간이 오래 걸림. 사용자: 수업자료를 빠르게 복습 자료로 바꾸고 싶은 입문자. Critical UJ: 텍스트 붙여넣기 → 생성 → 결과 확인 → 저장 → Markdown 복사. 기능: - 자료 입력 textarea, 예시 자료 불러오기 - 요약 5줄, 객관식 퀴즈 5개, 실행 체크리스트 생성 - 처음엔 AI API 없이 간단한 규칙 기반으로 동작 - localStorage에 결과 저장, 검색, 삭제 - 빈 입력/짧은 입력/모바일 390px 검증 기술: HTML/CSS/JS만. index.html, style.css, app.js로 분리. 먼저 Plan과 테스트 방법을 보여주고, 내가 승인하면 구현해줘.
@ files / workflow 🌐 Browser Plan ▾
💡 왜 이 프롬프트가 좋은가: ① 문제와 사용자가 있음 ② Critical UJ가 1개로 좁혀짐 ③ 저장·검색·edge case가 있음 ④ "먼저 Plan"으로 검토 단계를 강제.
UI MOCKUP · Result Preview

결과물은 작지만 실제 서비스처럼 보입니다.

Lesson Kit Builder
수업자료 → 요약 · 퀴즈 · 체크리스트
localStorage No Backend
INPUT
오늘 수업은 데이터베이스와 스토리지입니다. 데이터베이스는 표로 정보를 저장하고, 스토리지는 이미지와 파일을 저장합니다...
요약 5줄
DB는 표, 스토리지는 파일 저장소. Supabase는 DB·Auth·Storage를 한 번에 제공.
퀴즈 5개
Q1. row와 column의 차이는? Q2. primary key는 왜 필요할까?
체크리스트
□ 테이블 만들기 □ RLS 켜기 □ 저장 버튼 테스트 □ 모바일 확인
저장 목록
DB 입문 · GitHub 개념 · Antigravity Plan mode · Supabase 실습
검색: DB 저장 4개 Markdown 복사 완료 Critical UJ 통과
PROMPT QUALITY · 서비스형 요청

서비스 프롬프트는 예쁜 화면보다 흐름이 먼저입니다.

나쁜 프롬프트
"수업자료 정리 앱 만들어줘"
수업자료 정리 앱 만들어줘. 보기 좋게.
  • 누가 쓰는지 없음
  • 입력·저장 기준 없음
  • 검증할 성공 기준 없음
좋은 프롬프트
문제 · 사용자 · Critical UJ · 검증
  • 문제/사용자: 강사·학생의 자료 정리 시간
  • Critical UJ: 붙여넣기 → 생성 → 저장 → 복사
  • 기술/저장: HTML/CSS/JS, localStorage
  • 검증: 빈 입력, 짧은 입력, 모바일 390px
FAILS · 자주 하는 3가지 실수

초보자가 자주 하는 — 3가지 실수.

남의 시행착오로 — 본인은 같은 함정을 피하세요. "실패담을 미리 듣는 게 가장 빠른 학습".

🪨 너무 짧은 프롬프트
"수업자료 정리 앱 만들어줘"
결과: 입력, 저장, 검증 기준이 없는 빈 화면이 나옵니다. 서비스가 아니라 장식 페이지가 됩니다.

해결: 문제, 사용자, Critical UJ, 저장 방식, edge case를 명시하세요.
⚠️ Agent-driven 모드 + 큰 작업
"기존 폴더 깔끔하게 정리해줘"
결과: 자율 모드 + 모호한 명령 = 실수로 파일 삭제. 휴지통에서 복구하느라 1시간.

해결: 처음에는 무조건 Review-driven. 큰 작업은 명령을 잘게 쪼개세요.
🔓 Browser Subagent + 본인 계정
"내 SNS 자동 댓글 봇 만들어줘"
결과: 비번이 입력되는 모습이 녹화본에 그대로 저장됨. 외부 공유시 노출 위험.

해결: 테스트 계정·더미 데이터로만 시연. 본인 계정 작업은 비번 입력 직전에 Pause.
30 USES · Antigravity로 풀 일상 작업

Antigravity로 — 30가지 일을 풀 수 있습니다.

📚 학습 · 실험 (8개)
01새 라이브러리 사용법 묻기 ("Chart.js로 막대그래프 만드는 법")
02알고리즘 설명 + 시각화 ("이진 탐색 시각화 페이지 만들어줘")
03코드 리뷰 받기 ("이 함수에서 개선할 점 알려줘")
04버그 디버깅 ("이 에러 원인 찾아줘")
05옛 jQuery 코드 → 모던 JS 변환
06API 문서 읽고 요약 (Browser Subagent)
07새 언어 배우기 (Python·Rust·Go 첫 프로젝트)
08코딩 인터뷰 문제 풀이 + 풀이법 설명
🚀 토이 프로젝트 (8개)
09개인 블로그 (마크다운 포스트 + 다크모드)
10가계부 앱 (CSV 업로드 → 자동 분류)
11Pomodoro 타이머 + 통계
12북마크 정리 도구
13QR 코드 생성기
14이미지 압축·리사이즈 도구
15색상 팔레트 추출기
16날씨 대시보드 (OpenWeather API)
⚙️ 자동화 (7개)
17매일 환율 데이터 → CSV 저장 스크립트
18이메일 자동 분류 (Gmail API)
19SNS 정기 포스팅 자동화
20스크래핑 → Notion DB 자동 업데이트
21이미지 폴더 정리 (날짜별 자동 분류)
22PDF에서 표 추출 → Excel
23유튜브 자막 → 요약 글
🎓 학교 · 과제 (7개)
24발표 슬라이드 (HTML로 직접 — 이 슬라이드처럼)
25설문 결과 시각화
26리포트용 인포그래픽
27실험 데이터 그래프 자동화
28플래시카드 학습 앱 (스페이스드 리피티션)
29그룹 프로젝트 진행률 트래커
30졸업작품 데모 사이트 (60분 만에)
PART 07 · GITHUB · DATABASE · SUPABASE · RULES

안전하게,
계속 자라나기.

마지막 파트. GitHub로 되돌릴 수 있는 작업 습관을 만들고, 데이터베이스와 Supabase로 저장 기능을 확장합니다. Rules·Skills·Harness Engineering으로 Antigravity가 반복 가능하고 검증 가능한 방식으로 일하게 만듭니다.

2026 UPDATE · 3월-5월 흐름

2026년 봄 업데이트의 핵심은 AI에게 일을 맡기되, 권한을 좁히는 것입니다.

초보자에게 중요한 건 버전 번호보다 의미입니다. AI 에이전트가 더 많은 일을 하게 되었고, 그래서 승인·브랜치·비밀키 보호가 더 중요해졌습니다.

ANTIGRAVITY · 2026.03-04
허락표와 작업 경계가 중요해짐
  • 통합 권한 시스템: 파일·터미널·브라우저 행동을 허락표로 관리
  • Linux sandboxing: AI가 작업할 수 있는 공간을 더 좁힘
  • MCP 인증·로딩 개선: 외부 도구 연결이 안정화
  • 초보자 의미: AI 직원에게 모든 열쇠를 주지 말고 방마다 허락하기
GITHUB · 2026.03-05
Issue와 PR이 AI 작업 카드가 됨
  • PR에서 @copilot에게 테스트 수정·리뷰 반영 요청 가능
  • Copilot App은 브랜치·파일·대화·작업 상태를 세션별로 분리
  • GitHub MCP secret scanning으로 commit 전 비밀키 검사 가능
  • 초보자 의미: GitHub는 저장소를 넘어 AI 작업 관리판이 됨
SUPABASE · 2026.04-05
DB도 안전 기본값이 강화됨
  • 새 public table의 Data API 자동 노출이 단계적으로 제한
  • Branching without Git: GitHub 연결 없이 DB 실험 가지 생성
  • Remote MCP는 OAuth, project scope, read-only 옵션을 제공
  • 초보자 의미: DB도 연습장 branch에서 먼저 실험하기
BEGINNER VIEW · 초딩도 이해하는 비유

Antigravity · GitHub · Supabase는 한 팀입니다.

세 도구를 쉬운 말로 바꾸면

Antigravity시키면 일하는 AI 알바생. 코드를 고치고 브라우저로 확인일꾼
GitHub모든 저장 순간이 남는 온라인 작업 일기장타임머신
Supabase로그인, DB, 파일창고를 빌려주는 온라인 백엔드창고+문지기
Branch원본 공책을 더럽히지 않는 연습장 복사본연습장
MCPAI가 외부 도구에 말을 걸 수 있게 해주는 전화선연결선
RLSDB에서 남의 일기장을 못 보게 막는 문지기 규칙보안문

그래서 작업 순서가 이렇게 됩니다

  • Gemini나 Claude로 문제와 사용자를 정리합니다
  • Antigravity Plan mode로 작업 계획을 먼저 받습니다
  • GitHub branch에서 구현하고 commit으로 저장합니다
  • Supabase는 branch 또는 테스트 프로젝트에서 DB를 연습합니다
  • PR에서 변경 내용, 테스트, 남은 위험을 사람에게 보여줍니다
  • 완료 기준을 통과한 뒤에만 main 또는 실제 DB에 반영합니다
PRACTICE · AI에게 열쇠를 주기 전 점검

첫 프로젝트 전에는 권한 체크리스트부터 끝냅니다.

이 실습은 코드보다 먼저 합니다. 안전 설정을 해두면 Antigravity가 빨리 움직여도 사람이 멈출 수 있습니다.

Plan 먼저큰 작업은 바로 수정 금지. Task List와 Implementation Plan을 먼저 검토Plan mode
Workspace 한정AI가 이 프로젝트 폴더 밖의 파일을 만지지 못하게 제한workspace
터미널 승인설치, 삭제, 배포, DB 변경 명령은 사람이 보고 승인Ask
MCP 최소 권한GitHub·Supabase 연결은 필요한 repo/project만 허용scope
읽기 전용 시작처음 연결할 때는 read-only로 구조만 확인하고 쓰기는 나중에read_only
비밀키 금지service role key, 결제 키, AI API 키를 브라우저 코드에 넣지 않기.env
Secret scancommit 전에 GitHub MCP나 GitHub Secret Protection으로 키 노출 검사scan
Branch 실험main과 production DB를 직접 건드리지 않고 연습용 가지에서 작업branch
캡처 증거브라우저 화면, 콘솔 에러 0개, 저장/조회 결과를 PR에 남김artifact
중단 규칙삭제·대량 변경·요금 발생 작업은 무조건 멈추고 질문하게 하기deny
PRACTICE · Issue → Branch → PR

GitHub는 AI 작업을 되돌릴 수 있게 만드는 장치입니다.

실습: 수업자료 서비스에 저장 기능 추가

  1. GitHub에서 lesson-kit-builder repository를 직접 만듭니다
  2. Issue 작성: "생성한 수업자료를 저장하고 다시 불러오기"
  3. Antigravity에게 feat/saved-kits branch에서 작업하라고 지시
  4. 구현 후 git status → add → commit → push
  5. PR 본문에 변경 요약, 테스트 결과, 캡처, 남은 위험을 적습니다
  6. 리뷰 코멘트가 있으면 Antigravity에게 코멘트별로 반영하게 합니다

Antigravity 지시문

GitHub Issue #1을 기준으로 작업해줘. 규칙: - main에서 직접 작업하지 말고 feat/saved-kits 브랜치에서만 작업한다. - 먼저 Plan mode로 변경 파일 목록과 테스트 방법을 제안한다. - localStorage 저장/조회 기능을 추가한다. - 브라우저에서 생성 → 저장 → 새로고침 → 다시 조회 Critical UJ를 검증한다. - 완료 후 git status를 보여주고 commit message를 제안한다. - PR 본문 초안을 한국어로 작성한다. PR 본문에는 반드시 포함: 1. 무엇을 바꿨는지 2. 어떤 명령/브라우저 테스트를 했는지 3. 스크린샷 또는 녹화 artifact 위치 4. 아직 Supabase가 붙지 않은 한계
PRACTICE · DB도 연습장에서 먼저

Supabase는 Branch + RLS + MCP로 안전하게 붙입니다.

실습 순서

  • 새 Supabase 프로젝트 또는 개발 branch를 만듭니다
  • 처음 MCP 연결은 project_ref로 프로젝트를 좁히고 read_only=true로 시작합니다
  • lesson_kits, quiz_questions table SQL을 Plan으로 검토합니다
  • RLS를 켜고 "내 user_id row만 보기/쓰기" policy를 만듭니다
  • 샘플 row 2개로 저장·조회·삭제를 테스트합니다
  • 문제가 없을 때만 branch를 merge하거나 실제 프로젝트에 SQL을 적용합니다

Supabase MCP 요청 예시

@Supabase 현재 프로젝트의 table 목록과 RLS 상태를 읽어줘. 처음에는 절대 schema를 변경하지 말고 read-only로 확인만 해줘. 그다음 아래 앱을 위한 SQL 계획을 제안해줘. - 앱: Lesson Kit Builder - 사용자마다 자기 자료만 저장/조회 - table: profiles, lesson_kits, quiz_questions - RLS: authenticated 사용자는 자기 user_id row만 접근 - service role key는 브라우저 코드에 금지 출력: 1. table 설계 2. RLS policy 초안 3. 테스트용 sample data 4. 위험한 작업 목록 5. 내가 승인해야 실행할 SQL
GITHUB 101 · 개발자들의 작업 기록장

GitHub는 코드용 Google Drive + 타임머신입니다.

초보자는 먼저 단어를 쉬운 비유로 잡으면 됩니다. Antigravity가 코드를 바꿔도 GitHub가 있으면 이전 상태로 돌아갈 수 있습니다.

RepositoryGitHub에서 직접 만드는 온라인 프로젝트 폴더. 예: 수업자료 서비스 코드를 담는 상자lesson-kit-builder
Branchmain 원본을 망치지 않는 작업용 복사본. 새 기능은 여기서 실험feat/quiz-generator
Commit작업 중간 저장. 게임 저장 슬롯처럼 "여기까지 완료"를 기록git commit -m "feat: add home"
Push내 컴퓨터 저장 기록을 GitHub 온라인 저장소로 업로드git push
Pull Request작업 브랜치를 main에 합쳐도 되는지 확인 요청PR
CloneGitHub 저장소를 내 컴퓨터로 내려받기. 처음 시작할 때 사용git clone URL
PullGitHub의 최신 변경을 내 컴퓨터에 반영git pull
Issue해야 할 일 카드. "모바일에서 버튼 깨짐" 같은 버그 기록#12
GitHub MCPAntigravity가 GitHub의 repo, issue, PR을 읽고 만들게 연결하는 통로@GitHub
ActionsPush나 PR 때 테스트와 배포를 자동 실행하는 로봇CI
GITHUB WORKFLOW · 되돌릴 수 있게 만들기

Repository 만들기 → Branch → Commit → Push.

1. GitHub에서 Repository 직접 만들기

  1. github.com 로그인 → 우상단 +New repository
  2. 이름 입력: lesson-kit-builder
  3. 초보자는 Public, 비공개 연습은 Private
  4. 로컬에 이미 파일이 있으면 README 체크 해제. 완전 새로 시작이면 README 체크 가능
  5. Create repository 클릭 → GitHub가 원격 저장소 URL을 보여줌

2. Branch는 안전한 작업 복사본

main은 제출용 원본 노트, branch는 연습장입니다. Antigravity가 실수해도 main을 바로 망치지 않게 새 가지에서 작업합니다.

git checkout -b feat/quiz-generator # 뜻: # feat = 새 기능 # quiz-generator = 퀴즈 생성 기능 작업

3. Commit / Push 예시

Commit은 내 컴퓨터에 저장, Push는 GitHub에 업로드입니다.

git status git add . git commit -m "feat: add lesson quiz generator" git push -u origin feat/quiz-generator

4. GitHub MCP는 언제 쓰나

  • @GitHub repo 만들어줘: 저장소/이슈/PR 생성 요청
  • @GitHub open issues 요약해줘: 할 일 목록 확인
  • @GitHub PR 본문 작성해줘: 변경 요약과 테스트 결과 정리
  • 코드 파일 자체 저장은 보통 git commit / git push로 처리
NO BACKEND PROJECT · GitHub 개념 체험 앱

백엔드 없이 나만의 GitHub를 만들어봅니다.

진짜 Git 저장소를 구현하는 게 아닙니다. Repository, Branch, Commit, Issue 개념을 몸으로 익히는 미니 서비스를 만듭니다.

MVP 기능

  • Repository 만들기: 이름, 설명, 공개/비공개
  • Branch 만들기: main에서 새 작업 가지 생성
  • Commit 남기기: 메시지, 변경 파일, 시간 기록
  • Issue 보드: Todo / Doing / Done 상태 이동
  • localStorage 저장: 새로고침해도 데이터 유지

왜 백엔드 없이 시작하나

  • 처음엔 개념 학습이 목표라 서버가 필요 없습니다
  • 브라우저 저장소만으로 CRUD 흐름을 이해할 수 있습니다
  • 나중에 데이터가 여러 기기에서 필요해지면 DB를 붙입니다
  • 이 업그레이드 지점이 바로 Supabase 실습입니다
PROMPT · GitHub 개념 앱 만들기

이 프롬프트로 GitHub 개념을 앱으로 익힙니다.

Antigravity 실행 프롬프트

백엔드 없이 GitHub 개념을 연습하는 미니 서비스를 만들어줘. 목표: - 초보자가 repository, branch, commit, issue를 화면에서 직접 만들어보며 이해한다. - 실제 Git 명령을 실행하지 않고, 개념을 localStorage 데이터로 시뮬레이션한다. 기능: 1. Repository 생성/선택/삭제 2. Branch 생성: main에서 feat/... 브랜치 만들기 3. Commit 작성: 메시지, 변경 파일명, 설명, 시간 저장 4. Issue 작성: Todo/Doing/Done 보드에서 이동 5. Repository별 commit timeline과 issue 목록 표시 6. 빈 입력, 중복 이름, 삭제 확인 처리 기술: - HTML/CSS/JS만 사용 - index.html, style.css, app.js 분리 - 먼저 Plan과 데이터 구조를 보여주고 승인 후 구현 - 브라우저에서 Critical UJ를 직접 검증

데이터 구조 예시

Repository - id - name - description - visibility - createdAt Branch - id - repoId - name - baseBranch Commit - id - repoId - branchId - message - changedFiles[] - createdAt Issue - id - repoId - title - status
DATABASE 101 · 파일에서 DB로

DB는 엑셀 파일이 너무 많아져서 나온 해결책입니다.

처음엔 파일로도 됩니다. 하지만 사람이 많아지고 데이터가 커지면 파일 방식은 금방 한계가 옵니다.

문제 01 · 중복
같은 정보가 여러 파일에 있음
고객 주소가 고객 파일에도, 주문 파일에도 있으면 한 곳만 고쳤을 때 데이터가 엇갈립니다.
문제 02 · 검색
전체 파일을 뒤져야 함
"Daniel이 만든 퀴즈만 보여줘" 같은 요청을 매번 파일 전체 검색으로 처리하면 느립니다.
문제 03 · 동시 수정
두 명이 동시에 저장하면 꼬임
A가 고친 파일을 B가 옛 버전으로 덮어쓰면 작업이 날아갑니다. DB는 이런 충돌을 관리합니다.

그래서 DB는 데이터를 표로 나누고, 연결하고, 빠르게 찾고, 안전하게 저장하는 시스템입니다.

DATABASE WORDS · 초보자 단어장

DB 단어는 엑셀 비유로 잡으면 됩니다.

Table엑셀 시트 하나. 예: 저장된 수업자료 목록lesson_kits
Row가로 한 줄. 저장된 자료 1개id=1
Column세로 항목. 제목, 내용, 생성일 같은 속성title
Primary Key각 row의 주민등록번호 같은 고유 IDid uuid
Foreign Key다른 table의 row를 가리키는 연결고리kit_id
SQLDB에게 묻는 문장. "이 조건의 자료를 보여줘"select *
Join두 table을 연결해 한 번에 보는 것users + kits
Index책 맨 뒤 찾아보기. 검색을 빠르게 함created_at
정규화중복을 줄이기 위해 table을 잘 나누는 설계users / kits
ACID돈, 주문, 저장처럼 꼬이면 안 되는 작업을 안전하게 처리하는 원칙transaction
DATABASE VS STORAGE · 어디에 무엇을 저장하나

DB는 정보 표, Storage는 큰 파일 창고입니다.

Database
작고 검색 가능한 정보
  • 사용자 ID, 제목, 설명, 상태, 생성일
  • 파일의 URL과 소유자 정보
  • 누가 볼 수 있는지 권한 규칙
  • SQL로 검색, 정렬, 조인
+
Storage
이미지·영상·문서 같은 큰 파일
  • Bucket: 파일을 담는 큰 창고
  • Object: 사진 1장, PDF 1개 같은 파일
  • Key: 파일 이름 또는 경로
  • CDN: 가까운 곳에서 빠르게 전달

예: 프로필 사진 파일은 Storage에 저장하고, 그 사진 URL과 소유자 ID는 DB에 저장합니다.

SUPABASE 101 · 백엔드 기능 묶음

Supabase는 백엔드 초보자용 올인원 키트입니다.

Firebase처럼 편하게 시작하되, PostgreSQL이라는 강력한 SQL 데이터베이스를 그대로 씁니다.

DatabasePostgreSQL 기반. table, SQL, join, index를 제대로 사용Postgres
Auth이메일 로그인, 소셜 로그인, 사용자 세션 관리auth.users
Storage이미지, 영상, PDF를 bucket/object로 저장buckets
Auto APItable을 만들면 데이터를 넣고 빼는 API가 자동으로 생김REST
RealtimeDB가 바뀌면 연결된 화면에 즉시 반영WebSocket
RLS브라우저에서 DB에 접근할 때 row 단위 권한을 막아주는 핵심 보안policy
Edge Functions비밀키가 필요한 작업, 결제 웹훅, AI API 호출을 서버리스 함수로 처리Deno
Dashboard초보자도 table, auth, storage, SQL을 화면에서 설정GUI
CLI / MCPAntigravity가 스키마 확인, 마이그레이션, 로그 점검을 돕게 연결@Supabase
Open Source코드가 공개되어 있고 Postgres 생태계를 활용OSS
SUPABASE UPGRADE · localStorage에서 DB로

수업자료 서비스를 Supabase 버전으로 키웁니다.

Table 설계

profiles - id uuid references auth.users - display_name text lesson_kits - id uuid primary key - user_id uuid references auth.users - title text - source_text text - summary text - checklist jsonb - created_at timestamptz quiz_questions - id uuid primary key - kit_id uuid references lesson_kits - question text - choices jsonb - answer_index int

초보자 보안 규칙

  • Supabase URL과 anon key는 브라우저에 있어도 됩니다
  • 단, public table에는 반드시 RLS를 켭니다
  • 사용자는 자기 user_id row만 읽고 쓰게 합니다
  • service role key는 절대 프론트엔드에 넣지 않습니다
  • AI API 키는 Edge Function 같은 서버 쪽에 둡니다
PROMPT · DB 붙이기

DB 작업은 Plan mode + RLS 확인이 필수입니다.

Antigravity 업그레이드 프롬프트

현재 localStorage로 저장하는 Lesson Kit Builder를 Supabase 버전으로 업그레이드해줘. 먼저 코드 수정하지 말고 Plan부터 작성해줘. 요구사항: 1. Supabase 클라이언트 설정 파일을 분리한다. 2. lesson_kits, quiz_questions table SQL을 제안한다. 3. RLS를 켜고 "본인 데이터만 읽기/쓰기" policy를 작성한다. 4. 기존 localStorage 저장/읽기 함수를 Supabase CRUD로 교체한다. 5. 로그인 전에는 데모 모드, 로그인 후에는 클라우드 저장 모드로 동작한다. 6. service role key는 절대 브라우저 코드에 넣지 않는다. 7. 브라우저에서 생성 → 저장 → 새로고침 → 다시 조회 Critical UJ를 검증한다.

승인 전 체크

  • table 이름이 명확한가
  • user_id가 모든 개인 데이터에 있는가
  • RLS policy가 select/insert/update/delete별로 있는가
  • anon key와 service role key를 구분했는가
  • 빈 상태, 로딩, 에러 메시지가 화면에 있는가
  • 삭제 작업 전에 확인 단계가 있는가
RULES · 매번 반복할 지시를 파일로 저장

Rule.md는 에이전트의 작업 규칙입니다.

Antigravity 공식 흐름에서는 전역 규칙은 ~/.gemini/GEMINI.md, 프로젝트 규칙은 .agents/rules/에 둡니다. 팀에서 RULE.md라고 부르더라도 핵심은 같습니다.

초보자용 프로젝트 Rule 예시

# beginner-project-rule - 항상 한국어로 설명한다. - 코드 수정 전 먼저 Plan을 제시하고 승인을 기다린다. - 초보자가 이해할 수 없는 전문 용어는 짧게 풀어쓴다. - 삭제, 이동, 대량 변경 전에는 반드시 이유와 영향 범위를 묻는다. - UI는 모바일 390px과 데스크톱 1440px에서 확인한다. - 완료 보고에는 변경 파일, 테스트 결과, 남은 리스크를 포함한다.

어디에 두나

  • 전역 규칙: ~/.gemini/GEMINI.md
  • 프로젝트 규칙: .agents/rules/code-style-guide.md
  • 워크플로우: .agents/workflows/generate-unit-tests.md
  • 팀에 공유하려면 .agents/ 폴더를 GitHub에 커밋
  • 규칙은 짧고 강하게. 너무 길면 에이전트가 놓칩니다
RULE QUALITY · 길수록 좋은가?

Rule.md는 길수록 좋은 게 아닙니다.

좋은 Rule은 "많은 말"이 아니라 반복 행동을 바꾸는 짧은 기준입니다. 너무 길면 매 작업마다 토큰을 잡아먹고, 중요한 규칙이 묻힙니다.

나쁜 Rule
장문 소설형 규칙
  • 배경 설명이 길고 행동 지시가 흐림
  • "잘", "예쁘게", "깔끔하게"처럼 판단 기준이 애매함
  • 프로젝트마다 달라지는 내용을 전역 Rule에 넣음
  • 매번 필요 없는 긴 체크리스트를 항상 읽게 함
좋은 Rule
짧고 검증 가능한 규칙
  • 한 줄에 행동 1개만 적음
  • "언제 / 무엇을 / 어떻게"가 보임
  • 항상 지킬 것만 Rule에 둠
  • 긴 절차는 Workflow나 Skill로 분리
RULE EXAMPLES · 바로 넣어도 되는 규칙

초보자에게 좋은 Rule은 안전·검증·설명입니다.

처음 프로젝트에 추천하는 Rules

# beginner-antigravity-rules ## Communication - 항상 한국어로 설명한다. - 초보자가 모를 수 있는 개발 용어는 처음 등장할 때 1문장으로 풀어쓴다. ## Planning - 코드 수정 전 Task List와 Implementation Plan을 먼저 제시한다. - 큰 작업은 화면/기능 단위로 쪼개고, 한 번에 2개 이상 큰 파일을 바꾸지 않는다. ## Safety - 삭제, 이동, 대량 포맷팅, 패키지 제거 전에는 반드시 승인을 요청한다. - 비밀번호, API 키, 토큰, 개인 파일은 읽거나 출력하지 않는다. ## Quality - 구현 후 Critical User Journey를 브라우저에서 직접 검증한다. - 완료 보고에는 변경 파일, 테스트 결과, 남은 리스크를 포함한다.

Rule에 넣지 말아야 할 것

  • 한 번만 필요한 작업 지시: 오늘 할 일은 채팅에 입력
  • 긴 PRD 전문: docs/prd.md로 두고 @file로 첨부
  • 긴 테스트 절차: Workflow 또는 Skill로 분리
  • 비밀값: API 키, 토큰, 계정 정보는 절대 Rule에 저장 금지
  • 취향만 있는 문장: "멋있게" 대신 "8px radius, 모바일 우선"처럼 구체화
CONCEPT · Refactoring

리팩토링은 기능은 그대로, 내부를 더 좋게 바꾸는 일입니다.

초보자는 리팩토링을 "다시 만들기"로 오해하기 쉽습니다. 정확히는 사용자가 보는 기능은 유지하면서 코드의 구조, 이름, 중복, 읽기 쉬움을 개선하는 작업입니다.

WHAT
무엇을 바꾸나
긴 함수를 작게 나누기, 중복 코드 합치기, 변수 이름 명확히 하기, 파일 구조 정리, 컴포넌트 분리.
NOT
무엇이 아닌가
새 기능 추가, 디자인 변경, API 바꾸기, DB 구조 변경은 리팩토링이 아니라 기능 변경 또는 구조 변경입니다.
WHY
왜 하나
다음 수정이 쉬워지고, 버그가 줄고, Antigravity가 프로젝트를 더 잘 읽습니다. AI도 읽기 좋은 코드에서 일을 잘합니다.
WHEN
언제 시키나
기능이 작동하는 걸 확인한 뒤. 먼저 테스트/브라우저 검증을 하고, 그 다음 리팩토링을 시킵니다.
PROMPT
Antigravity 지시 예시
"동작은 바꾸지 말고 중복만 줄여줘. 변경 전후 테스트 방법을 먼저 제시하고, Diff를 작게 유지해줘."
RULE
좋은 안전 규칙
"리팩토링 중에는 사용자에게 보이는 기능과 문구를 바꾸지 않는다. 변경 후 기존 Critical UJ를 다시 검증한다."
SKILLS · 필요할 때만 불러오는 전문 패키지

SKILL.md는 자주 쓰는 전문 작업을 패키지로 묶는 방법입니다.

Rules가 항상 켜지는 기본 규칙이라면, Skills는 요청이 맞을 때만 로드되는 전문 매뉴얼입니다. 긴 체크리스트, 템플릿, 스크립트는 Skill로 빼는 게 좋습니다.

폴더 구조

.agents/ └── skills/ └── prd-to-antigravity-prompt/ ├── SKILL.md ├── references/ │ └── prd-template.md └── assets/ └── user-flow-example.png

SKILL.md 최소 예시

--- name: prd-to-antigravity-prompt description: PRD를 읽고 Antigravity 실행 프롬프트로 변환한다. 문제 정의, 페르소나, IA, UJ, User Flow가 있을 때 사용한다. --- # PRD to Antigravity Prompt 1. PRD에서 MVP 범위와 제외 범위를 분리한다. 2. Critical UJ를 1개로 좁힌다. 3. 수용 기준을 Given/When/Then으로 바꾼다. 4. Antigravity가 먼저 Plan을 만들도록 실행 프롬프트를 작성한다. 5. 검증 항목에는 브라우저 테스트와 GitHub PR 초안을 포함한다.
HARNESS ENGINEERING · 프롬프트 다음 단계

하네스 엔지니어링은 AI가 일하는 환경을 설계하는 일입니다.

좋은 프롬프트 하나로 끝내는 시대가 아닙니다. 규칙, 컨텍스트, 권한, 테스트, 산출물, 리뷰 루프를 묶어야 에이전트가 프로젝트를 끝냅니다.

Rules 항상 지킬 원칙 Skills 필요할 때 로드 PRD 목표와 수용 기준 Antigravity Agent 계획 · 실행 · 검증 Editor · Terminal · Browser Artifacts Plan · Diff · Recording Tests UJ · 콘솔 · 반응형 GitHub Commit · PR · Review
WHY HARNESS MATTERS · 왜 중요한가

하네스가 없으면 AI는 답변을 하고,
하네스가 있으면 AI는 프로젝트를 끝냅니다.

프롬프트만 있는 작업
"앱 만들어줘"
  • 계획 없이 바로 파일을 바꿈
  • 테스트 없이 "완료"라고 말함
  • 권한·삭제·외부 접속 위험이 커짐
  • 다음 날 같은 품질이 반복되지 않음
하네스가 있는 작업
규칙 + 출력물 + 검증 루프
  • 각 단계의 파일 산출물이 남음
  • Critical UJ와 테스트가 완료 조건이 됨
  • Allow/Deny/Ask로 행동 범위를 통제
  • GitHub PR로 사람이 리뷰할 수 있음
HARNESS TEMPLATE · Antigravity에 적용하기

Antigravity용 하네스는 6단계 파일 산출물로 만듭니다.

하네스 실행 프롬프트 골격

너는 이 프로젝트의 실행 에이전트다. 각 단계는 반드시 파일 산출물을 남기고, 다음 단계는 이전 파일을 읽고 진행한다. 1. Research Agent: docs/01-research.md 2. Architect Agent: docs/02-ia-flow.md 3. Product Agent: docs/03-prd-policy.md 4. Engineer Agent: docs/04-implementation-plan.md 5. QA Agent: docs/05-test-plan.md 6. Reviewer Agent: docs/99-review.md 완료 기준: - README.md가 모든 문서를 링크한다. - Critical UJ가 브라우저에서 검증된다. - 콘솔 에러 0개, 모바일/데스크톱 캡처 포함. - Reviewer 피드백은 resolved / deferred로 표시한다. - GitHub PR 본문 초안을 작성한다.

초보자 체크포인트

  • 각 단계마다 "파일로 남겨"라고 말해야 합니다
  • 역할 전환 문장을 명시하면 결과가 덜 섞입니다
  • 완료 기준은 숫자와 파일명으로 적습니다
  • 실행 전에는 Review-driven, Terminal Request Review 권장
  • 큰 프로젝트는 하루 1개 하네스가 아니라 단계별 PR로 쪼갭니다
2026 SOURCES · 최신 업데이트 확인 링크

2026년 3-5월 업데이트는 이 자료 기준으로 반영했습니다.

Antigravity 항목은 Releasebot이 Google 원문 링크를 추적한 업데이트 자료 기준입니다. GitHub와 Supabase는 공식 changelog/docs 기준입니다.

AG UPDATE
Antigravity Updates by Google · Releasebot

2026-03-17 Linux sandboxing/MCP auth, 2026-03-30 unified permissions, 2026-04-07 MCP loading fix 반영.

GOOGLE
Google AI Studio · Vibe Code to production

Antigravity coding agent, React/Angular/Next.js, DB 연결, 실서비스 예시 흐름 참고.

GEMINI
Google Korea · Gemini 3.5 소개

2026-05-19 Gemini 3.5 Flash, Antigravity 제공, 장기 에이전트 작업, 3.5 Pro 출시 예정 반영.

GITHUB
Ask @copilot to make changes to a pull request

PR에서 AI에게 테스트 수정, 리뷰 반영, 추가 변경을 요청하는 최신 GitHub 작업 방식.

GITHUB
Secret scanning with GitHub MCP Server GA

MCP 호환 AI 코딩 도구에서 commit/PR 전 비밀키 노출을 검사하는 안전 흐름.

GITHUB
GitHub Copilot App technical preview

branch, files, conversation, task state를 세션별로 분리하고 PR review로 마무리하는 흐름.

SUPABASE
Supabase Changelog · Apr-May 2026

Data API 자동 노출 제한, Postgres 14/Node.js 20 지원 종료, May 2026 developer update 반영.

SUPABASE
Supabase MCP Server Docs

OAuth, project scope, read-only, feature groups, branching, production DB 연결 금지 권장사항 반영.

SUPABASE
Branching Without Git Is Now The Default

GitHub 연결 없이 dashboard와 MCP에서 Supabase branch를 만드는 최신 실습 흐름.

SOURCES · 유튜브와 공식 문서 참고 링크

이번 강의에 반영한 참고 자료.

영상은 강의 흐름과 실습 아이디어로 참고하고, 제품 기능과 보안·설정은 Google 공식 문서와 Codelab 기준으로 정리했습니다.

OFFICIAL
Google Developers Blog · Build with Antigravity

Agent-first 인터페이스, Editor/Manager, Artifacts, 브라우저 검증 개념.

CODELAB
Getting Started with Google Antigravity

설치, Agent Manager, Browser Subagent, Artifacts, Rules, Workflows, Skills, 보안 설정.

VIDEO
사용자 제공 Antigravity 영상

Antigravity 입문 흐름과 수업용 설명 보강 자료.

VIDEO
사용자 제공 개발 개념 영상

개발 기본 개념을 초보자 언어로 설명하는 파트에 반영.

VIDEO
GitHub 개념 영상

Repository, Commit, Push/Pull, PR, Branch, Fork/Clone, Issue 설명에 반영.

VIDEO
DB와 스토리지 영상

파일 관리의 한계, RDB/SQL/정규화/인덱스, 스토리지/CDN, Supabase 흐름에 반영.

SUPABASE
Supabase Docs · Tables and Data

table, row, column, primary key, foreign key, SQL 기반 table 설계 설명.

SUPABASE
Supabase Docs · Architecture

Postgres, Auth, Storage, Realtime, API 구성 요소 정리.

SECURITY
Supabase Docs · Row Level Security

브라우저에서 안전하게 DB를 쓰기 위한 RLS와 policy 설명.

VIDEO
하네스 엔지니어링 영상

Antigravity에 하네스를 적용하는 실습 관점으로 반영.

HARNESS
하네스 엔지니어링 개념 설명

테스트, 승인 조건, 샘플 입력으로 AI 산출물을 검증하는 접근.

HARNESS
Antigravity Harness Engineering

Research, Architect, Business, Engineer, Reviewer, Revision 단계형 하네스 아이디어.

SECURITY · 4 priorities

보안 설정 — 이 4가지만 챙기세요.

설치 직후 — Settings → Agent에서 한 번만 설정해두면 됩니다. 익숙해진 뒤 — 천천히 풀면 OK.

PRIORITY 01
📋 Artifact Review
  • Asks for Review 추천 (입문자)
  • 중요한 변경 = 사람이 한 번 보고 승인
  • 익숙해지면 Agent Decides로 변경
PRIORITY 02
⚡ Terminal Sandbox
  • 반드시 ON — 시스템 전체 접근 차단
  • 워크스페이스 안에서만 명령 실행
  • "rm -rf /" 같은 사고 방지
PRIORITY 03
📁 File Access
  • Workspace-only 추천
  • 다른 폴더(개인 사진·문서)는 접근 불가
  • 실수로 외부 파일 삭제 방지
PRIORITY 04
🟨 JS Execution
  • Request Review 추천
  • 임의 자바스크립트 실행 전 승인 필요
  • 외부 스크립트 자동 실행 차단
UI MOCKUP · Settings · Agent

⚙️ Settings — Agent 탭의 모습.

General
Editor
⚙️ Agent
Browser
Permissions
Models
Keyboard
Extensions
Agent Settings
Artifact Review 에이전트가 Artifact를 만들 때 — 사람의 검토가 필요한지
Asks for Review ▾
Terminal Execution 터미널 명령 실행 전에 승인을 받을지
Request Review ▾
Terminal Sandbox 워크스페이스 외부의 시스템 명령 차단 (강력 권장)
✓ Enabled
File Access 에이전트가 어느 범위의 파일에 접근할 수 있는지
Workspace-only ▾
JS Execution 임의 자바스크립트 실행 정책
Request Review ▾

💡 초록색 = 안전 활성화 / 오렌지 = 검토 모드. 다섯 줄 — 한 번만 설정.

UI MOCKUP · Permissions Tri-list

⚖️ Permissions — Allow / Deny / Ask 3분류.

에이전트가 할 수 있는 행동을 세부적으로 제어. "항상 OK" · "항상 금지" · "매번 물어봐" 3가지 리스트로.

✓ ALLOW · 항상 허용
read_file(./src)
read_file(./README.md)
command(npm install)
command(npm run dev)
command(git status)
browse(localhost:*)
안전하다고 확신한 행동만 추가하세요. 한번 추가하면 — 매번 묻지 않음.
✗ DENY · 항상 금지
command(rm)
command(sudo)
command(curl http*)
write_file(/etc/*)
browse(*.bank.com)
read_file(~/.ssh/*)
실수로 사고 나는 행동은 무조건 차단. 푸는 건 — 필요할 때만 일시적으로.
? ASK · 매번 확인
write_file(./*)
command(git push)
command(deploy*)
mcp(*)
browse(*.production)
delete_file(*)
중요한 행동은 — 매번 사람이 보고 승인. 기본값은 여기로, 익숙해지면 Allow로 옮기세요.
POWER USER · 3 layers

고급 — Rules · Workflows · Skills.

한 번 설정해두면 — 모든 작업에 자동 적용되는 3가지 레이어. 입문자는 Rules 1개만 알면 충분합니다.

LAYER 01
📜 Rules (규칙)
에이전트의 "기본 행동 지침". "한국어로 답해줘", "TypeScript 우선" 같은 규칙.
위치: .agents/rules/*.md (워크스페이스) ~/.gemini/GEMINI.md (전역)
LAYER 02
⚡ Workflows (워크플로)
/ 키로 호출하는 저장된 프롬프트. 자주 쓰는 명령을 단축어로.
예시: /generate-unit-tests /refactor-to-typescript /write-readme
LAYER 03
🛠️ Skills (스킬)
전문 도메인의 실행 가능한 패키지. SKILL.md + scripts + assets.
구조: .agents/skills/my-skill/ ├ SKILL.md ├ scripts/ └ references/

💡 처음에는 — Rules만: .agents/rules/beginner.md 파일을 만들고 → "항상 한국어로 답해줘. 수정 전 Plan을 보여줘." 한 줄만 적어도 효과 큼.

MCP · 외부 서비스를 에이전트에 연결

MCP 서버 — 한 줄로 외부 서비스 연결.

MCP(Model Context Protocol) = 에이전트가 외부 도구·DB에 접근하는 표준. 설치 후 채팅창에서 @서버이름으로 호출.

⚡ Supabase
npx @modelcontextprotocol/server-postgres [connection-string]
🔥 Firebase
npx firebase-tools@latest mcp --only firestore,auth,storage
🎭 Playwright
npx @playwright/mcp@latest
📁 Filesystem
npx @modelcontextprotocol/server-filesystem [path]
🐙 GitHub
npx @modelcontextprotocol/server-github
🔄 n8n
npx n8n-mcp

💡 설치 → Mac: Cmd + , / Win: Ctrl + ,MCP Servers 탭에서 활성화 → 채팅창 @Supabase 사용자 테이블 보여줘로 사용. 1,500+ 서버가 antigravity.codes에 있음.

HIDDEN GEMS · 입문자가 놓치기 쉬운 6가지

아는 사람만 쓰는 — 숨겨진 6가지 꿀팁.

⌨️ Tab to Import
코드에서 useState처럼 누락된 의존성 쓰면 자동으로 import 추가 제안 — Tab 한 번이면 끝.
⏭ Tab to Jump
에이전트가 코드를 만들고 나면 Tab으로 다음 논리적 위치로 커서 점프. 한 번에 여러 줄 수정도 빠르게.
🩹 Explain and Fix
에러 줄에 마우스 호버 → "Explain and fix" 버튼 → 클릭 한 번으로 설명 + 수정까지.
📤 Send all to Agent
Problems 패널에서 우클릭 → "Send all to Agent" → 모든 에러를 한 번에 일괄 수정 요청.
📟 Terminal → Agent
터미널 출력 선택 → Mac: Cmd + L / Win: Ctrl + L → 그 출력을 컨텍스트로 채팅 시작. 에러 디버깅 최강 콤보.
🎨 테마 라이브 미리보기
Mac: Cmd+K → Cmd+T / Win: Ctrl+K → Ctrl+T → 화살표 키 누르면 즉시 미리보기. 마음에 들 때 Enter.
PITFALLS · 우리도 한 번씩 빠지는 함정

초보자가 빠지는 — 4가지 함정.

앞에서 하나씩 살펴봤지만 — 마지막으로 한 번 더. 이거만 피해도 90%는 무사합니다.

v1.20.5 Ctrl+I 가로채임
"Ctrl+I를 눌렀는데 에이전트가 아니라 자동완성이 떠요…"
사실: v1.20.5에서 'Trigger Suggest'가 Ctrl+I를 가로챔. 해결: Mac: Cmd + , / Win: Ctrl + , → Keybindings → Trigger Suggest를 다른 키로 옮기거나 Mac: Cmd + Shift + I / Win: Ctrl + Shift + I 사용.
Browser Agent 30초 타임아웃
"느린 사이트 열고 있는데 자꾸 끊겨요…"
사실: 기본 타임아웃은 30초. 큰 SPA는 부족할 수 있음. 해결: Settings → Browser → timeout을 60~90초로. 이제 jQuery·React 감지가 정확해서 늘리는 게 안전.
Agent-driven 모드의 위험
"신나서 'Agent-driven' 골랐다가 파일이 사라졌어요…"
사실: Agent-driven은 사용자 동의 없이 액션 가능. 해결: 입문자는 무조건 Review-driven (Recommended). 익숙해진 후 단계별로 권한 늘리세요. command(rm)은 Deny에 추가.
@workspace 남발 → 느림 + 비용
"매번 @workspace 붙였는데 응답이 너무 느려요…"
사실: 큰 프로젝트에 @workspace는 토큰 폭탄. 해결: @file·@selection으로 좁게. 광범위 검색은 @codebase가 더 영리해요.
MINI QUIZ · 오늘 배운 것 점검

5문항 퀴즈 — 몇 점?

정답보다 이유가 중요합니다. 선택지를 눌러 — 풀이를 확인하세요.

Q1. Antigravity는 어떤 IDE를 기반(fork)으로 만들어졌을까요?
정답 B. Antigravity는 VS Code를 fork해서 만들었습니다. 그래서 VS Code 단축키·확장이 거의 그대로 동작합니다. Cursor도 같은 계열이라 둘 다 익숙해지기 쉬워요.
Q2. Manager View와 Editor View를 전환하는 단축키는?
정답 C. Mac: Cmd + E / Windows: Ctrl + E가 Manager ↔ Editor 토글입니다. D의 Cmd/Ctrl + LAgent Side Panel 토글 — 헷갈리기 쉬우니 둘 다 외워두세요.
Q3. Antigravity의 5종 Artifacts에 포함되지 않는 것은?
정답 D. 5종은 Task List · Implementation Plan · Walkthrough · Code Diffs · Browser Recordings. Performance Profile은 별도 도구의 영역이라 — 현재 Antigravity Artifact에는 없습니다.
Q4. 입문자에게 가장 추천되는 자율성(Autonomy) 모드는?
정답 B. Review-driven은 균형 잡힌 모드 — 중요한 행동만 사람이 승인하고 나머지는 자율. Secure는 너무 느려서 학습 흐름이 끊기고, Agent-driven은 입문자에게는 실수 위험이 큼.
Q5. Browser Subagent가 동작 중일 때 Chrome 창에 보이는 시각 신호는?
정답 C. "Agent Control" 라벨 + 굵은 빨간 테두리 + 빨간 점(AI 커서) + REC 표시. 사용자가 — "지금 AI가 조작 중"이라는 걸 즉시 알 수 있도록 4가지 시각 신호를 한 번에 줍니다.
0
/ 5 문제 정답
— 등급
CALCULATOR · Antigravity가 절약할 시간

Antigravity로 — 1년에 몇 시간이 생길까?

아래 5가지 작업에 하루 몇 분 쓰는지 슬라이더를 움직여보세요. 연간 절약 시간이 자동 계산됩니다.

💻 코드 작성·디버깅Antigravity 도입 시 절반 단축
90 분/일
📝 문서·README 작성60% 단축 (초안→편집으로 전환)
40 분/일
🔍 라이브러리 리서치70% 단축 (Browser Subagent)
40 분/일
🗒️ 회의·코드 리뷰80% 단축 (Diff·Walkthrough 자동)
30 분/일
🚀 사이드 프로젝트55% 단축 (Plan·자동 빌드)
45 분/일
0h
주간 절약 시간
→ 연간 0시간
≈ 커피 브레이크 0
≈ 영화 0 볼 시간

단, 이 시간을 "유튜브 보기"에 쓰면 의미 없음. "더 큰 사이드 프로젝트"에 투자할 때 복리.

NEXT · 수업이 끝난 뒤

오늘은 시작점. 진짜 학습은 이 다음.

DAY 1 ~ 7 · 익히기
매일 1개 만들기
10대 킷에서 1개씩 — 1주일에 7개. 손이 익숙해지는 게 가장 중요.
DAY 8 ~ 30 · 본인 것
진짜 본인 프로젝트
"오래전부터 만들고 싶었던 것" 1개 — 30일 안에 공개까지. 완성도 50%면 OK.
DAY 31+ · 공유
SNS·블로그에 정리
"내가 만든 거 + 어떻게 만들었는지". 공유 1번이 강의 100개를 이깁니다.
"어제의 도구는 코드를 빨리 쓰게 했다면,
내일의 도구는 코드를 지휘하게 합니다.
오늘 — 당신은 그 첫 화면을 켰습니다."
— OZ코딩스쿨 AI리더캠프 6기 · Intro to Google Antigravity
01 / -- · 오프닝
이동 · F 전체화면 · Esc 종료