안티패턴 스킬 — 진짜 코드를 출시하세요, 장식품이 아닙니다
이 스킬은 소프트웨어가 미완성되거나 비전문적으로 보이게 만드는 가장 흔한 안티패턴을 감지하고 방지합니다.
금지된 안티패턴 (무관용)
UI/UX 안티패턴
❌ 금지:
- "Coming Soon"(준비 중) 섹션 또는 레이블
- 기능하지 않는 버튼 (동작하거나 제거되어야 함)
- 아무 곳에도 제출되지 않는 폼
- 프로덕션 컴포넌트의 하드코딩된 가짜 데이터
- 동적인 척하는 정적 테이블
- 아무 곳으로도 이동하지 않는 링크 (href="#")
- "공사 중" 배너
- 영구적으로 false로 설정된 기능 플래그
- 명확한 설명 없이 비활성화된 입력
- 도움이 되는 메시지 없는 빈 상태
- 실제로 페이지네이션하지 않는 페이지네이션
- 실제로 검색하지 않는 검색 바
- 동일한 결과를 반환하는 필터
- 사용자가 "웹사이트"를 요청했을 때의 단일 랜딩 페이지 (반드시 다중 페이지여야 함)
- CSS를 작성하기 전에 정의된 색상 팔레트 없음
- 문서화된 디자인 시스템 없는 임의의 헥스 색상
- 페이지 전체에 걸친 일관성 없는 색상 (다른 파란색, 다른 간격)
- 웹사이트 어디에서든 이모지 사용 (Lucide/Heroicons/Phosphor의 SVG 아이콘 사용)
- 서로 닿아 있는 섹션 (콘텐츠 블록 사이에 간격 없음)
- 위 콘텐츠에 바로 붙어 있는 푸터 (숨 쉴 공간 없음)
- 7개 이상의 최상위 항목이 있는 탐색 (복잡하고 압도적임)
- 개별 상세 페이지가 없는 서비스 페이지 (/services만 있고 /services/web-design 없음)
- 개별 상세 페이지가 없는 제품 페이지 (/products만 있고 /products/[slug] 없음)
- 일반적인 서비스 설명 (서비스당 2-3줄로는 충분하지 않음)
✅ 필수:
- 모든 보이는 버튼은 실제 핸들러를 트리거하거나 제거되어야 함
- 모든 폼은 API 호출에 연결된 실제 onSubmit이 있어야 함
- 모든 목록은 로딩 상태와 함께 실제 데이터 소스에서 로드되어야 함
- 모든 링크는 실제 대상으로 이동해야 함
- 빈 상태는 이유를 설명하고 다음 작업을 제안해야 함
- 오류 상태는 서버의 실제 오류 메시지를 표시해야 함
- 로딩 상태는 실제 비동기 작업 중에 나타나야 함
- 다중 페이지 웹사이트(홈, 소개, 서비스, 연락처, 제품) 별도 경로 포함
- 전문적인 6색 팔레트 (--color-primary, secondary, accent, bg, surface, text)
- 모든 페이지 전체에 걸친 일관된 디자인 시스템
- 이모지 제로 — SVG 아이콘 사용 (Lucide, Heroicons, Phosphor)
- 섹션 간격: 섹션 사이 최소 80px 패딩
- 푸터: 최소 128px 위쪽 패딩 (위 콘텐츠와 절대 닿지 않음)
- 탐색: 최대 7개 항목, 그룹은 드롭다운 사용, 보조 링크는 푸터에
- 서비스: 목록 페이지 + 서비스별 개별 상세 페이지
- 제품: 목록 페이지 + 제품별 개별 상세 페이지
- 각 서비스 상세: 설명, 프로세스, 인도물, 가격, FAQ, CTA
- 각 제품 상세: 갤러리, 사양, 가격, 리뷰, 관련 제품
웹사이트 아키텍처 안티패턴
❌ 금지 (사용자가 "웹사이트를 만들어 줘"라고 말할 때):
- index.html을 유일한 파일로 생성
- 모든 콘텐츠를 하나의 스크롤 가능 페이지에 배치
- 별도 페이지 대신 앵커 링크(#about, #services) 사용
- 단순 랜딩 페이지임에도 "웹사이트"라고 부름
- 섹션/페이지 간 탐색 메뉴 없음
- 페이지 간 공유 헤더/푸터 없음
- 페이지당 고유한 메타 제목/설명 없음
✅ 필수:
- 각 섹션에 대한 별도 경로/페이지 (예: /about, /services, /contact)
- 모든 페이지를 연결하는 탐색 메뉴
- 공유 헤더 + 푸터 컴포넌트
- 각 페이지는 고유한 <title> 및 <meta description>을 가져야 함
- 모든 페이지 전체에 걸친 일관된 색상 팔레트 및 타이포그래피
- "웹사이트" 요청에 대해 최소 5개 페이지 (홈, 소개, 서비스, 제품/포트폴리오, 연락처)
코드 안티패턴
❌ 금지:
- return []; // TODO: 구현
- throw new Error('구현되지 않음');
- // 플레이스홀더
- API 응답인 척하는 하드코딩된 배열
- 빈 본문의 함수
- 오류를 조용히 삼키는 Catch 블록
- 프로덕션 코드의 주석 처리된 코드
- 이름 있는 상수 없는 매직 넘버
- 복사-붙여넣기 코드 (DRY 위반)
- 갓 함수 (100줄 초과)
- 깊게 중첩된 콜백 (3레벨 초과)
- 루프 내 N+1 데이터베이스 쿼리
✅ 필수:
- 모든 함수는 실제 동작하는 구현을 가져야 함
- 모든 오류는 사용자 피드백과 함께 적절히 처리되어야 함
- 상수는 이름이 지정되고 문서화되어야 함
- 코드는 DRY해야 함 — 공유 로직 추출
- 함수는 집중적이고 40줄 미만이어야 함
N+1 쿼리 감지
❌ 금지 (N+1):
// 사용자당 1개 쿼리 실행 = N+1 문제
for (const user of users) {
const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]);
}
✅ 필수 (일괄 처리):
// 총 1개 쿼리 실행
const userIds = users.map(u => u.id);
const orders = await db.query(
'SELECT * FROM orders WHERE user_id IN (?)',
[userIds]
);
// 그런 다음 메모리에서 그룹화
const ordersByUser = groupBy(orders, 'user_id');
SQL 안티패턴
❌ 금지:
SELECT * FROM users -- SELECT * 사용 금지
WHERE name LIKE '%" + input + "%' -- SQL 삽입
ORDER BY RAND() -- 성능 저하
HAVING COUNT(*) > 0 -- WHERE 사용
WHERE YEAR(created_at) = 2024 -- 인덱스 사용 깨짐
✅ 필수:
SELECT id, name, email FROM users -- 명시적 열
WHERE name LIKE ? -- 매개변수화
ORDER BY id DESC LIMIT 20 -- 결정적 정렬
WHERE created_at >= '2024-01-01' -- 인덱스 친화적
AND created_at < '2025-01-01'
검증 체크리스트
어떤 인도물이든 완료로 표시하기 전에:
일반
- 어디에도 "Coming Soon" 또는 "공사 중" 없음
- 모든 버튼이 기능하거나 제거됨
- 모든 폼이 실제 엔드포인트로 제출됨
- 모든 목록이 실제 데이터 소스에서 로드됨
- 프로덕션 경로에 하드코딩된 데모 데이터 없음
- N+1 쿼리 없음 (쿼리가 있는 모든 루프 확인)
- 이슈 참조 없이 TODO 주석 없음
- 오류 상태가 실제 오류를 처리함
- 로딩 상태가 실제 작업 중에 표시됨
디자인 및 UI 안티패턴
- 웹사이트 어디에도 이모지 제로 (SVG 아이콘만 사용)
- 섹션 사이에 최소 80px 패딩 (닿지 않음)
- 푸터에 최소 128px 위쪽 패딩 (콘텐츠에 붙지 않음)
- 기본 탐색에 최대 7개 최상위 항목
- 보조 링크는 기본 탐색이 아닌 푸터에
- 서비스에 개별 상세 페이지가 있음 (목록 페이지만 있는 것이 아님)
- 제품에 개별 상세 페이지가 있음 (목록 페이지만 있는 것이 아님)
- 각 서비스 상세: 설명, 프로세스, 인도물, CTA
- 각 제품 상세: 갤러리, 사양, 가격, 리뷰
- 시각적 구분을 위한 교대 섹션 배경
SEO 안티패턴 (웹사이트 프로젝트의 경우)
- 고유한
<title>및<meta name="description">이 없는 페이지 없음 - Open Graph 태그(og:title, og:description, og:image)가 없는 페이지 없음
- JSON-LD 구조화 데이터(
<script type="application/ld+json">)가 없는 페이지 없음 - 홈페이지가 아닌 페이지에 BreadcrumbList 스키마 없음
- 중복 JSON-LD 블록 없음 (
@id참조 대신 사용) - 누락된
robots.txt또는sitemap.xml없음 -
alt텍스트 없는 이미지 없음 - 표준 URL 없는 페이지 없음
- 누락된
<html lang="xx">속성 없음 -
<h1>이 두 개 이상인 페이지 없음
사용하지 말아야 할 경우
다음 경우에는 이 스킬을 사용하지 마십시오:
- 일반적인 코드 품질 검토 수행 시 (더 폭넓은 분석을 위해 code-review 스킬 사용)
- 데이터베이스 스키마 설계 시 (스키마 계획을 위해 database-design 스킬 사용)
- 애플리케이션 비즈니스 로직 작성 시 (완전한 모듈을 위해 domain-driven 스킬 사용)
- API 엔드포인트 구현 검토 시 (엔드포인트 패턴을 위해 api-design 스킬 사용)
- 보안 감사 수행 시 (취약점 분석을 위해 security-auditor 스킬 사용)
- 배포 구성 분석 시 (CI/CD 파이프라인을 위해 deployment 스킬 사용)
- Git 워크플로우 또는 버전 관리 검토 시 (브랜치/커밋을 위해 git-workflow 스킬 사용)
- SQL 쿼리 작성 시 (쿼리 최적화를 위해 sql-best-practices 스킬 사용)
- 다중 페이지 웹사이트 레이아웃 설계 시 (전문적인 UI/UX를 위해 design-system 스킬 사용)
- 리팩토링이 필요한 기존 코드 검토 시 (안전한 변환을 위해 refactoring 스킬 사용)