AI 코딩 5가지 원칙: 구글 출신 시니어 개발자가 말하는 더 빠르고 안전하게 개발하는 법

핵심 메시지

• AI 코딩의 성패는 어떤 도구를 쓰느냐가 아니라 몇 가지 기본기를 지키느냐에 달려 있다.
• 먼저 무엇을 만들지 명확히 이해해야 한다. AI는 모호한 요구를 '빠르게 잘못된 것'으로 만들어 준다.
• 규칙·메모리 파일에 기술 스택과 이미 배제한 안티패턴을 담아 매번 같은 대화를 반복하지 않는다.
• 한 번의 생성 단위를 작게 쪼개(blast radius 축소) 2분 안에 검증 가능한 작업만 맡긴다.
• 테스트 우선 개발로 피드백 루프를 만들고, 되돌리기 어려운 아키텍처 판단은 사람이 쥐고 있어야 한다.

쉽게 이해하기

Maddy Zhang은 구글·아마존·IBM·마이크로소프트를 거친 시니어 소프트웨어 엔지니어로, AI로 진짜 가치를 얻는 개발자와 평범한 코드만 잔뜩 생성하는 개발자의 차이는 도구가 아니라 몇 가지 원칙에 있다고 말한다. 그가 제시하는 다섯 원칙은 속도뿐 아니라 더 깨끗하고 안전하며 유지보수하기 쉬운 코드를 만드는 데 초점을 둔다.

첫째, AI는 무엇보다 '생각의 명확함'에 보상한다. 무엇을 만드는지 스스로 이해하지 못하면 아무리 영리한 프롬프트도 소용없고, AI는 잘못된 것을 자신 있게 더 빨리 만들어 준다. 그는 AI를 '제품 맥락이 없는 아주 빠른 외주 개발자'에 비유한다. 원하는 바를 한두 문장으로 설명하지 못하면 아직 요청할 준비가 안 된 것이라는 게 그의 개인 규칙이다.

둘째, 중복 없는 컨텍스트를 쓴다. 잘 쓰는 개발자는 매 세션을 처음부터 시작하지 않고, 규칙 파일이나 메모리에 기술 스택과 버전, 명명 규칙, 표준 패턴을 담아둔다. 특히 이미 시도했다가 배제한 안티패턴과 그 이유를 적어두면 AI가 과거의 실수를 다시 발견하는 일을 막을 수 있다.

셋째, 작업 범위(blast radius)를 줄인다. AI 코딩의 오류는 작업 크기에 따라 단순 증가가 아니라 복리로 커진다. 초반의 작은 가정 하나가 이후 결정들을 왜곡해, 겉보기엔 깔끔하지만 특정 엣지 케이스에서 프로덕션에서 터지는 코드를 만든다. 그래서 '기능을 만들어줘' 대신 입력·반환·테스트 케이스를 명시해 2분 안에 검증 가능한 단위로 쪼개 맡긴다.

넷째, 피드백 루프 없이 생성하지 않는다. 그는 테스트 우선 개발(TDD)을 권하는데, 이는 방법론 자체가 신성해서가 아니라 AI가 빈칸을 채우기 전에 객관적 신호를 만들어 주기 때문이다. 다섯째, 아키텍처 판단을 지킨다. 보일러플레이트·문서·리팩터링은 넘겨도 되지만, 핵심 비즈니스 로직·데이터 모델·API 계약·보안 민감 영역처럼 되돌리기 어려운 결정은 사람이 운전대를 쥐고 있어야 한다.

주요 인사이트

• AI 코딩의 차이는 도구가 아니라 기본기에서 갈린다. 명확한 사고 없이 던진 프롬프트는 '잘못된 것을 빠르게' 만들어낼 뿐이다.
• 컨텍스트 파일에 '배제한 안티패턴과 그 이유'까지 적어두는 것이 핵심이다. 그러지 않으면 AI가 팀이 이미 폐기한 접근을 계속 되살린다.
• AI 코드의 버그는 표면적으로는 그럴듯해 보이지만 off-by-one·null 처리·경쟁 상태처럼 미묘해서 수동 리뷰로 잡기 어렵다. 그래서 테스트가 더 중요해진다.
• 앞으로 가장 가치 있는 엔지니어는 프롬프트를 가장 빨리 쓰는 사람이 아니라, 시스템을 명확히 사고하고 좋은 아키텍처 판단을 내리며 AI를 실행에 활용하는 사람이다.
• AI에게 넘길 일과 사람이 쥘 일을 나누는 '위임 필터'를 갖는 것이 human-in-the-loop 개발의 실천법이다.

자주 묻는 질문

관련 AI 소식