fsd-docs

Installation
SKILL.md

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)

메타데이터

갱신

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

Related skills
Installs
1
First Seen
10 days ago
Security Audits