AI 코드를 프로덕션에 그대로 복사해 넣는 것을 멈추세요

당신은 Claude에게 React 컴포넌트를 작성해 달라고 요청했습니다. Claude는 47줄의 JSX를 제공했습니다. 당신은 그것을 복사하여 붙여넣고(copy-paste), 푸시(push)했습니다. 이제 당신의 PR(Pull Request) 리뷰어들은 5개의 질문을 던지고 있고, 테스트 커버리지(test coverage)는 12% 하락했습니다.

문제는 이것입니다: AI 어시스턴트는 '작동하는' 코드를 생성할 뿐, '적합한' 코드를 생성하지는 않습니다. "오류 없이 실행되는 것"과 "프로덕션(production)에 배포되는 것" 사이에는 간극이 존재합니다.

진짜 문제

AI 어시스턴트에게 요청을 전달할 때, AI는 다음과 같은 맥락(context)을 전혀 알지 못합니다:

• 당신의 코드베이스 컨벤션 (naming, 파일 구조, 테스트 패턴)
• 당신의 기술 부채 (tech debt, AI가 조화롭게 작동해야 하는 레거시 시스템)
• 당신 팀의 표준 (탭 vs 스페이스? 농담입니다... 거의 말이죠)
• 성능 제약 조건 또는 당신의 앱에 특화된 엣지 케이스 (edge cases)

따라서 AI는 당신에게 버터 나이프(butter knife)가 필요한 상황에서 맥가이버 칼(Swiss Army knife) 같은 코드를 생성합니다.

실제로 효과가 있는 프레임워크

저는 동일한 코드 리뷰 코멘트가 반복되는 것을 목격한 후 다음과 같은 방식을 시작했습니다:

1. 스캐폴딩(scaffolding)이 아닌 핵심 로직을 복사하세요

AI는 전체를 제공합니다. 알고리즘이나 비즈니스 로직—실제로 똑똑한 부분—만 가져오고 래퍼(wrapper)는 남겨두세요.

// AI가 생성한 코드 (이걸 전부 복사하지 마세요):
export function calculateRecommendations(items) {
  return items
...

2. 붙여넣기 '전에' AI에게 질문하세요

"X를 수행하는 함수를 작성해줘"라고 말하는 대신, "X를 위한 핵심 로직을 작성해줘" 또는 "보일러플레이트(boilerplate) 없이 X를 위한 알고리즘을 보여줘"라고 요청하세요.

더 나은 방법: "내가 가지고 있지 않은 임포트(imports)를 사용하지 않고, 내 기술 스택에서 Y를 처리하는 가장 깔끔한 방법을 제안해줘."

3. 로직을 먼저 격리된 상태에서 테스트하세요

아직 당신의 컴포넌트나 서비스에 통합하지 마세요. 테스트 파일에 던져 넣으세요. 이것저것 만져보세요. 의도적으로 망가뜨려 보세요. 입력값이 이상할 때 어떤 일이 일어나는지 확인하세요.

// 실제 코드에 닿기 전에:
describe('calculateRecommendations', () => {
  it('빈 배열을 처리함', () => {
...

4. PR 하나당 함수 하나면 충분합니다

만약 AI가 8개의 함수가 포함된 200줄짜리 유틸리티 파일을 생성했다면, 하나만 추출하세요. 테스트하세요. 배포하세요. 반복하세요.

여러분의 PR (Pull Request)은 리뷰어가 "이게 우리 방식인가요?"라고 묻는 대신, 오직 "이게 문제를 해결하나요?"라고만 물을 수 있을 정도로 충분히 지루해야 합니다.

5. 선택권이 있다면 직접 타이핑하세요

AI가 생성한 TypeScript는 때때로 느슨한 타입 (loose types)을 가집니다. 30초만 투자해서 타입을 엄격하게 만드세요. 미래의 당신(그리고 당신의 팀)이 이를 고마워할 것입니다.

// 취약함:
function format(data: any): any {
  return JSON.stringify(data);
...

이것이 실제로 얻을 수 있는 것

• 더 빠른 리뷰 — 여러분의 패턴에 맞는 코드는 더 빠르게 승인됩니다.
• 재작업 감소 — 2주 후에 AI가 만든 상용구 코드 (boilerplate)를 다시 작성하는 일이 없어집니다.
• 팀의 정신 건강 — 코드베이스가 AI가 작성한 누더기 (patchwork)가 되는 대신 일관성을 유지합니다.
• 학습 — 단순히 "AI가 이렇게 하라고 했어"가 아니라, 여러분이 무엇을 배포했는지 실제로 이해하게 됩니다.

시간 계산

네, AI 코드를 그대로 붙여넣는 대신 수정하는 데 5분이 더 걸릴 수 있습니다. 하지만 여러분은 나중에 발생할 45분의 코드 리뷰 의견 교환과 20분의 테스트 실패 시간을 아끼는 것입니다.

지금 5분을 투자하세요.

한 가지 더

여러분의 PR이 고마워할 것입니다. 리뷰어들이 고마워할 것입니다. 무엇보다, 금요일 밤 9시에 AI가 만든 구조물 (scaffolding)을 풀어헤치지 않아도 될 때, 미래의 당신이 고마워할 것입니다.