Communitygithub.com

Omar-Obando/qwen-orchestrator

안티패턴 감지 및 방지 스킬입니다. 하드코딩된 데이터, 비기능적 UI 요소, 플레이스홀더 코드, N+1 쿼리 등 흔한 개발 안티패턴이 배포되기 전에 잡아냅니다.

qwen-orchestrator란 무엇인가요?

이 스킬은 개발 과정에서 자주 발생하는 안티패턴을 감지하고 방지하여 완성되고 전문적인 소프트웨어를 제공하도록 합니다. UI/UX 안티패턴('Coming Soon' 섹션, 비활성 버튼, 하드코딩된 데이터), 코드 안티패턴(빈 함수, TODO 구현 누락, N+1 쿼리, SQL 삽입 취약점), 웹사이트 아키텍처 안티패턴(단일 페이지 사이트, 섹션 간 공유 헤더/푸터 부재), SEO 안티패턴(중복된 제목 태그, Open Graph 태그 누락, JSON-LD 구조화 데이터 부재) 등 다양한 영역을 포괄합니다. 이 스킬은 Claude Code, Cursor 또는 소프트웨어 개발 수명 주기를 지원하는 모든 AI 에이전트에서 사용할 수 있습니다. 검증 체크리스트를 통해 각 인도물이 출시 전에 금지된 모든 안티패턴을 충족하는지 확인하며, 특정 시나리오(예: 데이터베이스 스키마 설계, 보안 감사, 배포 구성 분석)에서는 사용하지 말아야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Omar-Obando/qwen-orchestrator/tree/HEAD/skills/anti-pattern

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

안티패턴 스킬 — 진짜 코드를 출시하세요, 장식품이 아닙니다

이 스킬은 소프트웨어가 미완성되거나 비전문적으로 보이게 만드는 가장 흔한 안티패턴을 감지하고 방지합니다.

금지된 안티패턴 (무관용)

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 스킬 사용)

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