[Antigravity #7] 나만의 규칙 만들기: Rules로 잔소리 자동화하기

Editor’s Note
“아 또 까먹었다.” 변수명 짓기, 주석 달기, 타입 체크하기… 매번 신경 쓰기 귀찮으시죠?
Antigravity에게 “우리 팀 규칙(Rules)”을 딱 한 번만 알려주세요.
그다음부턴 AI가 “팀장님 빙의”해서 알아서 챙겨줍니다.

---

1. Rules가 뭔가요?

AI에게 매번 “타입스크립트 엄격 모드로 짜줘”, “주석은 한글로 달아줘”라고 말하는 건 낭비입니다. Rules는 AI에게 “항상 지켜야 할 헌법”을 정해주는 기능입니다.

프로젝트 규칙은 코드 스타일만 강제하는 장치가 아닙니다. 에이전트가 파일을 만들고, 테스트를 실행하고, 리팩터링 방향을 고를 때 참고하는 기본 문맥입니다. 그래서 잘 만든 Rules는 “예쁘게 짜줘”보다 훨씬 강력합니다.

좋은 규칙은 세 가지를 분명히 합니다.

• 이 프로젝트에서 선호하는 기술 선택
• 절대 하면 안 되는 변경
• 작업 완료 전에 반드시 확인할 검증 절차

---

2. 30초 만에 규칙 만들기

프로젝트 또는 워크스페이스의 Rules 설정 위치에 팀 규칙을 작성합니다. 구체적인 저장 위치나 UI는 버전에 따라 달라질 수 있으니, 현재 Antigravity의 Rules 설정 화면이나 문서를 기준으로 확인하세요.

내용은 그냥 평소에 하고 싶었던 잔소리를 글로 적으면 됩니다. 다만 잔소리도 구조가 있으면 더 잘 지켜집니다.

예시: 완벽주의자 모드

# My Project Rules

1. **Coding Style**:

   - 변수명은 무조건 `camelCase`를 사용하세요.
   - 함수는 20줄을 넘기지 마세요. 길어지면 쪼개세요.

2. **Comments**:

   - 모든 함수 위에는 기능을 설명하는 한국어 주석(JSDoc)을 다세요.
   - "왜" 이렇게 짰는지 설명하지 않을 거면 코드를 짜지 마세요.

3. **Tech Stack**:
   - CSS 대신 TailwindCSS만 사용하세요.
   - `any` 타입은 절대로, 네버, 사용 금지입니다.

여기서 한 단계 더 나아가려면 “완료 조건”을 넣어주세요.

4. **Verification**:
   - 변경 후 관련 테스트를 실행하세요.
   - UI 변경은 브라우저에서 확인하고 스크린샷을 남기세요.
   - 실행하지 못한 검증이 있으면 이유를 명확히 보고하세요.

AI에게 스타일만 알려주면 스타일 좋은 미완성 코드가 나올 수 있습니다. 검증 조건까지 알려줘야 실제로 합칠 수 있는 결과물이 됩니다.

---

3. 효과 확인하기

이제 평소처럼 “로그인 함수 만들어줘”라고 시켜보세요.

• Before: 그냥 작동만 하는 코드를 툭 던져줌.
• After:
  1. any 타입 없이 완벽한 타이핑
  2. 함수 위에 친절한 한글 주석이 달려있음
  3. verifyLogin 처럼 카멜케이스 변수명 사용

여러분이 “그렇게 하지 말랬지!”라고 화낼 필요가 없습니다. AI가 이미 알고 있으니까요.

효과를 확인할 때는 결과 코드만 보지 말고 “규칙이 정말 반영됐는지” 체크리스트로 확인하세요.

확인 항목	예시
네이밍	camelCase, 컴포넌트 PascalCase
타입	any 사용 여부, nullable 처리
테스트	관련 테스트 실행 또는 미실행 사유
문서	README, 주석, 변경 설명 갱신

한 번에 완벽한 규칙을 만들려고 하지 않아도 됩니다. 에이전트 결과를 리뷰하다가 반복해서 어긋나는 부분이 보이면 Rules에 한 줄씩 추가하면 됩니다.

---

4. 꿀팁: 팀원들과 공유하기

이 .antigravity/rules 파일을 깃허브(GitHub)에 같이 올리세요. 그러면 우리 팀에 들어오는 신입 사원도, 협업하는 동료도 모두 똑같은 AI 규칙의 도움을 받게 됩니다.

“야, 너 왜 주석 안 달았어?” 라는 말이 사라집니다. 주석 안 달면 AI가 코드를 안 짜주거든요.

공유할 때는 너무 개인적인 취향까지 강제하지 않는 것이 좋습니다. 예를 들어 “항상 함수는 20줄 이하” 같은 규칙은 학습용으로는 좋지만, 실무에서는 예외가 필요할 수 있습니다. 팀 규칙은 가능하면 도구로 검증 가능한 기준과 실제 프로젝트 품질에 영향을 주는 기준부터 넣으세요.

추천 우선순위:

1. 보안상 금지할 행동
2. 테스트와 빌드 검증 절차
3. 프레임워크와 패키지 선택 기준
4. 네이밍, 주석, 파일 구조 같은 스타일 규칙

---

5. 오늘의 요약

1. 매번 말하기 귀찮은 요구사항은 .antigravity/rules 파일에 적어둔다.
2. 개떡같이 말해도 찰떡같이 우리 팀 스타일로 코드를 짜준다.
3. 이 파일을 공유하면 팀 전체의 코딩 퀄리티가 상향 평준화된다.

규칙을 세웠으니 이제 반복되는 잡무를 자동화해볼까요? 다음 편 [Antigravity #8] 에서는 클릭 한 번으로 “빌드 -> 테스트 -> 배포”까지 끝내는 Workflows 기능을 배웁니다.