AI 친화적 코드베이스 ‐ AI는 왜 내 코드에서만 헤맬까? - BoostSwiftUI/SwiftUI GitHub Wiki

대규모 코드베이스에서 클로드 AI의 활용도 향상 방안

  • 클로드 AI 도구를 통해 빠른 프로토타이핑과 높은 생산성을 경험했으며, 이를 킷 코드에 적용하면 빠른 발전과 시장 점유율 확대가 가능하다고 판단했다.
  • 대규모 코드베이스에서 클로드 AI의 활용도를 높이기 위한 과제 중 가장 중요한 질문은 왜 클로드 AI가 대규모 코드베이스에서 방향을 잃고 헤매는가 하는 점이다.

컨텍스트 윈도우의 관련 없는 정보가 AI 모델 성능에 미치는 영향

  • 컨텍스트 북 문제는 텍스트 부패와 프롬프트 창에 관련 없는 맥락이 채워질 때 발생하며, 이는 모델의 성능을 저하시킨다.
  • 프롬프트 창에 관련 없는 맥락(초록색 영역으로 표시)이 증가할수록 인포 값이 늘어나고 결과적으로 모델의 성능이 급격하게 낮아진다.

대규모 코드베이스에서의 컨텍스트 부패 문제

  • 컨텍스트 부패는 관련 없는 맥락이 텍스트 창에 포함될 때 발생하며, 모델의 실제 성능을 저하시키는 치명적인 문제이다.
  • 컨텍스트 엔지니어링 측면에서 컨텍스트 부패는 현재 주요 화두이며, 대규모 코드베이스에서 특히 발생하기 쉽다.
  • 클로드의 코드 컨텍스트 창은 이러한 컨텍스트 부패 문제를 시각적으로 보여주는 사례이다.

AI 친화적 코드베이스: 규모별 콘텍스트 윈도우 차이점

  • 콘텍스트 윈도우에는 시스템 프롬프트, 플러그인 파일, MCP 툴 등 다양한 요소들이 포함되어 있다.
  • 소규모 코드베이스와 대규모 코드베이스 간에 시스템 구성 요소의 차이는 크지 않지만, 툴 결괏값의 품질 차이가 발생한다.
  • 설치 툴과 리드 툴 사용 시 소규모 코드베이스는 관련 파일만 정확하게 탐색하는 반면, 대규모 코드베이스는 관련 없는 코드와 파일까지 탐색하면서 정확도가 저하된다.

AI 코드 분석에서 컨텍스트 부패 문제 원인 분석

  • 대규모 코드베이스에서 탐색 도구 사용 시 불필요한 관련 없는 파일들이 검색되어 컨텍스트에 노이즈가 발생한다.
  • 탐색 결과에 포함된 관련 없는 맥락들이 AI의 코드 이해도를 저하시키는 컨텍스트 부패 문제를 야기한다.
  • 컨텍스트 부패 문제를 해결하기 위해서는 탐색 도구의 정확도 개선이 필요하다.

클로드 AI의 코드 탐색 기법과 시멘틱 검색 방식 비교

  • 클로드 AI는 커서와 같은 벡터 DB 기반 시멘틱 검색 방식과 달리 그랩과 블록을 사용하는 에이전트 탐색 기법을 제공한다.
  • 벡터 DB 인덱싱 방식은 빠른 속도의 시멘틱 검색을 가능하게 하지만, 클로드 AI는 더 단순한 도구를 활용하여 점진적인 탐색 방식을 사용한다.

AI 에이전트를 활용한 코드베이스 탐색 기법

  • 사용자의 프롬프트 요청을 받으면 LLM이 투어 값을 기반으로 전략적 추론을 수행하여 검색할 키워드를 결정한다.
  • 글로 풀, 그래 툴, 배시 툴 등의 탐색 도구를 활용하여 코드베이스를 탐색한다.
  • LLM은 탐색 결과를 분석하여 추가 재탐색이 필요한지 또는 탐색을 종료할지를 판단하는 반복적 프로세스를 수행한다.

