Antigravity IDE에서 프로젝트 고유 규칙을 설정하는 방법

Gemini Pro 플랜을 계약하고 있어서, Antigravity IDE를 사용하고 있습니다.

Antigravity IDE는 5월 Antigravity의 버전 업데이트 때 분리된 개발 환경(에디터) 쪽입니다.

Claude Code의 "CLAUDE.md" 파일처럼, 프로젝트 고유의 규칙을 AI에게 학습시켜 프롬프트(Prompt)로 생성되는 코드의 정밀도를 높이고 싶습니다.

Antigravity IDE의 문서를 보면 다음과 같이 적혀 있습니다.

워크스페이스 규칙은 워크스페이스 또는 Git 루트의 .agents/rules 폴더에 저장됩니다.

프로젝트 폴더를 워크스페이스로 열고 있는 경우가 일반적이라고 생각합니다. 그곳에 .agents/rules 폴더를 만들고, MD 파일을 배치합니다.

MD 파일은 여러 개로 나눌 수 있으며, Antigravity IDE에서 파일을 열면 MD 파일마다 활성화/비활성화 전환을 할 수 있습니다. 하나의 MD 파일은 12,000자까지의 제한이 있습니다.

아래는 저의 규칙 파일 구성입니다.

프로젝트 루트
|- .git
|- .agents
...

AI 에이전트의 기본 규칙·워크플로우(Workflow)를 기술합니다.

기본 규칙은 "채팅이나 문서는 '일본어'로 기술할 것" 등을 정의하고 있습니다.

워크플로우는 "데이터베이스를 조작하는 변경은 반드시 구현 계획을 세우고 확인을 요청하세요" 등, 필요한 작업 항목을 정의하고 있습니다.

코딩 스타일과 명명 규칙(Naming Convention)을 기술합니다.

"Vanilla CSS를 사용해 주세요"나 "주석은 '일본어'로 기술해 주세요" 등입니다.

프로젝트의 구성을 기술하고 있습니다.

프로젝트 개요로서 "무엇을 하는 애플리케이션인가?"와 사용 중인 기술(Node.js) 및 언어(Javascript)를 지정하고 있습니다.

디렉토리 구성으로서 각 폴더에 무엇과 관련된 파일이 들어있는지 지정하고 있습니다.

.agents/rules 폴더에 MD 파일을 준비하면 OK입니다.

그 후에는 AI에게 지시를 내리면 MD 파일을 작성해 줍니다.

그리고 왠지 Gemini는 .agents/rules의 존재를 알려주지 않습니다. (스스로 문서를 찾아내는 능력을 시험받고 있는 것일까요?)