AI 코딩 에이전트로 레거시 코드를 고칠 때 지켜야 할 원칙
2026年4月25日
0
컴퓨터/소프트웨어Comments (0)
Log in to leave a comment
No posts yet
Log in to leave a comment
No posts yet
에이전트가 내 컴퓨터를 휘젓고 다니게 두는 건 위험합니다. 특히 API 키를 환경 변수에 무방비로 방치하면 에이전트가 실수로 키를 로그에 찍거나 외부로 전송할 가능성이 있습니다. 1Password CLI를 쓰십시오. 명령을 실행할 때만 키를 메모리에 임시로 넣는 방식입니다.
에이전트가 실수로 핵심 파일을 건드리지 못하게 하려면 파일 시스템을 격리해야 합니다. .cursorignore 파일을 만들어 SSH 키, 빌드 결과물, 민감한 설정 파일을 아예 목록에서 지우십시오. 프로젝트 루트에 이 파일을 두는 것만으로도 에이전트가 엉뚱한 파일을 수정할 확률이 80퍼센트 줄어듭니다. 가급적 Docker 컨테이너 안에서 에이전트를 돌리십시오. 에이전트가 호스트 시스템을 직접 만지지 못하게 하는 가장 확실한 방법입니다.
에이전트에게 프로젝트 전체를 다 읽게 하면 매달 나가는 API 비용이 감당 안 됩니다. 특히 node_modules나 .git 폴더까지 에이전트가 읽는 건 돈을 버리는 짓입니다.
에이전트에게 필요한 코드만 넘기십시오. 프로젝트 규모가 커질수록 인덱싱 범위를 좁히는 게 필수입니다. Aider를 쓴다면 /tokens 명령어로 지금 얼마를 쓰고 있는지 실시간으로 확인하십시오. 작업이 끝난 파일은 /drop 명령으로 컨텍스트에서 바로 빼야 합니다. 이렇게만 해도 불필요한 토큰 소비를 70퍼센트 넘게 줄일 수 있습니다. Anthropic의 문맥 캐싱을 지원하는 모델을 고르면 반복되는 코드 구조에 대해 75퍼센트 정도 추가 할인을 받을 수 있으니 API 청구서를 확인하고 모델을 바꾸십시오.
레거시 코드는 의존성이 꼬여 있어서 에이전트에게 대충 맡기면 전체 시스템이 망가집니다. 무작정 코드를 짜라고 시키지 마십시오. 에이전트에게 XML 태그를 써서 맥락을 쥐여줘야 합니다. 어떤 함수를 고칠 건지, 지켜야 할 규칙은 무엇인지 명확히 적으십시오.
코드를 바로 머지하지 마십시오. 먼저 에이전트에게 수정 계획을 내놓으라고 강제하십시오. 개발자가 계획을 승인해야만 코드를 짜게 만드는 방식입니다. 에이전트가 수정한 코드는 반드시 로컬 테스트 환경에서 돌려보십시오. CI 실패 로그를 그대로 에이전트에게 다시 던져주면 스스로 버그를 고칩니다. 이 과정을 거치면 추가 개입 없이 84퍼센트의 확률로 오류를 잡을 수 있다는 연구 결과가 있습니다.
에이전트를 도입해서 얼마나 빨라졌는지 확인하고 싶다면 코드 작성 속도는 잊으십시오. 사이클 타임이 핵심입니다. 코드 작성, 리뷰, 수정, 배포까지 걸리는 전체 시간을 재야 합니다.
일단 현재 프로젝트의 첫 커밋부터 실제 배포까지 며칠이 걸리는지 기록하십시오. 에이전트가 반복해서 저지르는 실수는 AGENTS.md 파일에 정리해서 코딩 컨벤션으로 남겨야 합니다. AI가 짠 코드 품질이 유독 떨어지는 모듈이 있다면 그건 AI 탓이 아니라 시스템 구조의 문제입니다. 매주 PR당 리워크 비율을 확인하십시오. 도구는 도구일 뿐입니다. 에이전트를 동료로 대우하고 팀의 워크플로우에 맞춰 인프라를 조정하는 쪽이 개발팀 경쟁력을 결정합니다.