AI 에이전트를 위한 Android CLI: 대규모 모바일 개발 환경에 적용하기

구조와 흐름

• 대규모 Android 저장소에서 AI 에이전트가 토큰을 과도하게 소비하는 문제를 줄이기 위해 Android CLI 위에 얇은 래퍼, 스킬, 프롬프트를 얹는 방식 소개
• 문서 검색, Android Studio 연동, Compose 프리뷰 렌더링을 에이전트별 실행 경로에 맞게 정규화하고, 오류는 파싱 가능한 한 줄로 변환하는 설계
• 저장소에 바이너리와 스킬을 번들링해 환경 차이, 보안 인자 누락, 출력 폭증을 줄이는 접근 제시

선택 이유

• grep/glob보다 IDE 인덱싱 기반의 의미론적 검색이 대규모 코드베이스에서 더 정확하다는 점 강조
• 에이전트 종류가 달라도 동일한 스킬 인터페이스를 유지해 유지보수와 재사용성을 높이려는 목적 설명
• 출력 요약과 파일 스냅샷 분리를 통해 반복 호출과 컨텍스트 낭비를 줄이려는 이유 제시

주의할 점

• Gradle sync가 최신 상태가 아니면 인덱스 기반 명령 결과가 불완전할 수 있음
• find-usages는 CLI에서 신뢰성 문제가 있어 현재 비활성화하고 grep으로 대체 중
• ~/.android/cli 쓰기 권한 차단, 오래된 PID, 최상위 Kotlin 심볼 표기 등 래퍼에서 보완해야 할 예외 존재

적용해볼 점

• CLI 출력을 그대로 노출하지 말고 요약 결과와 상세 파일을 분리하는 패턴 적용
• 에이전트가 자주 반복하는 실패는 사전 점검과 짧은 오류 메시지로 치환
• IDE 외부 에이전트와 IDE 내부 에이전트의 경로를 분리하되, 기능 단위 인터페이스는 1:1로 맞추는 방식 검토