06.13 대구 영재연수 4차시: Antigravity 2.0 세팅
에이전트 프레임워크 초기화 및 Git 기초
이 원고는 강경욱 선생님이 연수에서 쓴 자료입니다. 수업·연수에 참고하실 때 출처(강쌤의교실)를 남겨 주세요.
📘 4차시: 개발자의 길 (Antigravity 2.0 세팅과 Git 딥다이브)
1. 해커톤 미션: 1-1 원칙의 중요성
오후 세션은 실전 미니 해커톤입니다. 해커톤(Hackathon)이란 해킹(Hacking)과 마라톤(Marathon)의 합성어로, 정해진 시간 내에 무언가를 뚝딱 만들어내는 대회를 말합니다.
🚨 [경고] 제발 원대한 꿈을 버리십시오. 과거 광주 연수에서 “영재 선발, 출결, 과제 채점, 학부모 알림장 발송을 모두 해주는 올인원 통합 관제 시스템 봇”을 기획하신 선생님이 계셨습니다. 이 분은 6시간 내내 에러 창만 보다가 우울하게 귀가하셨습니다.
우리의 목표는 단 하나입니다. [1-1 원칙: 1개의 고충을 해결하는 1개의 기능]
- 성공적인 기획 예시: “초등 과학 영재들의 엉뚱한 호기심 질문에 정답 대신 꼬리 질문 3개만 던져주는 봇”, “학부모에게 보낼 딱딱한 공문 텍스트를 부드럽고 다정한 안내장 문구로 바꿔주는 번역기 봇”
2. Antigravity 2.0: 에이전트를 창조하는 프레임워크
제미나이 캔버스는 가벼운 웹페이지를 만들어주지만, ‘내 컴퓨터에 있는 파일을 읽어라’, ‘인터넷을 검색해서 최신 뉴스를 가져와라’ 같은 행동(Action)은 하지 못합니다.
구글의 **Antigravity(안티그래비티)**는 이런 한계를 돌파하기 위해 만들어진 프레임워크입니다. 이를 통해 우리는 뇌(프롬프트)와 손발(도구-Tools)을 모두 갖춘 진짜 ’에이전트(Agent, 주체성을 가진 AI)’를 창조하게 됩니다.
3. 터미널(Terminal)과의 첫 만남
마우스를 버리고 키보드로만 컴퓨터와 대화하는 공간입니다. 영화에서 해커들이 검은 화면에 녹색 글씨를 타다닥 치는 바로 그 화면입니다.
- Mac OS:
Command(⌘) + Space를 눌러 Spotlight 검색창을 띄우고터미널또는Terminal을 검색하여 실행합니다. - Windows:
Windows 키를 누르고 검색창에cmd를 입력하여명령 프롬프트를 실행합니다.
💻 3.1 필수 리눅스 명령어 기초
pwd(Print Working Directory): 내가 지금 내 컴퓨터 안의 어느 폴더(방)에 있는지 현재 위치를 알려줍니다.ls(List): 현재 폴더 안에 무슨 파일들이 있는지 목록을 보여줍니다. (Windows는dir을 씁니다.)cd 폴더이름(Change Directory): 특정 폴더 안으로 들어갑니다. (예:cd Desktop)cd ..: 현재 폴더에서 상위 폴더로 한 칸 빠져나옵니다.
4. Antigravity 프로젝트 초기화 완벽 가이드
단계 1: 프로젝트 폴더 준비
구글 클래스룸에 강사가 업로드해 둔 기본_템플릿.zip 파일을 다운로드하여 반드시 ’바탕화면(Desktop)’에 압축을 풉니다. (다운로드 폴더에 두면 경로 찾기가 복잡해집니다.)
단계 2: 터미널에서 폴더로 이동
터미널을 열고 바탕화면에 압축을 푼 폴더로 진입합니다.
# Mac 사용자
cd Desktop/기본_템플릿
# Windows 사용자
cd Desktop\기본_템플릿단계 3: 마법의 주문 agy create
이제 안티그래비티 프레임워크를 내 폴더에 다운로드하여 뼈대를 잡는 명령어입니다.
agy create my-agent이 명령어를 치면 수많은 영어 문장들이 촤르륵 올라가면서 패키지들이 설치됩니다. 여기서 my-agent는 선생님들이 만들 프로젝트의 영문 이름입니다. (예: agy create science-bot)
- [에러 대처법]
Command not found: agy라고 뜨는 경우: Node.js가 설치되지 않았거나 Antigravity CLI가 제대로 깔리지 않은 것입니다. 이 경우 당황하지 말고 제미나이에게 물어보거나(자연어 디버깅), 강사에게 도움을 요청합니다.
단계 4: 완성된 폴더 안으로 진입
뼈대가 생성되었으니 그 안으로 들어갑니다.
cd my-agent5. 시간을 지배하는 자, Git (깃) 기초
문서를 쓰다 날렸을 때를 대비해 우리는 중간저장을 하고, 수정할 때마다 최종.hwp, 진짜최종.hwp, 미치겠네진짜최종.hwp 같은 파일들을 무한정 만들어냅니다.
개발자들은 이런 원시적인 짓을 하지 않습니다. 대신 **Git(깃)**이라는 버전을 관리하는 타임머신을 사용합니다.
🌳 5.1 Branch Tree (나뭇가지 이론)
Git의 핵심은 ’브랜치(Branch, 나뭇가지)’입니다.
원본 코드가 기둥(main)입니다. 내가 새로운 실험을 하고 싶다면 기둥을 직접 건드리는 대신 옆으로 잔가지(feature/test)를 하나 뻗어서 거기서 코딩을 합니다.
성공하면 기둥에 합치고(Merge), 망치면 그 잔가지만 부러뜨려서 버리면(Delete) 됩니다. 원본은 100% 안전합니다.
⏰ 5.2 타임머신 가동하기: git init
방금 생성한 my-agent 폴더 안에는 아직 타임머신이 없습니다. 터미널에 다음 명령어를 입력하여 타임머신 블랙박스를 장착합니다.
git initInitialized empty Git repository in ... 이라는 메시지가 뜨면 성공입니다. 이제부터 이 폴더에서 일어나는 모든 파일의 수정, 삭제 내역은 Git이 몰래 기록하기 시작합니다.
6. 개발자의 진짜 작업실: VS Code 열기
터미널의 검은 화면에서는 코드를 수정하기가 너무 힘듭니다. 코드를 예쁘게 색칠해주고 파일들을 한눈에 보여주는 에디터, VS Code(Visual Studio Code)를 켭니다.
터미널에서 현재 위치가 my-agent 폴더인지 확인(pwd)한 후, 아래 명령어를 칩니다.
code .(점 . 은 ’이 폴더 전체를 열어라’라는 뜻입니다. 반드시 띄어쓰기를 지켜야 합니다.)
만약 command not found: code 에러가 뜬다면, 그냥 VS Code 프로그램을 더블클릭해서 연 다음, 바탕화면에 있는 my-agent 폴더를 마우스로 끌어다가(Drag & Drop) VS Code 화면 한가운데에 던져 놓으시면 됩니다.
[4차시 마무리] 수고하셨습니다! 이제 바탕화면에 나만의 AI 비서를 코딩할 완벽한 스튜디오 세팅이 끝났습니다. 타임머신(Git)도 장착했고, 에디터(VS Code)도 켰습니다. 다음 5차시에서는 프로젝트 폴더 안의 파일들을 열어보고, 우리 비서의 뇌를 직접 수술해 보는 심화 과정을 진행하겠습니다.