대규모 코드베이스에서 AI 에이전트 탐색의 노이즈 문제

  • 문제 정의 없이 그래프와 글로스만 사용한 에이전트 탐색에서는 참조 문자열 충돌로 인한 노이즈가 발생한다.
  • 소규모 코드베이스와 달리 대규모 코드베이스에서는 동일한 함수명이나 클래스명이 광범위하게 존재하여 관련 없는 파일들이 과도하게 수집되는 문제가 발생한다.

대규모 코드베이스에서 AI의 네트워크 매니저 클래스 탐색 문제

  • 네트워크 매니저 클래스를 검색할 때 거시 코드를 포함한 다양한 모듈의 모든 네트워크 매니저 파일들이 함께 검색되는 문제가 발생한다.
  • 관련 없는 파일들을 탐색하면서 로그 코드가 무관한 코드들을 수집하게 되어 정작 중요한 코드들을 누락하는 텍스트 부패 문제가 발생한다.
  • 소규모 코드베이스에서는 특정 함수 탐색 시 5개 미만의 결과를 얻을 수 있지만, 대규모 코드베이스에서는 이러한 문제가 더욱 심화된다.

AI 코드 탐색 시 불필요한 파일 포함으로 인한 성능 저하

  • AI가 함수를 탐색할 때 관련 없는 파일들까지 콘텍스트 윈도우에 포함되는 문제가 발생한다.
  • 불필요한 파일들이 콘텍스트 윈도우를 차지하면서 윈도우 크기가 좁아져 모델의 성능이 저하된다.
  • 결과적으로 실제로 탐색해야 하는 중요한 파일들을 제대로 분석하지 못하는 상황이 발생할 수 있다.

대규모 코드베이스에서 AI 읽기 도구의 노이즈 문제 및 해결 방안

  • 대규모 코드베이스에서 관련 없는 코드들이 읽기 도구의 결과에 포함되어 노이즈가 발생하는 문제가 확인되었다.
  • 로그 코드는 전체 코드를 미리 로드하지 않고 필요한 순간에 동적으로 로드하는 가벼운 기법을 사용하여 이 문제를 해결한다.

AI 코드 분석의 경량 읽기 방식과 동적 탐색 전략

  • AI는 AST(추상 구문 트리)와 같은 코드 구조 분석을 사전에 수행하지 않고, 전체 코드를 미리 로깅하여 인덱싱하지 않는 방식을 채택한다.
  • 특정 함수의 위치를 미리 판단하지 않고 경량 읽기 도구를 사용하여 동적으로 하나씩 코드를 읽어나가는 방식으로 작동한다.
  • 그래프와 글로 탐색을 통해 파일 위치를 기반으로 초기 주변부 코드들을 읽으며 필요한 정보를 수집한다.

AI 코드 분석에서 구문 분석 없는 점진적 읽기 방식의 한계

  • AI는 추상 구문 트리(AST) 같은 구문 분석 없이 30~150줄 단위로 절대값 기반의 점진적 확장을 통해 코드를 읽는다.
  • 구문 분석 없는 적시적 접근 방식은 전체 파일을 반복적으로 읽어야 하는 횟수가 증가하는 문제를 야기한다.
  • 특정 코드 스니펫을 식별할 수 없어 함수의 위치를 파악하지 못하면, 그래프나 블록 사용 시 파일 경로만 반환되는 결과 제한이 발생한다.

AI가 대규모 코드베이스에서 컨텍스트 윈도우를 비효율적으로 사용하는 문제

  • AI는 특정 함수를 찾을 때 그 위치를 정확히 판단하지 못하고 전체 파일을 읽으려고 시도하는 경향이 있다.
  • 전체 파일을 컨텍스트 윈도우에 추가하면 필요 없는 관련 없는 코드까지 포함되어 컨텍스트 공간을 낭비하게 된다.
  • 특정 클래스, 프로토콜, 함수만 선택적으로 읽어야 하는 상황에서 AI의 비효율적인 파일 읽기 방식이 문제가 된다.

