코드 품질 기준 및 완료 검증 프로세스. 코드 작성 완료 시, "다 됐어?", "완료됐나", "테스트 돌려봐", "빌드 확인", 작업 완료 주장 전 자동 활성화. 품질 체크리스트와 검증 명령어 제공.
[ ] 모든 import/include/using 문 포함
[ ] 타입 정의 포함 (구조체, 열거형 등)
[ ] 필수 설정 파일 언급 또는 제공
[ ] 환경 변수/설정 요구사항 명시
[ ] 의존성 버전 명시 (프로젝트의 의존성 관리 파일)
[ ] 빌드/실행 명령어 제공
[ ] 예상 출력/결과 언급
[ ] 에러 처리 (언어별 관용구)
[ ] null/nil/nullptr 체크
[ ] 배열/슬라이스/버퍼 경계 검사
[ ] 입력 검증 (타입, 범위, 형식)
[ ] 타임아웃 설정 (네트워크/I/O 작업 시)
| 기준 | 1 | 3 |
|---|
| 5 |
|---|
| 기능성 | 주요 기능 미동작 | 핵심 기능 동작, 에지케이스 누락 | 모든 요구사항 충족 |
| 코드 품질 | 기존 패턴 불일치, 중복 다수 | 패턴 일관, 일부 개선 여지 | 깔끔하고 관용적 |
| 테스트 | 테스트 없음 | 주요 경로 커버 | 경계값/에러 포함 |
| 보안 | 취약점 존재 | 기본 검증 포함 | 체계적 방어 |
"증거 없이 완료를 주장하지 말 것"
| 단계 | 행동 | 확인 |
|---|---|---|
| 1. 식별 | 주장을 증명할 명령어 파악 | [ ] |
| 2. 실행 | 해당 명령어 실행 (새로 실행) | [ ] |
| 3. 읽기 | 전체 출력 + 종료 코드 확인 | [ ] |
| 4. 검증 | 출력이 주장을 뒷받침하는지 확인 | [ ] |
| 5. 주장 | 증거와 함께만 주장 | [ ] |
다음 표현 사용 시 검증 미완료:
| 주장 | 검증 명령어 |
|---|---|
| 테스트 통과 | npm test, pytest, go test |
| 빌드 성공 | npm run build, cargo build |
| 린트 정상 | eslint ., golangci-lint run |
| 타입 체크 | tsc --noEmit, mypy . |
코드 작성 완료 시:
[ ] 완전성 7/7 충족?
[ ] 안정성 5/5 충족?
[ ] 품질 점수 모든 기준 3 이상?
[ ] 테스트 실행하고 결과 확인?
[ ] 빌드 실행하고 결과 확인?
[ ] 증거와 함께 완료 주장?
코드 리뷰 체크리스트는 review 스킬 참조.