puk0806/gugbab-claude

ddd

DDD(Domain-Driven Design) 아키텍처 핵심 패턴 - 유비쿼터스 언어, 서브도메인, 바운디드 컨텍스트, Aggregate, Entity/VO, 도메인 서비스/이벤트, 레이어드 아키텍처

原文语言：韩语

frontend-domain-structure

대규모 React/Next.js 프로젝트를 layer-first(types/·utils/·hooks/·api/·components/ 밑에 도메인이 반복되는 구조)에서 domain-first(feature/도메인 우선) 구조로 전환하는 설계 기준과 절차. Feature-Sliced Design 2.1 정본(layers 6종·slices·segments·import 규칙·@x 크로스임포트·public API), FSD를 쓰지 않는 경량 대안(features +…

原文语言：多语言混合

incremental-refactoring

소스 파일 수천 개 규모 프론트엔드 코드베이스를 멈추지 않고 점진 재구조화하는 실행 전략 - Strangler Fig / Branch by Abstraction / Parallel Change, ts-morph·jscodeshift codemod, PR 분할·검증 게이트·되돌리기, 테스트 없는 코드의 안전망, 작업 순서 설계와 위반 수 기반 진행 추적

原文语言：多语言混合

module-boundaries

프론트엔드 코드베이스에서 도메인·레이어 간 의존 방향을 도구로 강제하는 방법 - dependency-cruiser, eslint-plugin-boundaries, import/no-restricted-paths, no-restricted-imports, TS project references, package exports, 순환 참조·barrel 관리, 점진 도입 전략

原文语言：韩语

ag-grid

AG Grid v33 데이터 그리드 — 모듈 등록(ModuleRegistry/AllCommunityModule), Theming API, Community vs Enterprise 라이선스 경계, React 커스텀 셀 렌더러·getRowId·useMemo, Next.js App Router, 그리드 상태 저장/복원, row model별 성능 전략

原文语言：韩语

bot-management-seo

Cloudflare·AWS WAF 봇 관리 설정이 Google/Naver 검색 크롤러를 차단하는 함정과 안전한 화이트리스트 설정법. WAF 적용 후 SEO 트래픽이 갑자기 떨어졌을 때 진단·복구 절차 포함.

原文语言：韩语

bundling-compiler

tsup/Vite/Turbopack 번들러 선택 기준, React Compiler, Tree Shaking, 코드 스플리팅 패턴

原文语言：韩语

code-convention

ESLint 10+ flat config, Biome, Prettier, Husky, lint-staged, commitlint 설정 및 선택 기준

原文语言：韩语

e2e-testing

Playwright E2E 테스트 — 설치, 설정, 로케이터, POM, 네트워크 모킹, 인증, 비주얼 회귀, CI, 디버깅 전략

原文语言：韩语

ecommerce-seo

이커머스(쇼핑몰) SEO 전문 가이드. 상품·카테고리·검색·페이지네이션·재고·faceted navigation 처리 패턴. Product Schema(JSON-LD), Merchant listings, 필터 URL 중복 콘텐츠, 재고 변경 대응을 포함한다. <example>사용자: "이커머스 상품 페이지 SEO 어떻게 잡지?"</example> <example>사용자: "필터/색상/사이즈 조합으로 URL이 수만 개 생기는데 어떻게 처리?"</example>…

原文语言：韩语

geo-ai-discoverability

생성형 AI 답변(ChatGPT, Claude, Perplexity, Google AI Overviews 등)에 사이트 콘텐츠가 인용·참조되도록 하는 GEO(Generative Engine Optimization) 영역의 현재 합의된 권장사항. AI 크롤러 robots.txt 정책, llms.txt 표준, 인용 친화 콘텐츠 구조를 다룬다.

原文语言：韩语

kakao-share-optimization

카카오톡 링크 공유 시 OG 미리보기를 최적화하는 방법. 카카오 캐시 초기화, 이미지 사양, JavaScript SDK 공유 구현, SPA 환경 대응을 다룬다. <example>사용자: "카카오톡 공유했는데 미리보기 이미지가 옛날 거 나와요"</example> <example>사용자: "Next.js에서 카카오톡 공유 미리보기 구현하려면?"</example> <example>사용자: "Kakao.Share.sendDefault 사용법 알려줘"</example>

原文语言：韩语

mobile-seo-pwa

모바일 SEO 특수 사항(Mobile-First Indexing, viewport meta, dynamic viewport, iOS safe-area, 인터스티셜 페널티)과 Web App Manifest의 SEO 기여를 한 곳에 정리. seo-static-html 같은 기본 SEO 스킬에서 다루지 않는 모바일·PWA 전용 영역. <example>사용자: "모바일에서 iPhone notch 영역까지 콘텐츠가 차게 만들면서 SEO·접근성 안…

原文语言：韩语

mui-v5

MUI v5 (Material UI 5.x) 레거시 프로젝트 전용 패턴 — Emotion 11 기반 styled()/sx, createTheme + ThemeProvider, TypeScript 테마 확장, v5 Grid(item/xs) 및 Unstable_Grid2, components/componentsProps, palette.mode 다크모드(CSS variables는 실험 단계), @mui/styles(JSS) 함정, v6/v7/v9 업그레이드 경로

原文语言：韩语

mui-v9

MUI v9 (Material UI) 핵심 패턴 — ThemeProvider + CSS Variables, colorSchemes 다크모드, sx prop, styled(), slots/slotProps, Grid v9 (size prop), TypeScript 테마 확장, v5→v9 마이그레이션 포인트

原文语言：韩语

naver-seo-specifics

네이버 통합검색 알고리즘(C-Rank, D.I.A., D.I.A.+, 스마트블록)과 한국 검색 시장 특수성. 자체 도메인을 한국 시장에 노출하려는 운영자가 알아야 할 네이버 SEO만의 메커니즘과 Google과의 차이 정리.

原文语言：韩语

og-image-generation

OpenGraph 이미지(소셜 미리보기용)를 동적으로 생성하는 패턴 카탈로그. 표준 1200×630 사양, Next.js ImageResponse 파일 컨벤션, vercel/satori 단독 사용, 한국어 폰트(Noto Sans KR / Pretendard) 임베드, 빌드 시 사전 생성 vs 런타임 생성, 카카오톡·X·페이스북 미리보기 검증까지 다룬다.

原文语言：韩语

recoil-to-zustand-migration

유지보수 중단된 Recoil 0.7에서 Zustand v5 / Jotai v2로 빠져나오는 전환 경로 — 대안 선택 기준, 개념 대응표, async selector 분리, 브리지 공존 패턴, 점진 이동 절차

原文语言：多语言混合

schema-org-patterns

자주 쓰는 schema.org 타입 8종(Article·Breadcrumb·FAQPage·HowTo·Organization·LocalBusiness·Product·VideoObject·WebSite)의 JSON-LD 카탈로그. 프레임워크 비종속. 각 타입별 필수 필드·권장 필드·Google Rich Results 조건·예시·흔한 실수 정리.

原文语言：韩语

search-console-webmaster

전 세계·국가별 검색엔진(Google·Bing·Naver·Yandex·Baidu)의 사이트 등록·소유권 확인·sitemap 제출·인덱싱 진단 운영 워크플로우. 한국 운영자 기준 Google + Naver 핵심 + IndexNow 자동화까지 다룬다.

原文语言：韩语

seo-vite-spa

Vite / CRA 기반 React SPA의 SEO — react-helmet-async, @unhead/react, Vike 프리렌더, sitemap, JSON-LD

原文语言：韩语

state-management

Zustand v5 전역 상태관리, TanStack Query v5 서버 상태/캐싱 전략, 상태 레이어 분리 아키텍처

原文语言：韩语

structured-data-validation-api

JSON-LD/Schema.org 구조화 데이터를 자동화 검증하기 위한 공식 도구·API·CI 통합 패턴. Google Rich Results Test, Schema Markup Validator, GSC URL Inspection API, schema-dts 타입 검증, Playwright 추출 + ajv 검증, GitHub Actions 통합.

原文语言：韩语

tanstack-query

TanStack Query(React Query) v5 실전 사용 패턴 — queryKey 설계·staleTime/gcTime·낙관적 업데이트·invalidate 범위·Suspense·무한스크롤·App Router SSR

原文语言：韩语

tanstack-query-v4-to-v5-migration

TanStack Query v4 → v5 마이그레이션 전용 — breaking change 전수·before/after, 공식 codemod 자동/수동 경계, 대규모 코드베이스 점진 전환 PR 분할, 타입 에러 없이 동작만 바뀌는 런타임 함정, devtools·persist 패키지 정합, 전환 후 검증 체크리스트

原文语言：韩语

testing

Jest/Vitest + React Testing Library 핵심 패턴, 캡슐화 기반 컴포넌트 테스트 전략

原文语言：韩语

typescript-v4

TypeScript 4.x (4.0~4.9) 버전별 핵심 기능, 타입 시스템 고급 패턴, tsconfig 설정 가이드

原文语言：韩语

url-canonicalization-redirects

URL 정규화·중복 제거·리다이렉트 규칙을 프레임워크/인프라 레이어별로 통일하는 가이드. http→https, www/non-www, 트레일링 슬래시, 대소문자, 쿼리 파라미터, 트래킹 파라미터, 디폴트 파일명까지 7대 정규화 축을 일관되게 처리한다. Next.js / Vite SPA / Vercel / Netlify / Cloudflare Pages / Nginx / Apache 패턴을 다룬다. <example>사용자: "www → non-www + http…

原文语言：韩语

python-anthropic-sdk

Anthropic Python SDK(`anthropic` 패키지) — Python 백엔드에서 Claude API를 호출하는 방법. 동기/비동기 클라이언트, Messages API, 스트리밍, 프롬프트 캐싱(5m/1h), 도구 사용, 비전 입력, 에러 핸들링·재시도, 토큰 카운팅, AWS Bedrock / GCP Vertex 변형까지 다룬다. <example>사용자: "FastAPI에서 Claude API를 비동기로 호출하면서 스트리밍하고…

原文语言：韩语

python-fastapi

FastAPI 0.115+ 기반 비동기 REST API 백엔드 작성 표준 — Pydantic v2 모델·Annotated 의존성 주입·SSE 스트리밍·JWT 인증·OpenAPI 문서·배포 패턴. LLM 프록시(Claude/Whisper 등) 백엔드, 파일 업로드, 백그라운드 작업, 실 프로덕션 배포에 활용한다.

原文语言：韩语

python-uv-project-setup

Astral uv를 사용한 Python 프로젝트 셋업 — pip/poetry/pyenv를 대체하는 Rust 기반 차세대 패키지 매니저. 프로젝트 초기화·의존성 관리·Python 버전 관리·가상환경·lockfile·CI 통합까지 통합 워크플로우. <example>사용자: "FastAPI 프로젝트를 uv로 초기화해줘"</example> <example>사용자: "poetry 프로젝트를 uv로 마이그레이션하려면?"</example> <example>사용자: "uv…

原文语言：韩语

redis-redisson-4

Redisson 4.x — 3.x→4.x Breaking Change 전체(Config 최상위 재편·패키지 이동·RScript enum 개명·Spring Cache/Transaction 모듈 분리·코덱 제거), Spring Boot 3.x/4.x 호환 매트릭스, 분산 락(RLock·tryLock·watchdog·NonReentrant·Fenced), RMap/RBucket 자료구조, 캐시 패턴, 코덱 선택, 커넥션 풀 설정, 실제 마이그레이션 코드 diff

原文语言：韩语

reqwest

Rust reqwest HTTP 클라이언트 핵심 패턴 — GET/POST, JSON, 헤더, 스트리밍, 에러 처리, Client 재사용

原文语言：韩语

spring-boot-2-to-3-migration

Spring Boot 2.5(Java 11) → 3.x(Java 17/21) 마이그레이션 실전 경로 — 2.7 선행 업그레이드, javax→jakarta 전면 전환, Security 5→6 / Springfox→Springdoc / Sleuth→Micrometer Tracing 교체, 설정 프로퍼티 변경, MyBatis·JDBC·HikariCP 호환 확인, WAR/Tomcat 10.1, OpenRewrite 자동화 경계, 순서 체크리스트와 롤백 판단 기준

原文语言：韩语

sse-streaming

Rust Axum SSE 스트리밍 구현 — Sse 응답, Event 구성, tokio-stream 활용, Claude API 스트리밍 변환, EventSource 연동

原文语言：韩语

testing-junit5-spring-boot

JUnit 5 + Spring Boot(2.5 & 3.x) 테스트 패턴 - 단위·슬라이스·통합·E2E 테스트, Mockito, MockMvc, MyBatis 테스트, Testcontainers

原文语言：韩语

github-actions

GitHub Actions CI/CD 워크플로우 작성 패턴 - 트리거, 잡 의존성, 매트릭스, 캐싱, 시크릿, Docker, 배포, 모노레포

原文语言：韩语

github-actions-visual-regression

GitHub Actions에서 Storybook + Playwright 시각 회귀를 자동 실행하고 PR에 결과(깨진 컴포넌트·diff PNG)를 시각화하는 workflow 패턴 - 트리거, 빌드 artifact 전달, baseline 캐시, 결과 업로드, PR 코멘트, 모노레포 matrix

原文语言：韩语

n8n-llm-integration

n8n에서 LLM(Anthropic Claude · OpenAI · Ollama · Hugging Face)을 활용해 AI Agent·Chat Trigger·RAG·도구 호출 워크플로우를 구성하는 가이드. Anthropic Chat Model 노드와 Tools Agent를 중심으로 메모리·벡터 스토어·Output Parser 사용 패턴을 정리한다. <example>사용자: "n8n에서 Claude로 챗봇 만들고 싶어"</example> <example>사용자:…

原文语言：韩语

n8n-self-hosting

n8n self-host 운영 - Docker·docker-compose, PostgreSQL 백엔드, 리버스 프록시, 큐 모드, 인증·암호화 키·백업 보안 베스트

原文语言：韩语