fsd-docs

name	fsd-docs
description	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 도입", "프론트엔드 아키텍처".
license	MIT

Feature-Sliced Design (FSD) Knowledge Skill

FSD v2.1 공식 문서를 주제별로 분할한 지식 스킬. 본 SKILL.md는 인덱스 + 라우팅 테이블 역할만 한다. 실제 지식은 references/ 의 해당 섹션을 필요할 때만 읽어서 사용한다.

사용 원칙

1. 사용자가 FSD 관련 질문을 하면 먼저 아래 라우팅 테이블에서 관련 섹션 1~2개만 선택해 로드한다. 전체 references 를 한 번에 읽지 않는다.
2. references/ 의 각 파일은 frontmatter에 section, source, license 를 명시한 독립 md. 줄 수는 170–2400 범위.
3. 답변 시 원문에서 인용한 구절이 있으면 출처를 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

자주 묻는 조합

• "우리 프로젝트에 FSD 도입해도 될까?" → 00-overview.md (Is it right for me) + 07-philosophy-and-faq.md (When not needed)
• "기존 코드를 FSD로 마이그레이션하려면?" → 04-migration.md (Custom → FSD 섹션) + 00-overview.md (Incremental adoption)
• "v2.1로 올리려면 얼마나 고쳐야 해?" → 04-migration.md (v2.0→v2.1 섹션, 가장 짧음)
• "FSD에서 Redux/React Query 상태는 어디?" → 06-practical-guides.md (Types/API 섹션) + 05-framework-integrations.md (React Query 섹션)
• "features와 entities 구분이 애매한데?" → 03-cross-imports-and-antipatterns.md (Excessive Entities) + 01-core-reference.md (Layer definitions)

메타데이터

• 문서 버전: FSD v2.1 (현재)
• 원문 출처: https://feature-sliced.design/llms-full.txt
• 수집일: 2026-04-18
• 저작권: © 2018-2025 Feature-Sliced Design. MIT License. LICENSE.md 참조.
• 원문 repo: https://github.com/feature-sliced/documentation

갱신

원문이 갱신되면 docs-to-md 스킬을 이용해 llms-full.txt 를 다시 받고, 이 스킬의 references/ 파일들을 재추출한다. 추출 range는 섹션 헤딩 기준(# Overview, # Layers, # Migration from v2.0 to v2.1 등)으로 결정.