Google Antigravity 규칙: 전역 및 프로젝트 지침 설정하기

Antigravity 규칙이란 무엇인가요?

Google Antigravity 규칙은 에이전트가 파일에서 찾아 관련 작업에 반영하는 지속 지침, 코딩 표준, 아키텍처 제약입니다. 채팅 요청은 보통 현재 대화 한 번에만 적용됩니다. 규칙은 저장된 컨텍스트가 되어 Antigravity가 찾을 수 있는 범위 안에서 이후 대화에도 영향을 줄 수 있습니다. 매번 반복해서 설명하던 테스트 명령, 생성 파일 처리 방식, 프로젝트의 데이터베이스 규약 등을 기록할 때 유용합니다.

유용한 Google Antigravity 규칙 구성은 세 가지를 분명히 합니다. 어떤 작업에 적용되는지, 에이전트가 무엇을 해야 하는지, 어떤 경계를 지켜야 하는지입니다. 실행할 수 있을 정도로 구체적으로 쓰되 검토하기 쉬운 길이로 유지하세요. 규칙을 추가해도 모든 명령이나 외부 작업이 자동으로 허용되지는 않습니다. 제안된 변경, 셸 명령, 네트워크 접근, 비밀 정보, 파괴적인 작업은 기존 검토 절차에 따라 계속 확인해야 합니다.

• 채팅 요청 현재 대화에서 한 번 사용할 요청입니다.
• 규칙 지원되는 파일과 범위에서 읽어 오는 지속 지침입니다.
• Skill 작업별 절차와 자료를 묶어 재사용하는 기능입니다. 자세한 내용은 Antigravity Skills 가이드를 참고하세요.

전역, 작업공간, 디렉터리 범위 선택하기

필요한 사람과 프로젝트를 모두 포함하는 범위 중 가장 좁은 것을 선택하세요. 전역 규칙은 사용자 프로필을 따라 작업공간 사이에서 적용되므로 어디서나 안전한 개인 선호 사항에 적합합니다. 작업공간 규칙은 저장소와 함께 관리할 수 있어 팀이 코드와 나란히 검토하기 쉽습니다. 큰 프로젝트의 일부 폴더만 별도 규약을 따라야 한다면 디렉터리 규칙을 사용하면 다른 폴더에 영향을 주지 않습니다.

Google Antigravity 규칙은 누적됩니다. 새 파일이 이전 지침을 대체하는 것이 아니라 Antigravity가 찾은 지침이 함께 적용됩니다. 지침이 충돌하면 더 구체적인 디렉터리 규칙이 우선합니다. 전역 설정과 저장소 규칙이 서로 모순되지 않도록 하고, 로컬 예외가 필요하면 그 이유를 명확하게 적으세요. 아래 표는 Antigravity App 문서에 현재 안내된 위치를 요약합니다.

Antigravity App에서 규칙 만들기

Antigravity App에서 애플리케이션 메뉴 또는 프로젝트 설정을 열고 Customizations 패널의 Rules 탭으로 이동하세요. 필요한 범위에 따라 + Global 또는 + Workspace를 선택합니다. App은 검토하고 수정할 수 있는 파일 기반 규칙을 만듭니다. IDE나 CLI 환경에서는 조작 방식이 다를 수 있으므로 문서에 나온 저장 위치와 환경별 안내를 확인하세요.

저장소 규칙은 광범위한 선언문 대신 반복되는 판단 하나부터 시작하세요. 적용할 파일이나 작업, 에이전트가 따라야 할 행동, 확인 방법을 적습니다. «파서 코드를 변경한 뒤 관련 단위 테스트를 실행한다»처럼 확인 가능한 지침이 «주의해서 작업한다»보다 유용합니다. 프로젝트에만 해당하는 사실은 저장소 규칙에 두어 다른 기여자도 코드와 함께 검토하고 갱신할 수 있게 하세요.

1. 범위 정하기사용자 프로필, 작업공간, 하위 디렉터리 중 지침을 둘 위치를 선택합니다.
2. Rules 열기App에서 Customizations의 Rules로 이동해 Global 또는 Workspace 항목을 만듭니다.
3. 행동 하나 작성하기목적, 적용할 작업, 필요한 행동, 유용한 확인 방법을 적습니다.
4. 저장 파일 검토하기저장 경로를 확인하고 규칙에 의존하기 전에 최종 문장을 읽습니다.

