Rules (규칙) - AIRGAP Studio 문서

개요

Rules는 AI 어시스턴트의 행동 방식을 프로젝트에 맞게 제어하는 규칙 파일입니다. .clinerules 파일을 통해 코딩 컨벤션, 금지 패턴, 응답 형식 등을 정의하면 AI가 이를 준수하며 작업합니다.

규칙 파일 위치

규칙은 두 가지 범위로 설정할 수 있습니다.

범위	파일 위치	적용 대상
프로젝트 규칙	프로젝트 루트의 `.clinerules`	해당 프로젝트에만 적용
글로벌 규칙	AIRGAP Assistant 설정 내 Custom Instructions	모든 프로젝트에 적용

프로젝트 규칙과 글로벌 규칙이 동시에 존재하면 두 규칙이 모두 적용됩니다. 충돌 시 프로젝트 규칙이 우선합니다.

규칙 파일 형식

.clinerules 파일은 마크다운 형식으로 작성합니다. 자연어로 규칙을 기술하면 AI가 이를 이해하고 따릅니다.

# 프로젝트 규칙

## 코딩 컨벤션
- TypeScript를 사용한다. JavaScript 파일을 생성하지 않는다.
- 함수명은 camelCase, 타입명은 PascalCase를 사용한다.
- 모든 함수에 JSDoc 주석을 작성한다.

## 금지 사항
- console.log를 프로덕션 코드에 남기지 않는다.
- any 타입 사용을 금지한다.
- 외부 네트워크 요청 코드를 작성하지 않는다.

## 응답 형식
- 코드 수정 시 변경 사항을 한국어로 요약한다.
- 파일 생성 시 파일 목적을 주석으로 명시한다.

규칙 활성화 및 비활성화

AIRGAP Assistant 설정 패널에서 규칙 파일을 개별적으로 토글할 수 있습니다.

AIRGAP Assistant 패널 상단의 설정 아이콘을 클릭합니다.
Rules 섹션에서 감지된 규칙 파일 목록을 확인합니다.
각 규칙 옆의 토글 스위치로 활성화/비활성화합니다.

팁: 규칙을 일시적으로 비활성화하면 AI의 기본 동작으로 되돌아갑니다. 규칙 파일을 삭제하지 않아도 되므로 실험적인 작업 시 유용합니다.

유용한 규칙 예시

에어갭 환경 전용 규칙

# 에어갭 보안 규칙
- 외부 CDN 링크를 사용하지 않는다. 모든 리소스는 로컬에서 제공한다.
- fetch, axios 등 네트워크 요청 라이브러리 호출을 포함하지 않는다.
- 환경변수에 API 키를 참조하는 코드를 작성하지 않는다.

한국어 프로젝트 규칙

# 한국어 프로젝트
- 주석과 문서를 한국어로 작성한다.
- 변수명과 함수명은 영문을 사용하되 JSDoc은 한국어로 작성한다.
- 에러 메시지는 사용자에게 표시되는 경우 한국어로 작성한다.