한 줄 요약: Antigravity 공식 문서 "Rules". 코딩 표준과 아키텍처 제약처럼 계속 지켜야 할 지시(규칙)를 Antigravity가 파일 시스템에서 찾아 에이전트 컨텍스트에 넣는 방식을 다룬다. AGENTS.md·GEMINI.md·.agents/rules/*.md의 위치와 탐색 범위(파일 폴더에서 워크스페이스 루트까지 올라가며 읽음), 모두 합치고 충돌 때는 더 구체적인 디렉터리 규칙이 앞선다는 규칙, trigger 4가지 활성 방식, @ 파일 포함 문법, 파일당 24 KB·합계 20,000토큰 한도, 표면(App·CLI·IDE)별 위치를 담는다.
원본 정보#
- 제목: Rules
- 발행: Antigravity 공식 문서(antigravity.google). 원문에 발행일·갱신일 표기가 없다(원본 날짜 미상).
- URL: https://antigravity.google/docs/rules/ (새 창) (받은 주소는 원문 마크다운
https://antigravity.google/docs/rules.md) - 수집(fetch)일: 2026-10-21. 경로, frontmatter 키, 한도 숫자는 이 날짜 기준이다.
핵심 주장#
- 규칙은 자동으로 찾아 넣는 지속 지시다. 한 대화에만 적용되는 채팅 프롬프트와 달리, Antigravity는 파일 시스템에서 규칙을 찾아 에이전트 컨텍스트에 넣는다. 원본 팁: 제약과 불변 조건(예: "검증에는 항상
zod")은 규칙으로, 여러 단계 워크플로(예: DB 마이그레이션 실행 방법)는 스킬로 쓴다. → 스키마 파일, 스킬 - 규칙은 대체가 아니라 누적이다. 원본: "Rules are cumulative rather than replacement-based". 전역·워크스페이스·디렉터리 범위에서 찾은 규칙을 모두 프롬프트에 합치고, 지시가 충돌하면 더 구체적인 디렉터리 규칙이 앞선다. 우선순위는 높은 것부터 디렉터리 범위 → 전역 순으로 나열된다. → AGENTS.md와 CLAUDE.md 함께 쓰기, Antigravity CLI
- 파일을 읽거나 고칠 때 그 폴더에서 워크스페이스 루트까지 올라가며 읽는다. 프로젝트의 어느 하위 디렉터리에든
AGENTS.md나GEMINI.md, 또는.agents/rules/디렉터리를 둘 수 있다. Antigravity는 파일을 읽거나 고칠 때마다 그 파일의 폴더에서 워크스페이스 루트까지 디렉터리 트리를 올라가며 각 단계의<dir>/AGENTS.md·<dir>/GEMINI.md,<dir>/.agents/AGENTS.md·<dir>/.agents/GEMINI.md,<dir>/.agents/rules/*.md(예전<dir>/.agent/rules/*.md포함)를 로드한다. → AGENTS.md와 CLAUDE.md 함께 쓰기 AGENTS.md·GEMINI.md는 frontmatter 없이 항상 켜지고,rules/안 파일은trigger가 필요하다.AGENTS.md와GEMINI.md는 전체를 일반 Markdown으로 보고 그 디렉터리 범위에서 계속 활성(always_on)이다.rules/안의.md는 모두 YAML frontmatter로 유효한trigger(always_on,model_decision,glob,manual)를 선언해야 하고, frontmatter가 없거나trigger값이 틀리면(예: camelCasealwaysOn) 조용히 버려진다. → 스키마 파일- 크기 한도가 둘 있다. 규칙 파일 하나는 24,000바이트(
@[label](path)포함을 펼친 뒤)를 넘으면 잘린다. 활성 전역 규칙과always_on규칙은 합쳐 20,000토큰 예산을 쓰고(스킬·MCP 같은 커스터마이즈 예산과 별도), 넘으면 가장 큰 규칙 파일부터 본문 대신 가벼운 포인터(- <path>: <description>)로 바꿔 에이전트가 필요할 때 읽게 한다. → AGENTS.md와 CLAUDE.md 함께 쓰기
원본의 경로·키 (2026-10-21 기준)#
| 범위 | 위치 | frontmatter |
|---|---|---|
| 디렉터리 | <dir>/, <dir>/, <dir>/., <dir>/., <dir>/..) | AGENTS.·GEMINI.는 쓰지 않음, rules/는 필수 |
| 전역 | ~/., ~/., ~/., ~/. | 쓰지 않음 |
| 전역 | ~/. | 필수 |
| CLI 전역 | ~/. | |
| CLI 플러그인 | ~/. | 설치한 플러그인의 규칙을 자동 활성 |
.agents/rules/는 바로 아래.md만 읽는다. 하위 폴더(예:.agents/rules/frontend/react.md)는.agents/rules.json에 등록하지 않으면 무시된다..agents/rules.json: 다른 위치의 규칙을 공유하거나 하위 폴더 규칙을 frontmatter·trigger를 유지한 채 넣는다. 키는inherits(다른rules.json경로),entries(path,exclude,include_only).- frontmatter 키:
trigger(필수),description(model_decision이면 필수, 나머지도 권장),globs(또는glob,glob이면 필수, 쉼표로 구분,*로 시작하면 따옴표로 감쌈).
활성 방식(trigger):
| 값 | 원본 설명 |
|---|---|
model_decision | 경로와 description만 먼저 넣고 |
always_on | 매 턴 전체 내용을 시스템 프롬프트에 넣는다. frontmatter가 필요 없으면 AGENTS.에 바로 두라고 권한다 |
glob | 에이전트가 globs 패턴에 맞는 파일을 다룰 때 자동 활성 |
manual | 자동으로 로드하지 않고, 채팅에서 @로 언급할 때만 넣는다 |
파일 참조 문법(모든 규칙 파일에서):
@[label](path): 대상 파일 내용을 규칙 안에 펼쳐 넣는다(프롬프트 평가와 크기 검사 전). 상대 경로는 규칙 파일이 있는 디렉터리 기준,~/는 홈. 포함한 파일의 YAML frontmatter는 떼고 본문만 넣는다.@filename: 내용을 펼치지 않는다. 경로를 풀어 정규 절대 워크스페이스 경로(@/workspace/path)로 바꿔 에이전트가 파일을 분명히 가리키게 한다.
표면별 위치: App과 IDE는 Customizations 패널의 Rules 탭에서 + Global·+ Workspace로 만든다. App의 전역 목록은 ~/.gemini/AGENTS.md, ~/.gemini/GEMINI.md, ~/.gemini/config/rules/*.md, CLI는 여기에 ~/.gemini/antigravity-cli/rules/*.md와 플러그인 규칙을 더해 적는다.
원본에 없는 것#
- 워크스페이스 루트 위의 디렉터리(상위 저장소, 홈 아래 다른 폴더)를 읽는지 따로 말하지 않는다. 원본이 말하는 범위는 "파일의 폴더에서 워크스페이스 루트까지"와 전역 위치다.
- 같은 디렉터리에
AGENTS.md와GEMINI.md가 둘 다 있을 때 둘의 순서나 우선순위는 말하지 않는다. 둘 다 같은 목록에 "or"로 나열될 뿐이다. - 하위 디렉터리 규칙이 세션 시작 때 미리 로드되는지는 말하지 않는다. 원본은 "파일을 읽거나 고칠 때마다" 올라가며 로드한다고만 쓴다.
- Codex·Claude Code의 지시 파일과의 관계, Gemini CLI 규칙 파일과의 차이는 다루지 않는다.