구성
규칙
규칙 파일로 Verdent의 동작 제어하기
규칙 파일은 코딩 세션 중 Verdent의 동작 방식을 정의하는 Markdown 문서입니다. AI 에이전트의 동작, 출력 형식, 프로젝트 표준 준수를 안내합니다.
배울 내용
- 사용자 규칙과 프로젝트 규칙 이해하기
- 각 규칙 유형을 언제 사용할지 알기
- 효과적인 규칙 작성하기
규칙 유형
| 규칙 유형 | 파일 | 범위 | 목적 |
|---|---|---|---|
| 사용자 규칙 | VERDENT.md | 전역(모든 프로젝트) | 개인 코딩 선호 사항 |
| 프로젝트 규칙 | AGENTS.md | 현재 프로젝트 | 팀 규칙, 프로젝트 표준 |
위치:
- 사용자 규칙:
~/.verdent/VERDENT.md - 프로젝트 규칙:
<project>/AGENTS.md
사용자 규칙(VERDENT.md)
사용자 규칙을 사용하면 모든 프로젝트에서 Verdent가 동작하는 방식을 맞춤 설정할 수 있습니다.
접근: Settings → User Rules
자동 저장: 변경 사항은 500ms 후 자동 저장됩니다
- 코딩 스타일 선호 사항: 들여쓰기, 명명 규칙
- 프레임워크 규칙: React, Vue, 언어 표준
- 응답 형식: 자세한 정도, 설명 스타일
- 개인 워크플로 선호 사항: 어조, 커뮤니케이션 스타일
# 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프로젝트 규칙(AGENTS.md)
프로젝트 규칙은 현재 프로젝트에 특화된 표준을 정의합니다. 팀 전체가 공유할 수 있도록 버전 관리에 커밋합니다.
접근: Project Settings 패널
위치: 프로젝트 루트(<project>/AGENTS.md)
- 팀 규칙: 공유 코딩 표준
- 아키텍처: 디자인 패턴, 상태 관리
- 테스트: 커버리지 요구 사항, 프레임워크
- 워크플로: 빌드 명령, PR 가이드라인
# 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버전 관리를 통해 AGENTS.md를 팀과 공유하면 모든 팀 구성원에게 일관된 AI 동작을 적용할 수 있습니다.
효과적인 규칙 작성하기
구체적으로 작성하기:
# 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
규칙 파일은 어떻게 만들나요?
개인 선호 사항을 편집하려면 Settings → User Rules로 이동해 VERDENT.md를 편집합니다. 프로젝트별 규칙은 프로젝트 루트에 AGENTS.md를 만듭니다. 글머리 기호가 있는 일반 Markdown을 사용합니다.
규칙 변경 사항은 언제 적용되나요?
규칙 변경 사항은 새 대화에 즉시 적용되며, 현재 대화의 응답에도 영향을 줍니다.
규칙을 일시적으로 재정의할 수 있나요?
단일 요청에 대해 규칙을 재정의하려면 프롬프트에 구체적인 지침을 제공할 수 있습니다.