최근 많은 개발자들이 VS Code 코드베이스를 기반으로 구축된 최첨단 AI 네이티브 IDE인 Google Antigravity(안티그래비티)를 활용해 자율 코딩 에이전트를 운용하고 있습니다. 단순히 대화창에서 코딩 비서로 활용하는 것을 넘어, 에이전트에게 우리 프로젝트에 특화된 스킬을 주입하고 로컬 데이터베이스와 클라우드 인프라를 자유롭게 다룰 수 있는 권한을 제공해야 진정한 개발 자동화가 가능해집니다.
안티그래비티 플랫폼은 에이전트의 기능을 무한히 커스텀하고 배포할 수 있는 재사용 가능한 단위인 '플러그인(Plugins)' 아키텍처를 제공합니다. 플러그인을 활용하면 특정 프로젝트 전용 비즈니스 로직, 보안 제약 조건, 그리고 MCP(Model Context Protocol) 통신 도구 세트를 단일 모듈로 패키징할 수 있습니다.
이 글에서는 나만의 AI 에이전트 능력을 커스터마이징하고 손쉽게 배포할 수 있도록 구글 안티그래비티 플러그인의 폴더 구조, 핵심 구성 파일 설정, 그리고 실전 개발 절차를 자세히 정리해 드립니다.
📊 Antigravity 플러그인 핵심 구성요소
| 구성 파일 / 폴더 | 기능 및 역할 | 필수 여부 |
|---|---|---|
plugin.json |
플러그인의 식별 명칭(name)을 기록하는 필수 마커 메타데이터 파일 | 필수 (Required) |
mcp_config.json |
로컬 CLI 실행 파이프(stdio) 및 원격 API 엔드포인트 연동 설정을 담은 MCP 프로토콜 스펙 | 선택 (Optional) |
skills/ |
에이전트가 특정 도구를 빌드하거나 비즈니스 기능을 동작할 때 학습하는 SKILL.md 파일들의 목록 |
선택 (Optional) |
rules/ |
에이전트가 코드 작성 시 우회하면 안 되는 구조적 제약 및 스타일 제안을 담은 마크다운 규칙집 | 선택 (Optional) |
1. 플러그인의 설치 및 로딩 경로 (Loading Paths)
구글 안티그래비티 에디터는 프로젝트가 기동할 때와 세션이 새로 열릴 때 자동으로 지정된 디렉토리 목록을 스캔하여 플러그인을 적재합니다. 개발자는 본인의 용도에 따라 설치할 물리 경로를 결정할 수 있습니다.
- 프로젝트 로컬 수준 (Workspace Level): 특정 Git 리포지토리 안에서만 해당 플러그인의 혜택을 보고 싶을 때는 프로젝트 루트 폴더 아래의
.agents/plugins/또는_agents/plugins/하위에 플러그인을 패키징해 위치시킵니다. - 머신 글로벌 수준 (Global Level): 프로젝트의 종류에 상관없이 내 로컬 PC에 띄우는 모든 안티그래비티 세션에서 상시 구동하고 싶을 때는 사용자 홈 디렉토리의 글로벌 폴더인
~/.gemini/config/plugins/하위에 배치합니다.
2. 플러그인 표준 폴더 레이아웃
안티그래비티 플러그인은 규격화된 파일 시스템 트리 구조를 가집니다. 아래 다이어그램은 플러그인이 탑재할 수 있는 이상적인 표준 레이아웃을 형상화한 것입니다.
3. 실전 개발 3단계 프로토콜
1단계: 마커 메타데이터 설정 (plugin.json)
원하는 플러그인 루트 폴더를 개설하고 첫 줄로 아래의 plugin.json 파일을 작성합니다. 이 파일이 존재해야 안티그래비티 코어가 해당 폴더를 정식 모듈로 감지하여 마운트합니다.
{
"name": "my-database-integration-plugin"
}2단계: MCP 통신 서버 설정 (mcp_config.json)
에이전트가 로컬 데이터베이스나 특정 외부 CLI 바이너리를 사용할 수 있도록 통신용 MCP 설정을 지정해 줍니다. Stdio 입출력 통신 방식을 주로 매핑하여 연결합니다.
{
"mcpServers": {
"neon-db-connector": {
"command": "node",
"args": ["/Users/user/servers/neon-mcp/index.js"],
"env": {
"DATABASE_URL": "postgresql://user:pass@host/db"
}
}
}
}3단계: 에이전트용 스킬 명세서 빌드 (SKILL.md)
skills/ 디렉토리 밑에 임의의 하위 폴더를 만들고 SKILL.md 파일을 빌드합니다. 여기에 에이전트가 어떤 상황일 때 해당 스킬을 소환해야 하며, 구체적으로 어떤 쉘 명령어나 MCP 툴을 구동해야 하는지 지침을 적어둡니다.
---
name: my-database-query-skill
description: 이 스킬은 Neon DB 데이터베이스에 쿼리를 실행하거나 스키마 조회가 필요할 때 소환합니다.
allowed-tools: Bash(neon-db-connector:*)
---
# DB 쿼리 실행 규칙
1. 쿼리 실행 전에 반드시 테이블 스키마를 확인하십시오.
2. 파괴적인 DDL 쿼리는 사용자 승인 하에서만 제안해야 합니다.
3. 쿼리 수행 명령어: `npx neon-cli run "SQL문"`💡 **개발 및 디버깅 팁:** "플러그인을 수정한 뒤에는 안티그래비티 에디터를 재시동하지 않고도, 에이전트 사이드 패널 상단에서 'Reload Context' 아이콘을 클릭하여 새로운 플러그인 및 스킬 설정을 즉각 세션에 활성화할 수 있습니다."
❓ 자주 묻는 질문 (FAQ)
Q. 플러그인을 Git 저장소에 넣어 동료 팀원들과 공유할 수 있나요?
A. 네. 공유하고 싶은 플러그인 디렉토리를 워크스페이스 레벨 경로인 프로젝트 루트의 .agents/plugins/ 아래에 그대로 집어넣고 Git Commit을 실행하여 원격 저장소에 푸시하면 됩니다. 동료 팀원들이 git pull을 통해 프로젝트를 가져오면 별도 셋업 없이 안티그래비티 IDE가 해당 플러그인을 자동으로 감지하여 에이전트에 통합해 줍니다.
Q. MCP 서버 등록 시 OAuth 인증 연동도 지원하나요?
A. 예, 지원합니다. 외부 클라우드나 SaaS API를 직접 쿼리하기 위해 OAuth 인증이 필요한 경우, mcp_config.json에 oauth 정보와 serverUrl을 등록하여 안티그래비티 에디터 내부 Customizations 창에서 사용자 로그인을 유도해 세션 인증을 동적으로 획득할 수 있습니다.
0 댓글