대규모 코드베이스에서의 컨텍스트 부패 문제

  • 소규모 코드베이스와 달리 대규모 코드베이스에는 과도하게 많은 코드가 포함된 슈퍼 파일들이 다수 존재한다.
  • 슈퍼 파일들을 읽을 때 관련 없는 코드들이 컨텍스트 윈도우에 포함되면서 컨텍스트 부패 문제가 발생할 수 있다.
  • 컨텍스트 부패는 AI가 코드를 분석할 때 불필요한 정보로 인해 정확도가 저하되는 문제를 야기한다.

클로드 AI의 코드 중복 구현 문제 분석

  • 사용자 저장소 파일에 사용자 저장소 프로토콜과 구현체가 포함되어 있고, 패치 사용자 유스케이스 파일이 이들에 의존하는 구조에서 메모리 캐싱 추가를 요청했다.
  • 클로드 AI는 저장소에 이미 캐싱 로직이 구현되어 있다는 것을 인식하여 유스케이스에서 캐싱 로직을 누락하는 문제가 발생한다.

저장소 프로토콜 의존성으로 인한 코드 유지보수 문제

  • 프론트엔드 코드가 저장소 프로토콜에만 의존하면서 들어올 데이터를 예측할 수 없는 상황이 발생한다.
  • 단일 구현체에 대한 의존성이 높아지면 약한 개발 문제가 생기고 모니터링이 어려워진다.
  • 이러한 구조적 문제는 나중에 유지보수와 리팩토링의 어려움을 초래하는 위험 요소가 된다.

클로드 AI의 대규모 코드베이스 처리 시 컨텍스트 부패 문제 분석

  • 컨텍스트 부패 문제는 관련 없는 코드가 컨텍스트에 포함될 때 발생하며, 이는 약한 면의 문제까지 야기할 수 있다.
  • 클로드 코드의 동작 원리를 분석한 결과 대규모 코드베이스에서 문제가 발생하는 원인을 파악했으며, 이를 해결하기 위한 다양한 시도와 개선 방안을 모색했다.

벡터 데이터베이스 기반 의미론적 탐색으로 코드 검색 최적화

  • 탐색 툴의 노이즈 문제를 해결하기 위해 벡터 데이터베이스 기반 의미론적 탐색 도입을 검토하고 있다.
  • 기존 설치 툴의 부하는 그래프와 블록에서 동일한 리터럴 문자열이 충돌할 때 발생하는 문제로 인한 것이다.
  • 벡터 데이터베이스에 코드의 문맥을 저장하면 컨텍스트 부하에서 더 안전하고 정확한 탐색이 가능할 것으로 예상된다.

클로드 AI를 위한 코드베이스 최적화 및 의미론적 검색 구현

  • 클로드 코드에 포함된 클로드 컨텍스트 MCP를 활용하여 메타데이터 기반 의미론적 탐색을 제공함으로써 관련 없는 코드 스니펫 검색을 줄일 수 있다.
  • APD 코드 부문 분석을 통해 코드를 스크립트한 후 오픈 AI 텍스트 임베딩에 입력하고 벡터 데이터베이스에 저장하는 방식으로 검색 증강 생성(RAG) 시스템을 구축한다.

클로드 AI의 대규모 코드베이스 시멘틱 탐색 최적화

  • 코드 스니펫을 미리 인덱싱하여 시멘틱 탐색을 제공하면 토큰 사용량과 API 호출 횟수를 최적화할 수 있다.
  • 빠른 탐색으로 인해 도구 호출 횟수가 감소하면서 쿠폰 사용량도 함께 최적화되는 효과가 나타난다.
  • 시멘틱 탐색은 컨텍스트 부패 문제를 해결하기 위해 시도되었으나, 대규모 코드베이스에서는 여전히 이 문제가 완전히 해결되지 않는다.

