# 규칙 (/ko/docs/verdent-manager/configuration/rules)

> 규칙 파일로 Verdent의 동작 제어하기



규칙 파일은 코딩 세션 중 Verdent의 동작 방식을 정의하는 Markdown 문서입니다. AI 에이전트의 동작, 출력 형식, 프로젝트 표준 준수를 안내합니다.

## 배울 내용 [#배울-내용]

* 사용자 규칙과 프로젝트 규칙 이해하기
* 각 규칙 유형을 언제 사용할지 알기
* 효과적인 규칙 작성하기

***

## 규칙 유형 [#규칙-유형]

| 규칙 유형       | 파일         | 범위          | 목적            |
| ----------- | ---------- | ----------- | ------------- |
| **사용자 규칙**  | VERDENT.md | 전역(모든 프로젝트) | 개인 코딩 선호 사항   |
| **프로젝트 규칙** | AGENTS.md  | 현재 프로젝트     | 팀 규칙, 프로젝트 표준 |

**위치:**

* 사용자 규칙: `~/.verdent/VERDENT.md`
* 프로젝트 규칙: `<project>/AGENTS.md`

***

## 사용자 규칙(VERDENT.md) [#사용자-규칙verdentmd]

사용자 규칙을 사용하면 모든 프로젝트에서 Verdent가 동작하는 방식을 맞춤 설정할 수 있습니다.

**접근:** Settings → User Rules

**자동 저장:** 변경 사항은 500ms 후 자동 저장됩니다

<Tabs>
  <Tab title="목적">
    * **코딩 스타일 선호 사항:** 들여쓰기, 명명 규칙
    * **프레임워크 규칙:** React, Vue, 언어 표준
    * **응답 형식:** 자세한 정도, 설명 스타일
    * **개인 워크플로 선호 사항:** 어조, 커뮤니케이션 스타일
  </Tab>

  <Tab title="예시">
    ```markdown
    # User Rules

    ## Code Style
    - Always use TypeScript with strict mode
    - Prefer functional components over class components
    - Use Tailwind CSS for styling
    - Follow the project's existing naming conventions

    ## Communication
    - Provide brief explanations
    - Show code first, explain after
    - Write concise commit messages in conventional format
    ```
  </Tab>
</Tabs>

***

## 프로젝트 규칙(AGENTS.md) [#프로젝트-규칙agentsmd]

프로젝트 규칙은 현재 프로젝트에 특화된 표준을 정의합니다. 팀 전체가 공유할 수 있도록 버전 관리에 커밋합니다.

**접근:** Project Settings 패널

**위치:** 프로젝트 루트(`<project>/AGENTS.md`)

<Tabs>
  <Tab title="사용 사례">
    * **팀 규칙:** 공유 코딩 표준
    * **아키텍처:** 디자인 패턴, 상태 관리
    * **테스트:** 커버리지 요구 사항, 프레임워크
    * **워크플로:** 빌드 명령, PR 가이드라인
  </Tab>

  <Tab title="예시">
    ```markdown
    # AGENTS.md

    ## Dev Environment
    - Run `pnpm install` to set up
    - Use `pnpm dev` for local development

    ## Testing
    - Run `pnpm test` before committing
    - Minimum 80% coverage required

    ## PR Guidelines
    - Use conventional commit format
    - Include tests for new features
    ```
  </Tab>
</Tabs>

<Tip>
  버전 관리를 통해 AGENTS.md를 팀과 공유하면 모든 팀 구성원에게 일관된 AI 동작을 적용할 수 있습니다.
</Tip>

***

## 효과적인 규칙 작성하기 [#효과적인-규칙-작성하기]

**구체적으로 작성하기:**

```markdown
# Good
- Use async/await for asynchronous operations
- Include JSDoc comments for exported functions

# Avoid
- Try to use modern JavaScript features
- Add comments when necessary
```

**모범 사례:**

* 명확하고 지시적인 표현을 사용합니다("항상...", "절대...", "선호...")
* 관련 규칙을 섹션 제목 아래에 묶습니다
* 규칙은 간결하게 유지합니다(글머리 기호 하나에 개념 하나)
* 프로젝트가 발전함에 따라 규칙을 검토하고 업데이트합니다

***

## FAQ [#faq]

<AccordionGroup>
  <Accordion title="규칙 파일은 어떻게 만들나요?">
    개인 선호 사항을 편집하려면 Settings → User Rules로 이동해 `VERDENT.md`를 편집합니다. 프로젝트별 규칙은 프로젝트 루트에 `AGENTS.md`를 만듭니다. 글머리 기호가 있는 일반 Markdown을 사용합니다.
  </Accordion>

  <Accordion title="규칙 변경 사항은 언제 적용되나요?">
    규칙 변경 사항은 새 대화에 즉시 적용되며, 현재 대화의 응답에도 영향을 줍니다.
  </Accordion>

  <Accordion title="규칙을 일시적으로 재정의할 수 있나요?">
    단일 요청에 대해 규칙을 재정의하려면 프롬프트에 구체적인 지침을 제공할 수 있습니다.
  </Accordion>
</AccordionGroup>