본문 바로가기

Rules와 Workflows

학습 목표

  • Rules가 무엇인지 이해하고 만들 수 있다
  • Workflows를 생성하고 사용할 수 있다
  • Agent를 내 프로젝트에 맞게 설정할 수 있다

📌 선택 학습 안내
이 챕터는 고급 기능을 다룹니다. Agent 사용에 익숙해진 후 학습하면 더 효과적입니다. 처음이라면 건너뛰고

Artifacts 활용하기

로 이동하셔도 됩니다.

1. Rules란?

Rules는 Agent에게 제공하는 가이드라인입니다. 사용자의 코딩 스타일, 프로젝트 규칙, 선호사항을 Agent에게 알려줍니다.

1.1 Rules로 할 수 있는 것

용도예시
코딩 스타일"함수 이름은 camelCase로 작성"
프로젝트 규칙"CSS 클래스명은 케밥-케이스로 작성"
언어 설정"응답은 한국어로 해주세요"
금지 사항"console.log는 사용하지 마세요"

1.2 Rules의 종류

종류저장 위치적용 범위
Global Rules~/.gemini/GEMINI.md모든 워크스페이스
Workspace Rules.agents/rules/ 폴더현재 워크스페이스만

📌 파일 크기 제한
Rules 파일은 각각 12,000자까지 작성할 수 있습니다.

2. Rules 만들기

2.1 Customizations 패널 열기

  1. Editor에서 Agent 패널 상단의 "..." 버튼 클릭
  2. "Customizations" 선택
  3. "Rules" 탭으로 이동

Rules 패널 그림 6-1: Rules 패널

2.2 Global Rule 만들기

모든 프로젝트에 적용되는 규칙.

  1. "+ Global" 버튼 클릭
  2. 규칙 작성 (Markdown 형식)
  3. 저장

예시: 기본 코딩 스타일

# 코딩 스타일 가이드

## 일반 규칙
- 들여쓰기는 2칸 스페이스 사용
- 함수 이름은 동사로 시작
- 변수 이름은 명확하게 작성

## 응답 스타일
- 한국어로 응답해주세요
- 코드에 간단한 주석 추가

2.3 Workspace Rule 만들기

현재 프로젝트에만 적용되는 규칙.

  1. "+ Workspace" 버튼 클릭
  2. 규칙 이름 작성(test)
  3. 규칙 작성
  4. 저장

Workspace Rule 생성 그림 6-2: Workspace Rule 생성 버튼

예시: 웹 프로젝트 규칙

# 웹 프로젝트 규칙

## 파일 구조
- HTML 파일은 루트 폴더에 저장
- CSS 파일은 css/ 폴더에 저장
- JavaScript 파일은 js/ 폴더에 저장

## 코딩 스타일
- CSS 클래스명은 케밥-케이스 사용 (예: main-header)
- JavaScript 변수명은 camelCase 사용

3. Rules 활성화 방식

Rules가 언제 적용되는지 설정할 수 있습니다.

방식설명
Always On항상 적용
Manual@로 직접 언급할 때만 적용
Model DecisionAgent가 필요할 때 자동 적용
Glob특정 파일 패턴에만 적용 (예: *.js)

Rules 활성화 방식 설정 그림 6-3: Rules 활성화 방식 선택 화면

3.1 @ 멘션으로 Rule 활성화

Manual로 설정된 Rule은 채팅에서 @로 언급하여 활성화합니다.

한 작업공간 내에 여러 가지 룰이 있을 수도 있기에

Rules → {만들었던 룰}.md 를 직접 지정하여 사용하시면 됩니다.

@test.md 를 따라서 연락처 페이지를 만들어주세요.

@ 멘션으로 Rule 호출 그림 6-4: @ 멘션으로 Rule 호출하기

💡 @ 멘션으로 파일 참조하기
Rules 파일 안에서 다른 파일을 참조할 수도 있습니다.

  • @style.css - 현재 Rules 파일 기준 상대 경로
  • @/src/main.js - 프로젝트 루트 기준 경로

4. Workflows란?

Workflows는 반복적인 작업 순서를 저장해두는 기능입니다. 에이전트에 슬래시 명령어(/workflow-name)로 호출합니다.

📌 파일 크기 제한
Workflows 파일도 각각 12,000자까지 작성할 수 있습니다.

4.1 Workflows로 할 수 있는 것

  • 새 페이지 생성 절차
  • 코드 리뷰 체크리스트 실행
  • 프로젝트 초기 설정
  • 배포 전 점검 사항

5. Workflow 만들기

5.1 Customizations 패널에서 생성

  1. Customizations 패널 열기
  2. "Workflows" 탭으로 이동
  3. "+ Global" 또는 "+ Workspace" 클릭

Workflows 패널 그림 6-5: Workflows 패널

5.2 Workflow 구조

Workflow는 Markdown 파일로 작성합니다. 제목, 설명, 단계 순서로 구성됩니다.

# new-page (워크플로우 제목) 

## 설명 (Description)
새 HTML 페이지를 만들 때 사용하는 워크플로우입니다.

## 단계 (Content)

### 1단계: HTML 파일 생성
루트 폴더에 새 HTML 파일을 생성하세요.

### 2단계: 기본 구조 작성
HTML5 기본 구조를 작성하세요.

### 3단계: CSS 연결
css 폴더의 style.css를 연결하세요.

### 4단계: JavaScript 연결
js 폴더의 main.js를 연결하세요.

5.3 Workflow 실행

Agent 채팅에서 슬래시 명령어로 실행합니다.

/new-page about.html 페이지를 만들어주세요.

Workflow 실행 화면 그림 6-6: 슬래시 명령어로 Workflow 실행

이후 Agent가 Workflow의 각 단계를 순차적으로 실행합니다.

💡 Workflow 안에서 다른 Workflow 호출하기
Workflow 안에서 다른 Workflow를 호출할 수 있습니다.

예: /new-page Workflow 안에 "Call /new-style"을 포함하면, 페이지 생성 후 자동으로 스타일 적용 Workflow가 실행됩니다.

6. 실습: Rules와 Workflows 만들기

06-02에서 만든 자기소개 프로젝트에 Rules와 Workflows를 적용해봅시다.

6.1 실습 1: Global Rule 만들기

Agent에게 항상 적용될 기본 규칙을 만들어봅시다.

1단계: Customizations 패널 열기

Editor에서 Agent 패널 상단의 "..." 버튼을 클릭하고 "Customizations"를 선택합니다.

2단계: Global Rule 생성

Rules 탭에서 "+ Global" 버튼을 클릭합니다.

3단계: 규칙 작성

다음 내용을 입력합니다.

# 내 코딩 스타일

- 들여쓰기: 2칸 스페이스
- 문자열: 작은따옴표 사용
- 세미콜론: 항상 사용
- 응답: 한국어로

4단계: 저장

저장(Ctrl+S/Cmd+S) 버튼을 클릭합니다.

Global Rule 저장 그림 6-8: Global Rule 작성 및 저장

6.2 실습 2: Workspace Rule 만들기

자기소개 프로젝트에만 적용되는 규칙을 만들어봅시다.

1단계: Workspace Rule 생성

Rules 탭에서 "+ Workspace" 버튼을 클릭하고, new-rule 이름을 작성합니다.

2단계: 규칙 작성

다음 내용을 입력합니다.

# 자기소개 프로젝트 규칙

이 프로젝트는 다음 기술을 사용합니다.
- HTML5
- CSS3
- Vanilla JavaScript

외부 라이브러리는 사용하지 않습니다.

3단계: 저장

저장 버튼을 클릭합니다.

Workspace Rule 저장 그림 6-9: Workspace Rule 작성 완료

4단계: 테스트

Agent에게 다음과 같이 요청해봅시다. (이전에 만들었던 자기소개 페이지 활용)

연락처 섹션에 이메일 아이콘을 추가해주세요.

Agent가 외부 라이브러리 없이 CSS나 SVG로 아이콘을 만들어주는지 확인합니다.

Workspace Rule test 그림 6-9: Workspace Rule 테스트 완료

6.3 실습 3: Workflow 만들기

자주 사용하는 작업을 Workflow로 만들어봅시다.

1단계: Workflow 생성

Workflows 탭에서 "+ Workspace" 버튼을 클릭합니다.

2단계: Workflow 작성

다음 내용을 입력합니다.

# add-new-section (제목)

## 설명
자기소개 페이지에 새 섹션을 추가합니다.

## 단계

### 1단계
index.html에 새 section 요소를 추가하세요.

### 2단계
섹션에 적절한 id와 class를 부여하세요.

### 3단계
style.css에 새 섹션의 스타일을 추가하세요.

### 4단계
Browser로 결과를 확인하세요.

3단계: 저장

저장 버튼을 클릭합니다.

Workflow 저장 그림 6-10: Workflow 작성 완료

4단계: 테스트

Agent에서 슬래시 명령어로 테스트합니다.

/add-new-section "취미" 섹션을 추가해주세요.

Workflow 테스트 그림 6-11: Workflow 실행 결과

7. Agent가 Workflow 생성하기

Agent에게 Workflow 생성을 요청할 수도 있습니다.

방금 했던 작업을 Workflow로 만들어줘.

Agent가 대화 내용을 분석하여 자동으로 Workflow를 생성합니다. 반복적인 작업을 Agent와 함께 한 후 이 기능을 활용하면 편리합니다.

Agent가 생성한 Workflow 그림 6-12: Agent가 대화 기반으로 생성한 Workflow

8. 활용 팁

8.1 Rules 작성 팁

팁설명
구체적으로"좋은 코드를 작성해" → "함수는 20줄 이하로"
예시 포함원하는 코드 스타일 예시 첨부
@파일 참조@style.css처럼 참조 파일 지정

8.2 Workflows 활용 예시

  • /new-page - 새 HTML 페이지 생성
  • /add-section - 페이지에 새 섹션 추가
  • /test-style - CSS 스타일 일관성 점검
  • /browser-test - 여러 화면 크기에서 테스트

9. 정리

기능용도호출 방법
RulesAgent 가이드라인자동 또는 @멘션
Workflows반복 작업 자동화/명령어

10. 다음 단계

Agent 커스터마이징을 익혔다면, Skills로 Agent의 기능을 더 확장하는 방법을 배워봅시다.

Skills

💡 Skills란?
Skills는 Agent의 기능을 확장하는 재사용 가능한 지식 패키지입니다. 코드 리뷰, 테스트 작성, 배포 절차 등 특정 작업에 대한 전문 지식을 Agent에게 제공할 수 있습니다.

Skills까지 학습을 완료했거나 건너뛰려면, 다음 챕터에서 Artifacts를 활용하는 방법을 배워봅시다.

Artifacts 활용하기