대규모 코드베이스에서 AI 컨텍스트 부패 문제

  • 대규모 코드베이스에서는 리터럴 충돌뿐만 아니라 문맥 충돌도 빈번하게 발생한다.
  • 코드 검색 시 10개 이상의 관련 없는 코드 스니펫이 함께 반환되어 컨텍스트 부패 문제를 야기한다.
  • 관련 없는 코드 스니펫들로 인해 AI가 필요한 정보를 누락하는 문제가 발생한다.

대규모 코드베이스에서 AI 컨텍스트 최적화 문제

  • 관련 없는 파일들이 컨텍스트에 포함되면서 필요한 코드를 누락하는 문제가 발생했다.
  • 검색 트리(RET) 구축과 인덱싱을 통해 탐색 속도 향상과 토큰 사용량 감소 효과를 확인했다.
  • 대규모 코드베이스에서는 여전히 컨텍스트 오염 문제를 해결하기 어려운 상황이 지속되고 있다.

AI 컨텍스트 부패 문제 해결을 위한 요약 및 스마트 컴팩트 기법

  • 기존 패턴 매칭 방식으로는 AI 컨텍스트 부패 문제를 완전히 해결할 수 없다는 결론에 도달했다.
  • 워크플로우별로 마크다운 파일을 작성하여 컨텍스트를 요약하는 방식을 검토했다.
  • 불필요한 컨텍스트를 정리하고 각 플로우별로 컨텍스트를 요약하면 컨텍스트 부패 문제를 완화할 수 있을 것으로 예상된다.
  • 스마트 컴팩트 기법을 도입하여 AI 모델이 효율적으로 코드베이스를 처리하도록 개선할 수 있다.

팩트 기법을 통한 AI 코드베이스 컨텍스트 최적화 전략

  • 팩트 기법은 리서치, 트레이닝, 인플멘테이션 세 단계로 나누어 각 단계별 요약 문서를 작성함으로써 컨텍스트 소모를 최적화한다.
  • 리서치 단계에서 코드베이스를 탐색한 후 탐색 결과를 바탕으로 요약 문서를 작성하고, 사용된 컨텍스트는 정리하여 다음 단계에서 요약 문서만 참고하도록 한다.

대규모 코드베이스에서 AI 컨텍스트 최적화 전략

  • 각 단계별 요약 문서 작성을 통해 AI의 컨텍스트 소모를 최적화할 수 있다.
  • 코드 탐색과 구현 과정을 동일한 컨텍스트 윈도우에서 진행하면 과도한 콘텐츠 소모가 발생한다.
  • 작업 흐름을 분리하고 요약 문서를 작성하면 구현 단계에서 불필요한 컨텍스트를 제거하고 효율적으로 작업할 수 있다.

AI 코드베이스 탐색 시 컨텍스트 오염 문제와 최적화 방안

  • 스트림 컴팩트 기법을 통해 컨텍스트 소모를 최적화할 수 있게 되었다.
  • 관련 없는 코드베이스가 탐색되어 컨텍스트에 적재될 경우 요약 문서의 정확성이 손상되는 컨텍스트 오염 문제가 발생한다.
  • AI가 대규모 코드베이스에서 관련성 없는 파일을 탐색하는 위험성이 여전히 존재하여 추가적인 최적화가 필요하다.

AI 코드 생성 시 요약 문서 오류로 인한 대규모 코드 결함 발생

  • 리치나 어플레이닝 단계에서 작성된 요약 문서의 오류는 최종적으로 수천 줄의 잘못된 코드 생성으로 이어질 수 있다.
  • 관련 없는 코드가 탐색되어 대규모 코드 결함이 발생하는 문제가 확인되었다.
  • 스마트 컴팩트 기법과 요약 플로우의 각 파이프라인 단계에서 인간의 개입과 노력이 필수적으로 필요하다.

AI 코드 분석 시 컨텍스트 최적화와 스마트 컴팩트 기법

  • 워크플로우 도입 과정에서 관련 없는 코드가 탐색되어 필요한 파일을 찾지 못하거나 잘못된 요약이 발생하는 문제가 확인되었다.
  • 이러한 문제를 해결하기 위해 인간이 매번 리뷰를 수행해야 하므로 상당한 인력 비용이 소모된다.
  • 스마트 컴팩트 기법은 각 단계별로 컨텍스트를 최적화하여 이러한 문제를 개선할 수 있다.

대규모 코드베이스에서 AI 컨텍스트 최적화 방안 검토

  • 요약 문서 방식은 컨텍스트 부패 문제로 인해 안전성이 보장되지 않았다.
  • 데이터베이스 기반 시맨틱 탐색은 탐색 속도를 증가시켰으며, 단계별 요약 문서 작성은 컨텍스트 송호 최적화에 효과적이었다.
  • 대규모 코드베이스에서 코드 스니펫 중복으로 인해 관련 없는 코드가 여전히 검색되는 문제가 발생한다.

AI 코드베이스 탐색 시 컨텍스트 부패 문제 분석

  • AI가 관련 없는 코드를 탐색하면서 컨텍스트 부패 문제가 발생하여 해결되지 못했다.
  • 단계별 요약 문서 작성 시 오염된 컨텍스트로 인해 요약 문서의 품질이 저하되는 문제가 확인되었다.
  • 텍스트 부패 문제를 방지하기 위해 오염되지 않는 탐색과 읽기 방식의 개선이 필요하다.

AI 친화적 코드베이스 구축을 위한 탐색 최적화 전략

  • AI 도구 사용 시 관련 없는 코드가 결과값에 포함되지 않도록 구조적 개선이 필요하다.
  • 탐색 친화적 코드베이스는 그랩(Grab)과 글로(Glow) 방식의 에이전트 탐색 도구 인터페이스를 활용하여 구현된다.

블록과 그랩 인터페이스의 경로 파라미터 최적화 전략

  • 블록과 그랩의 입력 인터페이스에는 패턴과 경로 같은 다양한 파라미터들이 존재하며, 경로 파라미터 활용 방안을 검토할 필요가 있다.
  • 플로드 코드 사용 시 경로 지정 없이 루트 탐색을 수행하면 관련 없는 파일들까지 탐색될 위험성이 높아진다.
  • 루트 탐색 시 불필요한 파일 탐색을 방지하기 위해 경로 파라미터를 명확하게 지정하는 것이 중요하다.

대규모 코드베이스에서 경로 기반 탐색 성능 최적화

  • 루트 탐색과 경로 기반 탐색의 성능을 비교한 결과 대규모 코드베이스에서 최대 73% 성능 감소를 확인했다.
  • 관련 없는 코드 탐색이 줄어들면서 혼란과 부패가 최소화되고 컨텍스트 도배 문제 해결이 가능해진다.
  • 경로 기반 탐색 도구의 효율을 높이기 위해 피처 기반 폴더링 구조 도입을 검토하고 있다.

코드베이스 폴더링 모델: 레이어드 베이스와 피처 베이스 비교

  • 코드베이스 폴더링 모델은 레이어드 베이스와 피처 베이스 두 가지로 나뉘며, 레이어드 베이스는 논리 구조 레이어 중심으로 폴더링되고 피처 베이스는 기능 도메인 중심으로 폴더링된다.
  • 레이어드 베이스에서 하나의 기능을 구현할 때 최소 3개 이상의 폴더 경로를 거쳐야 하는 문제가 발생한다.

피처 기반과 레이어드 기반 아키텍처의 경로 참조 차이

  • 피처 기반 아키텍처는 기능 구현 시 단일 참조 경로만 필요하지만, 레이어드 기반 아키텍처는 3개 이상의 경로를 참조해야 한다.
  • 레이어드 기반에서는 경로 지정 시 계층별 논리적 사고가 필요하며, 뷰 탐색은 프레젠테이션 계층에서, 비즈니스 로직 탐색은 도메인 계층에서 수행해야 한다.

레이어드 베이스와 피처 베이스의 경로 탐색 방식 비교

  • 논리적 사고가 필요한 상황에서 경로 탐색의 위험성이 높아지며, 레이어드 베이스는 경로에 많은 루트를 포함하는 경향을 보인다.
  • 피처 베이스는 이전에 전달된 피처를 기반으로 스코핑을 통해 더욱 집중된 경로 탐색을 수행한다.

AI 코드 분석 최적화를 통한 토큰 사용량 17% 감소

  • 피처 베이스 접근 방식을 적용하여 토큰 사용량을 17% 감소시켰으며, 이는 비용 최적화와 불필요한 파일 탐색 감소를 의미한다.
  • 피처 베이스 구조는 불필요한 파일 탐색 사례를 줄이고 컨텍스트 부패 문제로부터 안전성을 확보할 수 있게 한다.

AI 코드 컨텍스트 최적화를 위한 피처 기반 콜러링 벤치마크 테스트

  • 단순한 요구사항 30회와 복잡한 요구사항 30회로 구성된 벤치마크 테스트를 통해 피처 기반 콜러링 방식의 효율성을 검증했다.
  • 피처 기반 콜러링 방식은 불필요한 파일 읽기를 최소화하고 토큰 사용량을 최적화하여 혼란을 줄인다.
  • 토큰 사용 최적화로 인해 컨텍스트 부패 문제가 최소화되고 모델 성능 약화를 방지하며 기능 성공률이 향상된다.

AI 친화적 코드베이스 구축을 위한 적시 접근법 및 코드 수집 방식

  • 적시 접근법 방식의 코드 읽기 플로우 차트에서는 제비를 통해 충분한 수집 여부를 지속적으로 확인한다.
  • 오픈 셋과 리밋을 사용하여 코드를 수집하는 방식이 적용되며, 이는 구문 분석 없이 진행될 때 함수의 위치와 범위 파악에 어려움이 발생할 수 있다.

AI 컨텍스트 최적화를 위한 파일 구조 개선 전략

  • AI가 함수를 찾을 때 주변 코드와 전체 파일을 함께 탐색하면서 컨텍스트 파악이 어려워지고 오류 위험이 증가한다.
  • 파일 전체 코드가 수집되어도 손상되지 않는 파일 구조 설계가 필요하며, 약한 결합과 결함 문제를 방지하기 위해 적절한 파일 분리가 중요하다.

대규모 코드베이스에서 파일 책임 분리를 통한 효율성 개선

  • 파일 전체 조회 툴의 효율을 높이기 위해 당일 책임 파일 구조를 개선하는 방안을 검토하고 있다.
  • 중대규모 코드베이스에서는 유저 서비스 파일처럼 여러 구현체(유저 로컬 서비스, 유저 클라우드 서비스)가 하나의 파일에 통합되어 있는 상황이 발생한다.
  • 현재 구조에서는 인간의 편의에 의해 서로 다른 서비스 구현체들이 하나의 파일로 묶여 있어 코드 관리의 복잡성이 증가하고 있다.

사용자 서비스 파일 구조 최적화 및 책임별 분리 전략

  • 사용자 프라우드 서비스는 서로 독립적이고 의존하지 않는 클래스로 구성되어 있다.
  • 키친 보드에서 확인된 다수의 파일들을 책임별로 분리하면 5개 카테고리로 분류할 수 있다.
  • 사용자 로컬 서비스와 사용자 클라우드 서비스 파일을 분리하고, 각 함수를 익스텐션으로 나누어 파일 구조를 최적화할 수 있다.

단일 책임 원칙으로 코드 파일 분리 및 탐색 효율성 개선

  • 함수와 엔티티를 단일 책임 원칙에 따라 익스텐션으로 분리하면 최대 5개까지의 파일로 구성할 수 있다.
  • 파일별로 명확하게 책임을 분리하면 유저 서비스의 특정 함수 탐색 시 기존 플로그 코드 방식 대비 약 100~200줄의 탐색량을 줄일 수 있다.

AI 컨텍스트 오염 방지를 위한 코드 구조 분리 전략

  • 대규모 파일을 읽을 때 불필요한 관련 없는 함수까지 컨텍스트에 추가되어 컨텍스트 부패 위험이 증가한다.
  • 사용자 로컬 서비스 캐시 익스텐션을 분리하여 특정 파일만 읽도록 구조화하면 불필요한 코드가 컨텍스트에 적재되는 상황을 방지할 수 있다.

