LLM처럼 Grep하기: AI 에이전트의 코드베이스 탐색 기법

섹션별 상세

AI 에이전트는 코드베이스를 처음 접할 때 전체를 읽지 않고 grep을 사용해 필요한 파일만 타겟팅한다.

bash

git grep -ci 'loyalty'

특정 키워드가 가장 많이 등장하는 파일들을 찾아 기능의 중심 위치를 파악하는 예시입니다.

효율적인 탐색을 위해 동사가 아닌 명사 위주로 검색하고, 진입점을 찾아 상단에서 하단으로 코드를 읽는 전략이 필요하다.

git grep은 프로젝트가 추적하는 파일만 검색하므로 node_modules나 빌드 결과물을 제외한 정확한 결과를 얻을 수 있다.

근거

git grep은 프로젝트가 추적하는 파일만 검색하므로 node_modules나 빌드 결과물을 제외한 정확한 결과를 얻을 수 있다. — Most use git grep, ordinary grep that only searches the files your project tracks, which is exactly what keeps node_modules and build output out of your results.

git log -S를 활용하면 특정 문자열이 추가되거나 삭제된 시점을 추적하여 코드 변경 이력을 파악할 수 있다.

bash

git log -S 'meltAlert' --oneline

특정 문자열이 추가되거나 삭제된 커밋을 추적하여 코드 변경 이력을 확인하는 예시입니다.

grep의 7가지 핵심 플래그(-i, -l, -c, -w, -n, -F, -C)를 익히면 코드베이스 탐색 속도를 획기적으로 높일 수 있다.

bash

git grep -w 'van'

부분 일치를 제외하고 단어 단위로 정확하게 검색하여 노이즈를 줄이는 예시입니다.

grep: — 텍스트 내에서 특정 패턴을 검색하는 명령줄 도구입니다. 대규모 코드베이스에서 특정 단어나 문자열이 포함된 파일과 라인을 빠르게 찾는 데 필수적인 도구입니다.
git grep: — Git 저장소 내에서 추적 중인 파일만을 대상으로 검색을 수행하는 명령어입니다. 프로젝트 외부 파일이나 빌드 결과물을 제외하고 코드베이스 내에서만 효율적으로 검색할 수 있습니다.
코드베이스 탐색(Codebase Navigation): — 방대한 코드베이스에서 필요한 로직, 파일, 변경 이력을 효율적으로 찾아내는 과정입니다. AI 에이전트가 코드를 이해하고 수정하기 위해 사용하는 핵심 전략입니다.