Phase 6: 검수/완성
미구현 기능 점검 및 구현, 코드 품질 점검 관련 명령어:
12-quality-check.md
6-0. kdyweb 컨트랙트 검증 (웹 프로젝트 우선)
웹 프로젝트의 경우, 아래 6-1~6-3 수동 점검 전에
/kdyweb --verify또는/kdyweb --verify grassroots를 먼저 실행하세요. kdyweb verify는 10가지 이슈 유형을 자동으로 감지하며, 결과가docs/references/_WEB_CONTRACT.md에 기록됩니다.
# 기본 연결성 검증 (6가지 이슈유형)
/kdyweb --verify
# 풀뿌리 검증 (10가지 이슈유형 — 고아 컴포넌트/스토어/API 포함)
/kdyweb --verify grassroots
kdyweb verify와 Phase 6 관계:
| kdyweb verify 영역 | Phase 6 해당 섹션 | 비고 |
|---|---|---|
| 고아 페이지/깨진 링크 | 6-1 모든 페이지 점검 | kdyweb이 자동 감지 |
| 미등록 페이지 | 6-3 미구현 기능 스캔 | kdyweb이 자동 감지 |
| 고아 컴포넌트/스토어/API | 6-3 미구현 기능 스캔 | 풀뿌리 모드에서 감지 |
| 레이아웃/리다이렉트 불일치 | 6-5 UI/UX 점검 | kdyweb이 자동 감지 |
kdyweb verify 완료 후 나머지 6-1 ~ 6-7을 수행하면, kdyweb이 이미 감지한 이슈는 건너뛸 수 있습니다.
6-1. 모든 페이지 미구현 점검
이 프로젝트의 모든 페이지 점검해줘.
1. 프로젝트 분석
- 모든 페이지/라우트 파악
- 각 페이지에서 언급하는 기능 목록 추출
2. 각 페이지별로 확인
- 페이지에서 언급하는 내용들이 실제로 서비스 가능한지 확인
- UI만 있고 백엔드 연결 안 된 것
- 버튼/링크만 있고 기능 없는 것
- 더미 데이터로 되어있는 것
3. 미구현 항목에 대해
- 구체적인 연구와 조사
- 이 프로젝트에 적용 가능한 방법 제안
- 구현
분석 결과 먼저 알려줘.
6-2. 특정 페이지 구현 점검
[페이지명/경로] 페이지 점검해줘.
1. 이 페이지에서 언급하는 모든 기능 목록 추출
2. 각 기능이 실제로 서비스 가능한지 확인
3. 미구현 항목에 대해
- 웹검색 및 연구로 구현 방법 조사
- 이 프로젝트에 적용 가능한지 확인
- 구현 진행
분석 결과 먼저 알려줘.
6-3. 미구현 기능 일괄 구현
미구현 기능들 전부 구현해줘.
1. 전체 프로젝트 스캔해서 미구현 항목 파악
- UI만 있고 기능 없는 것
- 더미 데이터 사용 중인 것
- 링크/버튼 동작 안 하는 것
- TODO/FIXME 주석 있는 것
2. 각 항목에 대해
- 필요시 웹검색으로 구현 방법 연구
- 프로젝트 구조에 맞게 구현
- 기존 코드 스타일 유지
분석 결과 먼저 알려주고, 하나씩 진행해줘.
6-4. React 성능 점검
이 프로젝트 React 성능 점검해줘.
~/dev-templates/rules/react-best-practices/SKILL.md 읽고
우선순위 순서대로 체크해줘:
1. CRITICAL: Eliminating Waterfalls (async-*)
2. CRITICAL: Bundle Size Optimization (bundle-*)
3. HIGH: Server-Side Performance (server-*)
4. MEDIUM-HIGH: Client-Side Data Fetching (client-*)
5. MEDIUM: Re-render Optimization (rerender-*)
각 카테고리에서 해당하는 이슈 찾아서 정리해줘.
6-5. UI/UX 점검
이 프로젝트 UI/UX 점검해줘.
~/dev-templates/rules/web-design-guidelines/SKILL.md 읽고
아래 카테고리 순서대로 체크해줘:
1. 접근성 (aria-labels, semantic HTML, 키보드)
2. 폼 (autocomplete, validation, 에러 처리)
3. 포커스 상태 (visible focus, focus-visible)
4. 애니메이션 (prefers-reduced-motion)
5. 다크모드 (color-scheme, theme-color)
각 카테고리에서 이슈 찾아서 정리해줘.
6-6. 정제 프로세스 전체 점검
이 프로젝트 정제 상태 요약해줘.
docs/rules/refining-process.md 읽고
전체 정제 프로세스 진행 상황 분석해줘:
1. 1차 정제 (구조) 상태
- 파일 크기, 미구현 정리, 타입 정리, Import 정리
2. 2차 정제 (품질) 상태
- React 품질, 에러 처리, UI 상태, 주석 정리
3. 최종 정제 (성능/보안) 상태
- 보안 점검, 성능 최적화, 정리, 환경 분리
각 단계별 완료/미완료 항목과 전체 진행률 알려줘.
6-7. 보안 점검
이 프로젝트 보안 점검해줘.
docs/rules/security-check.md 읽고
CRITICAL → HIGH → MEDIUM 순서로 체크해줘:
CRITICAL (배포 차단):
- 인증 우회 가능 여부
- 인가 우회 가능 여부
- 환경 변수 노출 여부
- SQL 인젝션 취약점
- XSS 취약점
HIGH (배포 전 수정):
- 입력 검증 부재
- 민감 정보 로깅
- CORS 설정 미흡
각 항목에서 취약점 발견 시:
- 파일:라인 위치
- 현재 코드
- 수정 방법
CRITICAL 이슈 있으면 배포 불가 알려줘.
보안 점검 출력 예시:
📋 보안 점검 결과
🔴 CRITICAL (배포 차단)
1. 인증 우회 가능
- 파일: src/app/api/admin/route.ts:15
- 현재: 인증 미들웨어 없음
- 수정: withAuth 래퍼 추가
🟠 HIGH (배포 전 수정)
1. 입력 검증 부재
- 파일: src/app/api/users/route.ts:23
- 현재: req.body 직접 사용
- 수정: zod 스키마 검증 추가
📊 요약
- CRITICAL: 1개 (배포 불가)
- HIGH: 1개
⚠️ CRITICAL 이슈 해결 필수
수정 진행할까요?
📋 미구현 점검 출력 예시
📋 페이지별 구현 현황 분석
| 페이지 | 언급 기능 | 구현 상태 | 비고 |
|-------|----------|----------|-----|
| /home | 히어로, 특징 소개 | ✅ 완료 | - |
| /pricing | 결제 기능 | ❌ 미구현 | UI만 있음 |
| /dashboard | 데이터 시각화 | ⚠️ 부분 | 더미 데이터 |
| /settings | 알림 설정 | ❌ 미구현 | 버튼만 있음 |
📋 미구현 항목 상세
1. /pricing - 결제 기능
- 현재: UI만 있음, 버튼 클릭 시 동작 없음
- 필요: 결제 시스템 연동
- 제안: Stripe 연동 (웹검색으로 조사 필요)
2. /dashboard - 데이터 시각화
- 현재: 더미 데이터로 표시
- 필요: 실제 DB 연결
- 제안: 기존 API 엔드포인트 연결
어떤 항목부터 진행할까요?
(또는 전체 순차 진행)
📋 미구현 전체 스캔 출력 예시
📋 미구현 항목 전체 스캔 결과
1. UI만 있는 기능 (백엔드 연결 필요)
- [ ] /pricing 결제 버튼
- [ ] /contact 문의 폼 제출
- [ ] /settings 알림 토글
2. 더미 데이터 사용 중
- [ ] /dashboard 차트 데이터
- [ ] /users 사용자 목록
3. 링크/버튼 미연결
- [ ] Footer 소셜 링크
- [ ] 헤더 알림 아이콘
4. TODO/FIXME 주석
- [ ] src/lib/api.ts:42 - TODO: 에러 핸들링
- [ ] src/components/Card.tsx:15 - FIXME: 반응형
총 12개 항목
우선순위 제안:
1순위: 핵심 기능 (결제, 폼 제출)
2순위: 데이터 연결 (차트, 목록)
3순위: 부가 기능 (소셜 링크, 알림)
이 순서대로 진행할까요?