캐러티 규칙

Careti 규칙을 사용하면 Careti 시스템 수준 지침을 제공할 수 있습니다. 프로젝트 또는 모든 대화에 대해 전역적으로 컨텍스트와 기본 설정을 포함하는 지속적인 규칙이라고 생각하면 됩니다.

ℹ️Note

Careti Agent Standardization: Careti .agents/context 폴더를 기본 규칙 소스(SoT)로 사용하며, AGENTS.md 파일도 지원합니다. /init 명령으로 표준 구조를 쉽게 생성할 수 있습니다.

규칙 생성

Rules 탭의 + 버튼을 클릭하면 규칙을 생성할 수 있습니다. IDE에 새 파일이 열리고, 그곳에서 규칙을 작성합니다.

파일을 저장하면:

• 워크스페이스 규칙은 프로젝트의 .agents/context/ 디렉토리에 저장됩니다.
• 전역 규칙은 전역 규칙 디렉토리에 저장됩니다.

전역 규칙 디렉토리 위치

전역 규칙 디렉토리 위치는 운영체제에 따라 다릅니다.

운영 체제	기본 위치	참고
Windows	Documents\<BrandName />\Rules	시스템 문서 폴더 사용
macOS	~/Documents/캐러티/Rules	사용자 문서 폴더 사용
Linux/WSL	~/Documents/캐러티/Rules	일부 시스템에서는 ~/캐러티/Rules로 대체될 수 있습니다.

Linux/WSL 사용자 참고: ~/Documents/캐러티/Rules에서 전역 규칙을 찾을 수 없으면 ~/캐러티/Rules도 확인하세요. 문서 디렉토리 유무에 따라 위치가 달라질 수 있습니다.

채팅에서 /newrule 슬래시 명령을 사용해 Careti 규칙 파일을 생성하도록 할 수도 있습니다.

# Project Guidelines

## Documentation Requirements

-   Update relevant documentation in /docs when modifying features
-   Keep README.md in sync with new capabilities
-   Maintain changelog entries in CHANGELOG.md

## Architecture Decision Records

Create ADRs in /docs/adr for:

-   Major dependency changes
-   Architectural pattern changes
-   New integration patterns
-   Database schema changes
    Follow template in /docs/adr/template.md

## Code Style & Patterns

-   Generate API clients using OpenAPI Generator
-   Use TypeScript axios template
-   Place generated code in /src/generated
-   Prefer composition over inheritance
-   Use repository pattern for data access
-   Follow error handling pattern in /src/utils/errors.ts

## Testing Standards

-   Unit tests required for business logic
-   Integration tests for API endpoints
-   E2E tests for critical user flows

주요 이점

1. 버전 관리: .agents/context 파일이 프로젝트 소스의 일부가 됩니다.
2. 팀 일관성: 팀 전원이 동일한 동작을 유지할 수 있습니다.
3. 프로젝트 맞춤: 프로젝트 요구에 맞춰 규칙과 표준을 조정합니다.
4. 지식 보존: 프로젝트 표준과 관행을 코드로 유지합니다.

.agents/context 파일을 프로젝트 루트에 배치합니다:

your-project/
├── .agents/context
├── src/
├── docs/
└── ...

Careti 시스템 프롬프트는 사용자가 편집할 수 없지만, 규칙 파일을 통해 AI의 동작을 세밀하게 제어할 수 있습니다. 프롬프트 엔지니어링 모범 사례는 Anthropic 가이드를 참고하세요.

AGENTS.md 표준 지원

Careti 캐러티 규칙과 별도로 AGENTS.md 표준도 지원합니다. 워크스페이스 루트에 AGENTS.md가 있을 때 자동으로 감지합니다. 이를 통해 다른 AI 코딩 도구에서도 동일한 규칙 파일을 재사용할 수 있습니다.

your-project/
├── AGENTS.md
├── src/
└── ...

효과적인 Careti 규칙 작성 팁

• 명확하고 간결하게 작성
• 원하는 결과에 집중(세부 절차보다 목표 중심)
• 반복적으로 테스트하고 개선

.agents/context/ 폴더 시스템

your-project/
├── .agents/context/         # 활성 규칙을 포함하는 폴더
│   ├── 01-coding.md          # 핵심 코딩 표준
│   ├── 02-documentation.md   # 문서 요구 사항
│   └── current-sprint.md     # 현재 작업 전용 규칙
├── src/
└── ...

Careti .agents/context/ 디렉토리 내의 모든 Markdown 파일을 자동으로 결합해 하나의 규칙 세트로 사용합니다. 숫자 접두사(선택)는 논리적 순서를 잡는 데 도움이 됩니다.

비활성 규칙 보관 (선택)

프로젝트/팀 맥락이 다양한 경우 비활성 규칙을 별도 폴더에 보관하고 필요할 때 .agents/context/로 복사하세요. 보관 폴더는 자동 로딩되지 않습니다.

your-project/
├── .agents/context/         # 활성 규칙 - 자동 적용
│   ├── 01-coding.md
│   └── client-a.md
│
├── rules-bank/              # 비활성 규칙 라이브러리
│   ├── clients/             # 클라이언트별 규칙
│   │   ├── client-a.md
│   │   └── client-b.md
│   ├── frameworks/          # 프레임워크별 규칙
│   │   ├── react.md
│   │   └── vue.md
│   └── project-types/       # 프로젝트 유형 표준
│       ├── api-service.md
│       └── frontend-app.md
└── ...

폴더 접근 방식의 장점

1. 컨텍스트별 활성화: 필요한 규칙만 활성 폴더로 복사
2. 유지 보수 용이: 다른 규칙에 영향을 주지 않고 업데이트 가능
3. 팀 유연성: 현재 작업에 맞는 규칙만 활성화
4. 노이즈 감소: 활성 규칙 세트를 작고 명확하게 유지

사용 예시

클라이언트 프로젝트 전환:

# 클라이언트 B 프로젝트로 전환
rm .agents/context/client-a.md
cp rules-bank/clients/client-b.md .agents/context/

기술 스택 전환:

# 프론트엔드 React 프로젝트
cp rules-bank/frameworks/react.md .agents/context/

구현 팁

• 규칙 파일은 하나의 관심사에 집중
• 목적이 드러나는 파일명 사용
• 활성 .agents/context/는 git-ignore하고 rules-bank/만 추적하는 방식을 고려
• 자주 쓰는 조합은 팀 스크립트로 자동화

폴더 시스템은 Careti 규칙을 정적 문서에서 팀 컨텍스트에 맞게 진화하는 지식 시스템으로 바꿔줍니다.

토글 가능한 팝오버로 규칙 관리

Careti v3.13은 채팅 인터페이스에서 바로 접근 가능한 규칙 관리 팝오버 UI를 제공합니다. 이 UI를 통해:

• 활성 규칙 즉시 확인: 전역 규칙과 워크스페이스 규칙을 한눈에 확인
• 규칙 빠르게 토글: .agents/context/ 폴더 내 규칙 파일을 클릭 한 번으로 활성/비활성화
• 규칙 추가/관리: 규칙 파일 또는 폴더가 없을 때 즉시 생성하고 관리

대화 중 파일을 수동 편집하지 않고도 컨텍스트를 전환할 수 있어 워크플로가 훨씬 매끄러워집니다.