Claude Code에 참고할 문서 링크

Claude Code 에이전트에게 전달할 지침

# 지침 파일 분리 및 온디맨드 참조 설정

## 목표
CLAUDE.md에 모든 지침을 넣지 않고, 필요할 때만 관련 지침 파일을 참조하도록 구성

## 디렉토리 구조

project/ ├── CLAUDE.md # 메인 지침 (핵심만) └── .claude/ └── instructions/ ├── flutter-style.md # Flutter 코딩 스타일 ├── api-patterns.md # API 패턴 가이드 ├── state-mgmt.md # 상태관리 지침 └── testing-guide.md # 테스트 작성 가이드

## CLAUDE.md 작성 방식
메인 CLAUDE.md에는 기본 규칙만 두고, 상세 지침은 @파일경로로 참조 안내:

```markdown
# 프로젝트 지침

## 기본 규칙
- 한국어 커밋 메시지
- dartdoc 주석 필수

## 작업별 참조 가이드
- Flutter 위젯 작업 → @.claude/instructions/flutter-style.md
- 상태관리 작업 → @.claude/instructions/state-mgmt.md  
- API 연동 작업 → @.claude/instructions/api-patterns.md
- 테스트 작성 → @.claude/instructions/testing-guide.md

해당 작업 시 관련 파일을 먼저 읽고 진행할 것.

핵심 원칙

1. CLAUDE.md는 항상 로드되므로 최소화
2. 상세 지침은 별도 .md 파일로 분리
3. @경로 문법으로 필요시에만 참조
4. 작업 컨텍스트에 맞는 파일만 로드하여 토큰 절약

이렇게 전달하면 에이전트가 구조를 잡아줄 거예요.