[Antigravity #7] 나만의 규칙 만들기: Rules로 잔소리 자동화하기
Editor’s Note
“아 또 까먹었다.” 변수명 짓기, 주석 달기, 타입 체크하기… 매번 신경 쓰기 귀찮으시죠?
Antigravity에게 “우리 팀 규칙(Rules)”을 딱 한 번만 알려주세요.
그다음부턴 AI가 “팀장님 빙의”해서 알아서 챙겨줍니다.
1. Rules가 뭔가요?
AI에게 매번 “타입스크립트 엄격 모드로 짜줘”, “주석은 한글로 달아줘”라고 말하는 건 낭비입니다. Rules는 AI에게 “항상 지켜야 할 헌법”을 정해주는 기능입니다.
프로젝트 규칙은 코드 스타일만 강제하는 장치가 아닙니다. 에이전트가 파일을 만들고, 테스트를 실행하고, 리팩터링 방향을 고를 때 참고하는 기본 문맥입니다. 그래서 잘 만든 Rules는 “예쁘게 짜줘”보다 훨씬 강력합니다.
좋은 규칙은 세 가지를 분명히 합니다.
- 이 프로젝트에서 선호하는 기술 선택
- 절대 하면 안 되는 변경
- 작업 완료 전에 반드시 확인할 검증 절차
2. 30초 만에 규칙 만들기
Antigravity 2.0에서 Customizations → Rules → + Workspace를 열거나 저장소 루트의 .agents/rules/project.md에 Markdown으로 규칙을 작성합니다. 저장소 전체에 적용할 짧은 지침은 루트의 AGENTS.md에도 둘 수 있습니다. 제품별 공식 Rules 문서
내용은 그냥 평소에 하고 싶었던 잔소리를 글로 적으면 됩니다. 다만 잔소리도 구조가 있으면 더 잘 지켜집니다.
예시: 완벽주의자 모드
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# My Project Rules
1. **Coding Style**:
- 변수명은 무조건 `camelCase`를 사용하세요.
- 함수는 20줄을 넘기지 마세요. 길어지면 쪼개세요.
2. **Comments**:
- 모든 함수 위에는 기능을 설명하는 한국어 주석(JSDoc)을 다세요.
- "왜" 이렇게 짰는지 설명하지 않을 거면 코드를 짜지 마세요.
3. **Tech Stack**:
- CSS 대신 TailwindCSS만 사용하세요.
- `any` 타입은 절대로, 네버, 사용 금지입니다.
여기서 한 단계 더 나아가려면 “완료 조건”을 넣어주세요.
1
2
3
4
4. **Verification**:
- 변경 후 관련 테스트를 실행하세요.
- UI 변경은 브라우저에서 확인하고 스크린샷을 남기세요.
- 실행하지 못한 검증이 있으면 이유를 명확히 보고하세요.
AI에게 스타일만 알려주면 스타일 좋은 미완성 코드가 나올 수 있습니다. 검증 조건까지 알려줘야 실제로 합칠 수 있는 결과물이 됩니다.
3. 효과 확인하기
이제 평소처럼 “로그인 함수 만들어줘”라고 시켜보세요.
- Before: 그냥 작동만 하는 코드를 툭 던져줌.
- After:
any타입 없이 완벽한 타이핑- 함수 위에 친절한 한글 주석이 달려있음
verifyLogin처럼 카멜케이스 변수명 사용
규칙을 저장한 뒤 새 대화에서 적용 여부를 확인하세요. 출력이 규칙을 따르는지 직접 검토합니다.
효과를 확인할 때는 결과 코드만 보지 말고 “규칙이 정말 반영됐는지” 체크리스트로 확인하세요.
| 확인 항목 | 예시 |
|---|---|
| 네이밍 | camelCase, 컴포넌트 PascalCase |
| 타입 | any 사용 여부, nullable 처리 |
| 테스트 | 관련 테스트 실행 또는 미실행 사유 |
| 문서 | README, 주석, 변경 설명 갱신 |
한 번에 완벽한 규칙을 만들려고 하지 않아도 됩니다. 에이전트 결과를 리뷰하다가 반복해서 어긋나는 부분이 보이면 Rules에 한 줄씩 추가하면 됩니다.
4. 꿀팁: 팀원들과 공유하기
워크스페이스의 .agents/rules/project.md 또는 AGENTS.md를 저장소에 공유하세요. 그러면 우리 팀에 들어오는 신입 사원도, 협업하는 동료도 모두 똑같은 AI 규칙의 도움을 받게 됩니다.
규칙 파일을 공유하면 팀원이 같은 지침을 불러올 수 있습니다. 반드시 지켜야 하는 검사는 린터와 테스트에도 설정하세요.
공유할 때는 너무 개인적인 취향까지 강제하지 않는 것이 좋습니다. 예를 들어 “항상 함수는 20줄 이하” 같은 규칙은 학습용으로는 좋지만, 실무에서는 예외가 필요할 수 있습니다. 팀 규칙은 가능하면 도구로 검증 가능한 기준과 실제 프로젝트 품질에 영향을 주는 기준부터 넣으세요.
추천 우선순위:
- 보안상 금지할 행동
- 테스트와 빌드 검증 절차
- 프레임워크와 패키지 선택 기준
- 네이밍, 주석, 파일 구조 같은 스타일 규칙
5. 오늘의 요약
- 반복해서 전달하는 프로젝트 지침을
.agents/rules/또는AGENTS.md에 기록합니다. - 새 대화에서 해당 규칙이 적용되는 작은 작업을 요청하고 실제 변경을 확인합니다.
- 타입 검사나 테스트처럼 반드시 통과해야 하는 규칙은 프로젝트의 검사 명령과 CI로 확인합니다.
규칙을 세웠으니 이제 반복되는 잡무를 자동화해볼까요? 다음 편 [Antigravity #8] 에서는 기존 Workflows를 Agent Skills로 옮겨 배포 전 확인을 반복하는 방법을 배웁니다.