Frontmatter와 활성화 방식 설정하기

독립된 AGENTS.md와 GEMINI.md 파일에는 frontmatter를 사용하지 않습니다. 파일의 Markdown 내용이 해당 디렉터리 범위에서 계속 활성화됩니다. rules/ 폴더 안의 모듈형 Markdown 파일은 YAML frontmatter로 시작하고 유효한 trigger를 선언해야 합니다. trigger는 규칙을 언제 컨텍스트에 불러올지 정하므로 적용할 작업의 빈도와 예측 가능성에 맞춰 선택하세요.

always_on은 해당 범위의 모든 대화에 필요한 짧은 지침에 사용합니다. model_decision은 설명이 작업과 일치할 때만 에이전트가 자세한 내용을 읽도록 할 때 적합합니다. glob은 파일 패턴으로 자동 활성화하며 필수 필드 globs를 지정해야 합니다. manual은 @로 명시적으로 언급했을 때만 불러옵니다. 최신 문서에는 이 네 가지 trigger 값이 안내되어 있습니다.

---
trigger: glob
globs: "*.ts, *.tsx"
description: "TypeScript 파일을 변경할 때 이 규약을 적용한다."
---

# TypeScript 변경

- 내보내는 함수에 타입을 지정한다.
- 편집한 뒤 관련 TypeScript 테스트를 실행한다.
- 생성된 파일을 직접 수정하지 않는다.

규칙이 적용되는지 확인하기

파일을 저장했다고 해서 원하는 지침이 실제로 불러와졌다는 뜻은 아닙니다. 규칙 범위와 분명히 맞는 작고 위험도가 낮은 요청으로 시험하세요. glob 규칙이라면 패턴과 일치하는 파일과 가까이 있지만 일치하지 않는 파일을 각각 사용합니다. manual 규칙은 한 번 @로 명시한 결과와 언급하지 않은 결과를 비교하세요. 규칙이 응답에 영향을 주었는지 관찰할 수 있도록 작업 범위를 작게 유지합니다.

결과를 검토할 때는 에이전트가 전반적으로 더 신중해 보인다는 인상보다 규칙에 적은 구체적인 행동을 찾으세요. 변경된 파일과 실행된 명령도 확인합니다. 기대한 행동이 없으면 경로, 작업공간 루트, frontmatter 표기, trigger, glob 패턴, 더 구체적인 규칙의 간섭 여부를 살펴보세요. 한 번에 원인 하나만 수정하고 같은 시험을 반복해야 변경 효과를 구분할 수 있습니다.

1. 분명한 작업 고르기규칙의 영향을 확인할 수 있는 작은 행동을 선택하고 위험한 변경은 피합니다.
2. 경계 확인하기파일 규칙이면 일치하는 파일과 일치하지 않는 파일을 비교합니다.
3. 증거 살펴보기응답, 명령, 변경 파일, 테스트 결과를 규칙 내용과 대조합니다.
4. 수정 뒤 반복하기범위 또는 trigger 세부 항목 하나를 바꾸고 같은 확인을 다시 실행합니다.

문제 해결과 규칙 관리

Google Antigravity 규칙이 무시되는 것 같으면 우선 파일이 활성 작업공간과 지원되는 위치에 있는지 확인하세요. 정확한 파일명, .agents 표기, YAML 구분선과 들여쓰기도 점검합니다. 유효한 trigger가 없는 모듈형 규칙은 예상대로 불러와지지 않을 수 있습니다. glob 규칙은 확실히 일치하는 경로로 시험하고 패턴의 따옴표도 확인하세요. manual 규칙은 자동 활성화되지 않으므로 @로 직접 언급해야 합니다.

규칙에는 컨텍스트 크기 제한도 있습니다. 문서에 따르면 파일 포함 내용을 확장한 뒤 각 규칙 파일은 24KB로 제한되고, 활성 전역 규칙과 always_on 규칙은 20,000토큰 예산을 공유합니다. 전체 예산을 넘으면 가장 큰 규칙 파일이 경로와 설명만 있는 참조로 바뀔 수 있습니다. always_on은 짧게 유지하고 긴 참고 자료는 model_decision으로 옮긴 뒤 description에 언제 읽어야 하는지 적으세요.