AI 컨텍스트 최적화를 위한 파일 분리 및 구조화 전략

  • 슈퍼파일 방식은 주변부 코드 스니펫 수집 시 약한 결합 문제와 불필요한 코드로 인한 컨텍스트 부패 문제를 야기한다.
  • 파일을 명확하게 분리하면 관련 없는 파일 수집을 방지하여 AI 모델의 컨텍스트 부패 문제를 해결할 수 있다.
  • 프로토콜과 구현체를 분리하는 구조화 방식을 통해 AI 친화적인 코드베이스를 구성할 수 있다.

프로토콜과 구현체 분리를 통한 AI 코드 이해도 향상

  • 프로토콜과 구현체를 같은 파일에 두면 AI가 구현 세부사항에 영향을 받아 약 97%의 약한 결합 상태가 발생한다.
  • 프로토콜을 명확하게 별도 파일로 분리하면 AI가 프로토콜만 읽고 구현체에 영향받지 않은 명확한 코드를 이해할 수 있다.
  • 약 30회의 벤치마크 테스트를 통해 파일 분리의 효과를 검증했다.

클로드 코드 개선을 위한 컨텍스트 최적화 기법

  • 클로드 컨텍스트 MCP를 활용하여 의미론적 탐색을 제공함으로써 더 빠른 탐색 속도를 구현했다.
  • 단계별 요약 문서 작성과 컨텍스트 압축 기법을 통해 컨텍스트를 최적화하는 워크플로우를 개선했다.
  • 코드 읽음을 통해 약한 결함이 방지되는 효과를 확인했다.

AI 친화적 코드베이스 구축을 위한 폴더링 및 리팩토링 전략

  • 피처 베이스 폴더링과 단일 책임 파일 분리를 통해 불필요한 코드가 AI 컨텍스트 창에 포함되는 것을 방지할 수 있다.
  • 레거시 코드의 리팩토링과 폴더링 구조 변경은 상당한 비용이 소요되며, 이러한 개선 작업에는 여전히 한계가 존재한다.

AI 친화적 코드베이스 구축을 위한 레거시 코드 개선 전략

  • 새로운 기능 개발 시에만 AI 친화적 코드 작성이 가능하며, 기존 레거시 코드는 즉시 변경하기 어려운 상황이다.
  • 코드베이스 차원의 문제 해결을 위해 MCP 2나 ASP 코드 분석 도구를 검토하고 있다.
  • 특정 파일의 함수를 정확하게 판단하고 탐색할 수 있는 메커니즘을 구축하기 위해 Codeium API나 Sourcery 소스 키트 같은 도구 활용을 검토 중이다.

AI 친화적 코드베이스 구축으로 개발 생산성 30% 향상

  • 코드베이스를 명확하게 읽을 수 있도록 개선하면 AI 활용도가 높아지지만, 개발팀의 공수가 클 수 있다.
  • 레거시 코드 개선에 시간을 투자하여 점진적으로 여러 방식을 적용한 결과, 개별 생산성이 최종적으로 30% 증가했다.

AI 친화적 코드베이스 구축을 위한 참고 자료 및 사례 분석

  • 팀에서 AI 친화적 코드베이스 개선이 실질적인 도움이 되었음을 확인했다.
  • USM을 활용한 이전 프로젝트 경험을 바탕으로 대규모 코드베이스를 가진 메가 iOS 소스를 참고하여 제안서를 작성했다.
  • 실제 상용 서비스의 코드 구조를 분석하여 구체적인 예시와 함께 개선 방안을 제시했다.

벤처 스위프트 발표 마무리 및 핵심 메시지 전달

  • 발표자는 "불꽃에서 별빛으로"라는 벤처 스위프트의 주제 키워드를 중심으로 자신의 여정을 공유했다.
  • 작은 불꽃 같은 개인의 인사이트가 모여 별빛이 되기를 바라는 메시지로 발표를 마무리했다.