AI 네이티브 개발 원칙
AI로 누구나 동작하는 코드를 만들 수 있게 됐습니다. 개발자도 코드 대부분을 AI와 함께 씁니다.
반면 AI가 만든 결과를 검토하고 보증하는 단계는 자주 비어 있습니다. 사람이 확인 레이어가 되어야 하는데, 제대로 보지 않고 승인한 코드가 그대로 배포되는 경우를 많이 봤습니다.
그래서 개발자의 역할은 무엇을 만들지, 어떤 기술로 만들지, 결과를 어떻게 보증할지 판단하는 일이라고 생각합니다.
- 01
AI가 만든 결과는 사람이 검토하고 보증한다
코드는 AI가 써도 장애의 책임은 사람에게 있습니다.
검토가 사람의 주의력에만 기대지 않도록 통과 기준을 테스트와 자동 검증으로 정해 둡니다.
이렇게 합니다
- 테스트와 실제 실행으로 동작을 확인한 뒤 머지합니다.
- 코드 컨벤션과 리뷰 체크리스트를 자동 검증으로 만듭니다.
- AI가 제시한 수치와 근거는 출처를 직접 확인합니다.
적용한 곳
- 셀타스퀘어TDD와 AI 자동화로 프로젝트 전체 테스트 커버리지 100%를 유지하고, Claude Skill로 코드 컨벤션 자동 검증을 팀에 도입했습니다.
- 02
기술은 목적과 근거를 갖고 고른다
AI가 제안하는 설계는 문제 규모와 상관없이 그럴듯합니다. 그대로 따르면 지금 필요 없는 구성 요소가 늘어납니다.
오버엔지니어링은 아닌지, 서비스 규모와 용도, 비용에 맞는지를 기준으로 고릅니다.
- 03
기술부채는 의도적으로 만들고, 해소 시점을 정해 둔다
- 04
지금 하지 않을 일부터 정한다
- 05
데모와 프로덕션은 기준이 다르다
화면에서 동작하는 기능은 AI로 금방 만들 수 있습니다. 운영 환경에서는 결제 중복과 장애 시 데이터 보존까지 고려해야 합니다.
프로덕션에 가까울수록 되돌리기 어려운 부분부터 검토합니다.
- 06
반복되는 AI 작업은 스킬, 훅, 커맨드로 묶는다
같은 작업을 매번 프롬프트로 지시하면 결과도 매번 달라집니다.
반복 작업은 스킬, 훅, 커맨드로 만들어 체이닝하고, 누가 실행해도 같은 절차와 검증을 거치게 합니다.
이렇게 합니다
- 반복 작업은 스킬로 만들어 같은 절차로 실행합니다.
- 빠뜨리면 안 되는 검증은 훅으로 강제합니다.
- 에이전트를 병렬로 돌릴 때는 작업 범위가 겹치지 않게 나누고 결과는 한 곳에서 검증합니다.
적용한 곳
- 셀타스퀘어Claude Skill로 코드 컨벤션 자동 검증, AI 기반 PR 자동 생성, 기획서 엣지케이스 검증기를 팀 워크플로에 도입했습니다.
- 독박스기능 폴더 하나는 에이전트 하나만 고치는 규칙으로 iOS와 Android 작업을 병렬로 진행했습니다. 첫 커밋부터 1.1.1 버전까지 8일이 걸렸습니다.