Skip to content

Sync Korean README with English version: hybrid search and depth control#40

Draft
Copilot wants to merge 2 commits intomainfrom
copilot/update-korean-readme
Draft

Sync Korean README with English version: hybrid search and depth control#40
Copilot wants to merge 2 commits intomainfrom
copilot/update-korean-readme

Conversation

Copy link
Contributor

Copilot AI commented Feb 16, 2026

Korean README (readmekr.md) was missing the depth control feature documentation and had outdated search algorithm description.

Changes

  • Focus Mode section (line 72): Updated search algorithm description from "벡터 검색" to "하이브리드 검색 (정확한 매칭 우선, 그 다음 벡터 검색)" to match English README's "hybrid search (exact match first, then vector search)"

  • Depth Control section (after line 79): Added complete section "깊이 제어: 콜 그래프로 컨텍스트 확장" covering:

    • --depth flag usage with examples (0, 1, 2)
    • Four-step algorithm explanation (exact match → vector fallback → call graph traversal → smart filtering)
    • Use case guidance for different depth levels

Korean documentation now mirrors English version structure at lines 70-107.

Original prompt

한글 README 업데이트: 영문 버전과 내용 동기화

문제 설명

현재 readmekr.md (한글 README)가 README.md (영문 README)와 비교했을 때 일부 중요한 내용이 누락되어 있습니다.

필요한 변경사항

1. Focus Mode 섹션 설명 개선

현재 (72줄):

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

변경 후:

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

2. Depth Control 섹션 추가

Focus Mode 예시 코드 블록 다음 (79줄 이후)에 아래 섹션을 추가해주세요:

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

포커스 모드를 사용할 때 **콜 그래프**를 통해 `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+: 여러 레이어에 걸친 복잡한 문제를 디버깅할 때


## 참고사항
- 현재 한글 README는 79줄에서 바로 "데몬 모드" 섹션으로 넘어갑니다
- 영문 README에는 81-106줄에 Depth Control 섹션이 있습니다
- 번역은 자연스러운 한국어로 작성해주세요
- 코드 블록과 마크다운 포맷팅은 그대로 유지해주세요

## 파일 위치
- 수정할 파일: `readmekr.md`
- 참고 파일: `README.md`

This pull request was created from Copilot chat.


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Co-authored-by: BETAER-08 <109971893+BETAER-08@users.noreply.github.com>
Copilot AI changed the title [WIP] Update Korean README to synchronize with English version Sync Korean README with English version: hybrid search and depth control Feb 16, 2026
Copilot AI requested a review from BETAER-08 February 16, 2026 00:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants