Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 27 additions & 1 deletion readmekr.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ amdb generate

## 🧠 고급 사용법: 포커스 모드

대규모 프로젝트의 경우, 전체 컨텍스트가 너무 클 수 있습니다. **포커스 모드**를 사용하여 특정 기능이나 버그와 관련된 요약을 생성하세요. `amdb`는 벡터 검색을 사용하여 가장 관련성 높은 파일을 찾습니다.
대규모 프로젝트의 경우, 전체 컨텍스트가 너무 클 수 있습니다. **포커스 모드**를 사용하여 특정 기능이나 버그와 관련된 요약을 생성하세요. `amdb`는 **하이브리드 검색** (정확한 매칭 우선, 그 다음 벡터 검색)을 사용하여 가장 관련성 높은 파일을 찾습니다.

```bash
# 예시: 인증 로직에 대한 컨텍스트 생성
Expand All @@ -78,6 +78,32 @@ amdb generate --focus "login authentication jwt"

이는 "login authentication jwt"와 관련된 심볼 및 파일만 포함하는 타겟팅된 요약(예: `.amdb/`)을 생성합니다.

### 🎯 깊이 제어: 콜 그래프로 컨텍스트 확장

포커스 모드를 사용할 때 **콜 그래프**를 통해 `amdb`가 관련 파일을 얼마나 깊이 탐색할지 제어할 수 있습니다. `--depth` 플래그는 초기 매칭된 파일로부터 몇 단계의 함수 호출을 탐색할지 결정합니다.

```bash
# Depth 0: 쿼리와 정확히 일치하는 파일만 포함
amdb generate --focus "authenticate" --depth 0

# Depth 1 (기본값): 매칭된 파일에서 직접 호출되는 파일 포함
amdb generate --focus "authenticate" --depth 1

# Depth 2: 호출 체인에서 2단계 깊이의 파일 포함
amdb generate --focus "authenticate" --depth 2
```

**작동 방식:**
1. **정확한 매칭 우선**: 먼저 쿼리와 정확히 일치하는 파일/심볼을 찾습니다
2. **벡터 검색 대체**: 정확한 매칭이 없으면 의미론적 유사도 검색을 사용합니다
3. **콜 그래프 탐색**: 깊이 N까지 함수 호출을 따라 컨텍스트를 확장합니다
4. **스마트 필터링**: 유사도 임계값(0.25) 내의 파일만 포함하여 컨텍스트 관련성을 유지합니다

**사용 사례 예시:**
- `--depth 0`: 핵심 구현만 필요한 경우 (예: 단일 모듈)
- `--depth 1`: 직접적인 종속성이 필요한 경우 (기본값, 대부분의 경우에 적합)
- `--depth 2+`: 여러 레이어에 걸친 복잡한 문제를 디버깅할 때

---

## 🔄 데몬 모드: 컨텍스트 자동 동기화
Expand Down