Feature-Sliced Design (FSD) v2.1 공식 문서를 Progressive Disclosure 방식으로 제공하는 지식 스킬. 레이어/슬라이스/세그먼트, Public API, cross-imports, v2.0→v2.1 pages-first 마이그레이션, Next.js·NuxtJS·React Query·SvelteKit·Electron 통합, Authentication·i18n·Types·Theme·SSR 등 실무 가이드를 포함한다. 사용자가 FSD·Feature-Sliced·레이어 구조·슬라이스·pages-first·FSD 도입/마이그레이션을 언급하거나, 프론트엔드 폴더 구조·아키텍처 방법론에 대해 질문할 때 참고할 관련 섹션을 references/ 에서 로드해 답한다. Triggers — "FSD", "Feature-Sliced", "레이어", "슬라이스", "pages-first", "v2.1 마이그레이션", "FSD 도입", "프론트엔드 아키텍처".
FSD v2.1 공식 문서를 주제별로 분할한 지식 스킬. 본 SKILL.md는 인덱스 + 라우팅 테이블 역할만 한다. 실제 지식은 references/ 의 해당 섹션을 필요할 때만 읽어서 사용한다.
references/ 의 각 파일은 frontmatter에 section, source, license 를 명시한 독립 md. 줄 수는 170–2400 범위.references/XX.md 로 간단히 명시.| 사용자 질문 유형 | 로드할 파일 |
|---|---|
| "FSD가 뭐야?", "개요", "적합한가?" | 00-overview.md |
| "레이어 구조", "app/pages/widgets/features/entities/shared", "Public API 규칙", "슬라이스·세그먼트 정의" |
01-core-reference.md| "FSD 실제 예제", "처음 만들 때 어떻게", "어떻게 나눠?", "step-by-step" | 02-tutorial.md |
| "cross-import 되나?", "같은 레이어 import", "desegmentation", "excessive entities", "routing 어디?" | 03-cross-imports-and-antipatterns.md |
| "v2.0에서 v2.1로 어떻게 옮겨?", "pages-first 마이그레이션", "v1→v2", "기존 커스텀 아키텍처에서 FSD로" | 04-migration.md ⭐ |
| "Next.js + FSD", "NuxtJS + FSD", "SvelteKit", "Electron", "React Query 어떻게 배치" | 05-framework-integrations.md |
| "API 요청 어디 둬?", "인증", "i18n", "타입 어디", "페이지 레이아웃", "테마", "SSR", "모노레포" | 06-practical-guides.md |
| "왜 FSD?", "다른 아키텍처와 비교 (DDD, Clean Architecture, Atomic Design)", "네이밍", "미션/철학", "FAQ" | 07-philosophy-and-faq.md |
00-overview.md (Is it right for me) + 07-philosophy-and-faq.md (When not needed)04-migration.md (Custom → FSD 섹션) + 00-overview.md (Incremental adoption)04-migration.md (v2.0→v2.1 섹션, 가장 짧음)06-practical-guides.md (Types/API 섹션) + 05-framework-integrations.md (React Query 섹션)03-cross-imports-and-antipatterns.md (Excessive Entities) + 01-core-reference.md (Layer definitions)LICENSE.md 참조.원문이 갱신되면 docs-to-md 스킬을 이용해 llms-full.txt 를 다시 받고, 이 스킬의 references/ 파일들을 재추출한다. 추출 range는 섹션 헤딩 기준(# Overview, # Layers, # Migration from v2.0 to v2.1 등)으로 결정.