VIBE CODING REVIEW CHECKLIST
바이브코딩 결과물
운영 전 검수 체크리스트
AI 도구로 화면과 기능을 만드는 것과 실제 사용자의 데이터를 안전하게 다루며 운영하는 것은 다른 단계입니다. 배포 전에는 실행 가능성, 권한, 데이터, 복구와 인계 상태를 함께 확인해야 합니다.
BEFORE REVIEW
검수를 시작하기 전에 필요한 자료
- 현재 운영 또는 개발 중인 소스 저장소
- 실행 방법과 사용 중인 개발 도구
- 운영 주소와 재현 가능한 오류 설명
- 배포·도메인·외부 서비스 접근 권한
- 핵심 사용자 흐름과 역할 구분
- 수정해야 할 문제와 원하는 완료 상태
CHECKLIST
운영 가능성을 판단하는 8가지 영역
검수 결과는 문제 유무만 나열하지 않고 배포 전 수정, 운영 초기 보완과 추후 개선으로 우선순위를 나누는 것이 중요합니다.
저장소와 실행 환경
다른 개발자도 같은 코드를 받아 현재 상태를 재현할 수 있는가?
- 실제로 운영 중인 코드와 저장소의 기본 브랜치가 일치하는지 확인합니다.
- 패키지 잠금 파일과 실행 명령이 있고 새 환경에서 설치와 빌드가 되는지 확인합니다.
- 필요한 환경변수의 이름과 용도는 문서화하되 실제 비밀값은 저장소에서 분리합니다.
- 개발·검수·운영 환경의 차이와 외부 서비스 연결 조건을 확인합니다.
비밀정보와 환경설정
API 키와 운영 설정이 코드나 사용자 화면에 노출되지 않는가?
- 소스 코드와 커밋 기록에 API 키, 비밀번호와 접근 토큰이 포함됐는지 확인합니다.
- 브라우저에 전달되는 설정과 서버에서만 사용해야 하는 비밀값을 구분합니다.
- 개발용 키와 운영용 키가 분리되어 있고 불필요한 권한이 부여되지 않았는지 확인합니다.
- 노출 가능성이 있는 비밀값은 삭제만 하지 않고 해당 서비스에서 폐기·재발급해야 합니다.
로그인과 세션
로그인한 사용자를 서버에서도 올바르게 확인하는가?
- 로그인·로그아웃과 세션 만료가 의도한 방식으로 동작하는지 확인합니다.
- 로그인 화면을 통과했다는 사실만으로 서버 기능을 사용할 수 없도록 확인합니다.
- 관리자 기능과 일반 사용자 기능이 역할에 따라 분리되는지 확인합니다.
- 인증 실패와 만료 상황에서 민감한 내부 정보 없이 안전하게 안내하는지 확인합니다.
권한과 데이터 접근
주소나 요청값을 바꿔 다른 사람의 데이터에 접근할 수 없는가?
- 화면에서 버튼을 숨기는 것과 별개로 서버가 사용자·역할·소유권을 확인하는지 살펴봅니다.
- 사용자나 문서 식별자를 바꿨을 때 다른 사용자의 정보를 조회·수정할 수 없는지 확인합니다.
- 관리자 전용 조회, 수정과 삭제 기능에 별도 권한 검사가 있는지 확인합니다.
- 목록·검색·내보내기 기능이 필요 이상으로 많은 개인정보를 반환하지 않는지 확인합니다.
입력값과 오류 처리
예상하지 못한 입력과 실패 상황에서도 안전하게 동작하는가?
- 필수값, 길이, 형식과 허용 범위를 브라우저뿐 아니라 서버에서도 검사하는지 확인합니다.
- 중복 제출, 잘못된 파일과 비정상적인 요청을 제한하는지 확인합니다.
- 오류 화면과 응답에 내부 경로, 데이터베이스 정보와 비밀값이 노출되지 않는지 확인합니다.
- 오류를 숨기지 않으면서도 개인정보를 남기지 않는 운영 로그가 있는지 확인합니다.
의존성과 외부 서비스
사용 중인 도구와 외부 연결을 운영자가 파악하고 있는가?
- 사용하지 않는 패키지와 출처가 불분명한 코드를 구분하고 제거 필요성을 확인합니다.
- 알려진 보안 문제가 있는 의존성과 업데이트 시 영향 범위를 확인합니다.
- 결제, 이메일, 저장소, AI API 등 외부 서비스의 실패 시 동작을 확인합니다.
- 외부 계정의 소유자, 결제 주체, 권한과 서비스 중단 시 대체 방법을 문서화합니다.
테스트와 배포
수정 사항을 검증하고 문제가 생기면 이전 상태로 돌아갈 수 있는가?
- 코드 검사, 타입 검사와 프로덕션 빌드가 오류 없이 끝나는지 확인합니다.
- 로그인, 저장, 수정, 삭제 등 핵심 사용자 흐름을 운영과 유사한 환경에서 확인합니다.
- 도메인, HTTPS, 환경변수와 배포 시작 명령이 운영 환경에 맞는지 확인합니다.
- 배포 실패나 주요 오류가 발생했을 때 이전 버전으로 복구할 방법을 확인합니다.
운영 인계
제작자가 없어도 운영 주체가 서비스를 이해하고 관리할 수 있는가?
- 소스 저장소와 배포·도메인·외부 서비스 계정의 소유권과 권한을 정리합니다.
- 실행, 배포, 환경변수, 주요 기능과 장애 확인 방법을 운영 문서에 남깁니다.
- 데이터 백업과 복구가 필요한 서비스라면 담당자와 실행 절차를 확인합니다.
- 인계 이후 직접 운영, 공동 유지보수와 전담 유지보수 중 책임 범위를 합의합니다.
PRIORITY
검수 결과는 우선순위로 나눕니다
모든 문제를 한 번에 고치겠다고 약속하기보다 사용자와 운영에 미치는 영향을 기준으로 범위를 합의합니다.
배포 전 수정
인증·권한 오류, 민감정보 노출, 실행·배포 실패처럼 운영 시작 전에 해결해야 할 항목입니다.
운영 초기 보완
즉시 배포를 막지는 않지만 오류 대응, 로그, 테스트와 문서 보강이 필요한 항목입니다.
추후 개선
구조 정리, 성능 개선과 편의 기능처럼 운영 데이터와 우선순위를 확인해 단계적으로 진행할 항목입니다.
LIMITS
기본 검수와 전문 보안 진단은 다릅니다
NXLAB의 기본 검수는 프로젝트 범위에 맞춰 코드, 인증, 권한, 입력값, 데이터와 비밀정보 노출, 배포 상태를 개발자가 확인하는 작업입니다.
침투 테스트, 보안 인증과 금융·의료 등 규제 검토를 대체하지 않습니다. 고위험 서비스나 별도 인증이 필요한 프로젝트는 전문 업체 검토 범위를 따로 정해야 합니다.