AI에 전체 코드를 전달하기 전, ast-grep outline으로 코드 목차 만들기

요약

본 글은 대규모 코드베이스를 AI에 전달하기 전에 `ast-grep`의 `outline` 기능을 사용하여 코드를 구조화하고 목차를 만드는 방법을 분석합니다. 이 기능은 TypeScript 프로젝트에서 파일 또는 디렉토리 단위로 함수, 클래스, 공개 요소를 목록화하여 개발자가 필요한 부분을 정확히 파악할 수 있게 돕습니다. 이를 통해 코드 탐색 효율성을 높이고 AI 사용 시 토큰 및 비용을 절감하는 것이 목표입니다.

핵심 포인트

• `ast-grep outline`은 파일 또는 디렉토리의 구조적 목차를 생성하여 코드 분석의 시작점을 명확히 합니다.
• 디렉토리 단위로 공개 요소에 집중하려면 `outline src --items exports`와 같은 옵션을 사용할 수 있습니다.
• 파일 내부 구성을 파악할 때는 `outline src/file.ts`처럼 파일 경로를 지정하는 것이 유용합니다.
• 이 방법을 통해 불필요한 코드 전체를 AI에게 전달하는 것을 방지하여 개발 효율성과 비용을 개선할 수 있습니다.