AI 코딩 에이전트가 대규모 레포지토리를 탐색하는 방식이 답답해서 직접 헬퍼 스크립트를 만들기 시작함
I was getting frustrated with how AI coding agents navigate large repos, so I started building some helper scripts
핵심 요약
대규모 프로젝트에서 AI 에이전트의 비효율적인 탐색 문제를 해결하기 위해 직접 경량화된 헬퍼 스크립트를 개발함.
- AI 탐색 비효율 — 에이전트가 불필요한 파일과 터미널 출력을 읽어 컨텍스트를 낭비함.
- 헬퍼 스크립트 개발 — 레포지토리 탐색을 제어하고 신호 대 잡음비를 개선하는 PowerShell 스크립트를 작성함.
- 워크플로우 최적화 — 전체 파일 대신 특정 심볼만 읽고 검색 범위를 좁혀 컨텍스트 사용량을 줄임.
- 커뮤니티 의견 공유 — 에이전트의 컨텍스트 관리를 위한 각자의 접근 방식과 도구 활용법을 논의함.
[블록 1/12] 꽤 규모가 큰 Laravel + React 프로젝트에서 Codex와 Antigravity를 사용하며 많은 시간을 보냈음.
[블록 2/12] 시간이 좀 지나니 똑같은 패턴이 계속 반복되는 게 보였음.
[블록 3/12] 에이전트는 다음과 같은 행동을 했음:
[블록 4/12] - 필요 이상으로 터미널 출력을 많이 읽음
- 단일 함수 하나 확인하려고 거대한 파일을 통째로 덤프함
- 여러 폴더에 걸쳐 비슷한 검색을 반복함
- 실제로 사용하지도 않는 정보에 컨텍스트를 낭비함
- 작은 셸 명령어가 너무 많아서 승인 요청을 수십 번씩 함
[블록 5/12] 모델 자체가 문제는 아니었음. 워크플로우가 문제였지.
[블록 6/12] 그래서 에이전트가 모든 것을 자유롭게 탐색하게 두는 대신, 레포지토리 탐색을 안내할 작은 PowerShell 헬퍼 스크립트 세트를 작성하기 시작했음.
[블록 7/12] 이런 것들임:
[블록 8/12] - 시끄러운 빌드/테스트 출력을 압축함
- 단일 명령어로 여러 폴더에 걸쳐 기능을 조사함
- 파일 전체 대신 특정 심볼만 읽음
- 검색 범위를 집중적으로 유지함
- 반복적인 레포지토리 탐색을 줄임
[블록 9/12] 아직 워크플로우를 실험 중이지만, 나한테는 이미 눈에 띄는 차이를 만들어냈음.
[블록 10/12] 다들 이 문제에 어떻게 접근하고 있는지 궁금함.
[블록 11/12] 그냥 에이전트가 자유롭게 탐색하게 두는 편임, 아니면 컨텍스트 사용량을 제어하기 위해 직접 도구나 규칙을 만들었음?
[블록 12/12] 관심 있는 사람이 있다면, 내가 만든 걸 댓글로 공유하겠음.
