AI 에이전트 레거시는 코드를 못 짜서 생기는 문제가 아닙니다. 오히려 너무 빠르게, 너무 많이 만들 수 있기 때문에 생기는 문제입니다.

이 글에서는 AI 에이전트로 코딩할 때 실험 코드와 운영 코드를 구분하고, 나중에 지울 수 있는 구조를 만드는 방법을 정리합니다.

한 줄 요약

AI 에이전트는 생성 속도를 높여주지만, 삭제와 유지보수 기준이 없으면 레거시도 같은 속도로 쌓입니다.

왜 AI 에이전트 레거시가 생기나

AI 에이전트는 요청을 빠르게 구현합니다. 버튼, API, 스크립트, 크론, 관리자 페이지가 금방 생깁니다.

문제는 이 코드가 왜 생겼고 언제 지워야 하는지 기록되지 않는 경우입니다. 돌아가는 코드가 곧 좋은 코드는 아닙니다.

실험 코드와 운영 코드 분리

AI에게 일을 맡길 때 먼저 구분해야 합니다.

• 실험: 하루 안에 버릴 수 있는 코드
• 임시 자동화: 특정 작업을 한 번 처리하기 위한 코드
• 운영 코드: 계속 사용자에게 영향을 주는 코드
• 인프라 코드: 실패 시 서비스에 영향을 주는 코드

운영 코드에는 테스트, 로그, rollback 기준이 있어야 합니다.

삭제 가능한 코드의 조건

• 파일 상단에 목적이 명확하다
• 입력과 출력이 작다
• 외부 부작용이 제한되어 있다
• 실패 시 복구 방법이 있다
• 사용 여부를 확인할 로그가 있다
• 제거해도 되는 날짜 또는 조건이 있다

AI 코딩 리뷰 체크리스트

• 이 코드는 왜 필요한가
• 기존 코드로 해결할 수 없었는가
• 새 의존성이 생겼는가
• 실패하면 누가 알 수 있는가
• 삭제 기준이 있는가
• 테스트 없이 수정해도 되는가

정리

AI 에이전트를 쓰면 구현은 빨라집니다. 하지만 구현 속도만큼 삭제 기준도 빨라져야 합니다.

좋은 AI 코딩은 많이 만드는 것이 아니라, 나중에 지울 수 있게 만드는 것입니다.