AI 요약
프리랜서 엔지니어 유키가 Claude Code 등 AI 코딩 도구에 개발을 전면 위임하는 현장의 위험성을 경고하는 글이다. 초기 2주는 생산성이 폭발적으로 오르지만, 1개월쯤 지나면 파일마다 API 응답 형식·에러 처리·명명 규칙이 제각각이 되는 증상이 나타나고, 2개월 후에는 새 기능 하나 추가할 때마다 다른 기능이 연쇄적으로 깨지는 지옥이 시작된다. 저자는 원인이 AI가 아니라 "판단까지 AI에 맡긴 엔지니어"라고 지적하며, 디렉터리 구조·API 설계·DB 설계 같은 전체 판단은 사람이 하고, 테스트 코드 작성·기존 패턴 구현·리팩터링 실행은 AI에 맡기라는 원칙을 제시한다.
핵심 포인트
- AI 위임 후 1개월경 파일별 응답 형식·에러 처리·명명 규칙 불일치, 중복 함수 3~4개 발생
- 2개월 후 신기능 추가 시 연쇄 장애로 릴리스 지연, 복구에 수주~수개월 소요
- AI에 위임하면 안 되는 것: 디렉터리 구조, 신기능 배치, API 설계, 응답 형식, DB 테이블·관계 설계
- AI에 맡겨도 되는 것: 테스트 코드 작성, 기존 패턴 준수 구현, 리팩터링 실행
- 핵심 원칙: "판단은 사람이, 손은 AI가" — AI에 던지기 전 5분간 스스로 설계 메모
향후 전망
- AI 코딩 도구 도입 현장의 약 90%가 1~2개월 내 기술 부채 지옥에 도달할 것으로 저자는 전망
- CLAUDE.md·ADR 등 설계 근거 문서화와 사전 설계 습관이 AI 활용 생산성의 관건이 될 전망
출처:note (유키)
