Read Original
#Backend

사람도 에이전트도, 덜 읽을수록 더 잘 고칩니다

사람도 에이전트도, 덜 읽을수록 더 잘 고칩니다
01

Summary

사람도 AI도 똑같다, 코드를 덜 읽어야 오류를 더 완벽하게 고칩니다

플렉스팀이 밝혀낸 AI 에이전트 맞춤형 고성능 아키텍처와 도메인 모듈화의 상관관계

AI 코딩 에이전트가 최상의 버그 수정 능력을 발휘하려면 도메인 경계가 명확한 코드베이스가 필수적입니다. 본 아티클은 에이전트의 상세 작업 로그 데이터 분석을 통해 모듈화된 아키텍처가 에이전트의 탐색 비용을 획기적으로 낮추고 컨텍스트 윈도우 낭비를 막는 메커니즘을 상세히 실증합니다. 최신 학계 연구 자료들과 flex 팀의 실제 정량적 성능 비교를 통합하여 차세대 코드 설계를 제시합니다.

  • 01물리 모듈 기반의 명확한 경계가 AI 에이전트의 불필요한 토큰 탐색 비용을 약 2.5배 아껴줍니다.
  • 02컴파일 레벨에서 의존성 선언을 강제하는 것이 에이전트의 무분별한 참조 추적을 원천 차단하는 가장 효과적인 방법임을 보여줍니다.
  • 03정산 도메인 집중 분석 로그를 통해 모듈 최적화 시 에이전트의 도메인 밀착 탐색률이 14%p 이상 향상됨을 입증했습니다.
  • 04컨텍스트에 쓸데없는 정보가 섞일 때 LLM의 논리 추론 성능이 극도로 저하된다는 학계의 이론을 실제 개발 현업 데이터로 입증했습니다.
  • 05에이전트가 코드를 해석하기 위한 배경지식(컨텍스트)으로 사용할 수 있도록 모듈 경로명 규칙이 '좌표계' 역할을 해준다는 인사이트를 소개합니다.

RECOMMENDATION

AI 에이전트의 코드 작성 및 수리 성능을 최대로 끌어올리려는 조직이라면 도메인 중심의 물리 모듈화를 적극 수용하십시오. 초기 비용을 들여 컴파일러 규약을 마련하는 것 자체가 에이전트 성능 보장에 절대적으로 이롭습니다.

The Problem

결합도가 높고 모듈화가 분리되지 않은 코드베이스는 AI 에이전트가 결함을 해결할 때 무관한 도메인의 참조를 불필요하게 추적하게 만들며 컨텍스트를 오염시킵니다. 이는 입력 텍스트의 총 길이가 길어질수록 성능 부하를 느끼고 해결률이 저하되는 대형 언어 모델(LLM)의 실효 컨텍스트 한계와 맞물려 실제 오류 해결 성공률을 하락시킵니다.

The Solution

도메인 단위로 물리적 빌드 모듈을 세분화하여 분리하고, 다른 도메인을 참조할 때는 반드시 빌드 설정 파일에서 명시적 의존성 선언을 하도록 강제하였습니다. 이를 통해 에이전트가 텍스트 탐색 시 임의로 다른 도메인의 코드로 무분별하게 진입하는 것을 컴파일 단계에서 차단하는 구조적 경계를 구축했습니다.

The Result

도메인 경계를 물리 모듈로 강제한 환경에서 AI 에이전트의 목표 도메인 내 탐색 집중도가 중앙값 기준 14%p 증가했습니다. 또한 동일 성격의 결함 진단 시 단일 모듈 아키텍처 대비 모듈화 아키텍처에서 에이전트가 연 파일 수는 6개 대 15개로 줄었으며, 사용된 소스 토큰 총량은 약 2.5배(13,891 vs 34,695 토큰) 절감되었습니다.

Trade-off

물리 모듈 분리는 디렉터리 구성, 빌드 스크립트 작성, 의존성 선언 등 엔지니어링 리소스 공수가 추가되므로 프로젝트 초기 단계나 소규모 구조에서는 오히려 복잡도와 의존 관리 비용이 실익을 넘을 수 있습니다.

03

Key Concepts

Concept · 01

물리적 모듈화

도메인 간 무분별한 의존 결합을 방지하기 위해 소프트웨어의 아키텍처 경계를 빌드 모듈 단위로 컴파일 영역에서 분리 및 제어하는 아키텍처 설계 기법입니다.

  • 정산 원장 등의 코틀린 기반 코드들을 도메인별 빌드 모듈로 세분화하여 물리적으로 분리했습니다.
  • 명시적으로 빌드 선언을 추가하지 않으면 타 도메인을 참조할 수 없도록 강제력을 부가했습니다.
Concept · 02

실효 컨텍스트

대형 언어 모델이 지원한다고 명시된 이론적 입력 창 크기보다 훨씬 작으며, 실제 높은 추론 성능을 일정 수준 이상 유지할 수 있는 물리적이고 실질적인 정보 처리 한계를 뜻합니다.

  • 입력의 길이 자체가 LLM 모델 추론 성능에 부정적인 영향을 주며, 32,000 토큰 지점부터 정확도가 크게 떨어짐을 실증했습니다.
  • 무관한 코드 파일 열기를 최소화함으로써, 핵심 버그 추론에 필요한 충분한 컨텍스트 공간을 확보했습니다.
Concept · 03

참조 추적 경로

에이전트나 인간이 어떤 특정 대상 코드를 분석해 나갈 때, 해당 코드 내부에서 끌어다 쓰고 있는 도메인 간의 결합 의존 관계망을 따라 디렉터리를 횡단해 가는 이동 궤적입니다.

  • 결합도가 심한 레포지토리에서 사용자 도메인을 찾던 에이전트가 참조를 무심코 따라가 직무 체계 패키지까지 연쇄적으로 읽으며 리소스가 낭비되는 과정을 포착했습니다.
  • 각 도메인 경로 및 모듈 앞머리에 좌표와 같은 표지(Coordinate)를 일관되게 부여해 탐색의 명확성을 높였습니다.