Communitygithub.com

YepAPI/skills

LaunchDarkly/Flagsmith/Vercel 패턴, 점진적 롤아웃, 퍼센트 분할, A/B 토글.

skills란 무엇인가요?

이 스킬은 기능 플래그(Feature Flags)를 사용하여 소프트웨어 배포를 안전하고 점진적으로 진행하는 방법을 정의합니다. 주요 목표는 코드 배포와 기능 출시를 분리하여, 새로운 기능을 플래그 뒤에 숨기고 점진적으로 활성화하는 것입니다. LaunchDarkly(엔터프라이즈), Flagsmith(오픈소스), Vercel Flags(@vercel/flags, Next.js) 등 다양한 플랫폼을 지원하며, 각각에 맞는 패턴을 제공합니다. 스킬은 불리언(켜기/끄기), 퍼센트(사용자 비율), 사용자 타겟팅(특정 ID/세그먼트) 등 다양한 플래그 유형을 다루고, 서버 측 평가를 기본으로 하여 클라이언트에는 결과 값만 전달할 것을 권장합니다. A/B 테스트, 점진적 롤아웃, 플래그 정리, 로컬 개발 환경 설정 등 실무적인 패턴과 함께, 플래그 없는 기능 출시나 중첩된 플래그 의존성과 같은 안티패턴을 피하는 방법도 설명합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/feature-flags

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

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

문서

기능 플래그

규칙

  • 기능 플래그를 사용하여 점진적 롤아웃을 수행하세요 — 코드를 플래그 뒤에 배포하고, 점진적으로 활성화합니다.
  • 플래그 유형: 불리언(켜기/끄기), 퍼센트(사용자의 10%), 사용자 타겟팅(특정 ID/세그먼트)
  • 엔터프라이즈에는 LaunchDarkly, 오픈소스에는 Flagsmith, Next.js에는 Vercel Flags 또는 @vercel/flags를 사용하세요.
  • 기본적으로 서버 측에서 플래그를 평가하세요 — 클라이언트에는 플래그 값만 전달하고, 평가 로직은 절대 전달하지 마세요.
  • 플래그 명명 규칙: enable-new-checkout, show-pricing-v2 — 설명적이고, 케밥-케이스(kebab-case)를 사용하세요.
  • 전체 롤아웃 후 플래그를 정리하세요 — 오래된 플래그는 기술 부채입니다. 만료 날짜를 설정하세요.
  • 퍼센트 롤아웃: 일관된 버케팅(bucketing)을 위해 사용자 ID를 해시하세요 — 동일한 사용자는 항상 동일한 변형을 봅니다.
  • 새로운 기능은 기본적으로 플래그를 끈 상태로 시작하세요 — 플래그 서비스를 사용할 수 없는 경우 안전하게 실패합니다.
  • A/B 테스트에 플래그를 사용하세요: 변형을 정의하고, 전환 이벤트를 추적하며, 통계적 유의성을 측정합니다.
  • 로컬 개발을 위해 플래그 오버라이드를 환경 변수에 저장하세요.

패턴

// Vercel Flags / Next.js 패턴
import { flag } from "@vercel/flags/next";

export const showNewCheckout = flag({
  key: "show-new-checkout",
  decide: () => false, // 기본적으로 꺼짐
});

// 서버 컴포넌트에서 사용
const enabled = await showNewCheckout();
// LaunchDarkly 패턴
import * as ld from "@launchdarkly/node-server-sdk";
const client = ld.init(process.env.LAUNCHDARKLY_SDK_KEY!);

const showFeature = await client.variation("new-checkout", user, false);

피해야 할 것

  • 플래그 없이 기능을 배포하지 마세요 — 모든 새로운 기능은 토글 가능해야 합니다.
  • 중첩된 플래그 의존성을 만들지 마세요 — 플래그 로직을 평평하고 독립적으로 유지하세요.
  • 100% 롤아웃 후에도 코드에 플래그를 남겨두지 마세요 — 2주 이내에 정리 일정을 잡으세요.
  • 타겟팅 규칙이 노출되는 클라이언트 측 플래그 평가를 하지 마세요 — 서버에서 평가하고 결과만 전송하세요.

Individual skills in this repo

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

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

관련 스킬