scaffold

/fsdarch:scaffold

새 슬라이스 또는 세그먼트 보일러플레이트를 생성합니다. 프로젝트 패턴을 학습하여 일관된 스타일로 코드를 생성합니다.

Syntax

/fsdarch:scaffold <layer> <slice-name> [segment]

Prerequisites

• .fsd-architect.json 설정 파일 존재

Arguments

Argument	Description	Example
layer	FSD 레이어 (entities, features, widgets, pages)	features
slice-name	슬라이스 이름	auth
segment	(선택) 특정 세그먼트만 생성	ui, model, api

Execution Flow

Step 1: Validate Input

1. 레이어 유효성 검사 (sliced layer인지 확인)
2. 슬라이스 이름 검사 (기존 존재 여부)
3. 세그먼트 유효성 검사 (SECURITY CRITICAL):
   • --segments 플래그의 각 세그먼트에 대해 slice-generator의 validateSegmentName() 호출
   • Path traversal 공격 방지: .., /, \ 금지
   • Hidden directory 방지: .으로 시작 금지
   • 정규식 패턴 ^[a-zA-Z][a-zA-Z0-9-_]*$ 준수 필수
   • 검증 실패 시 E305 에러 반환

Step 2: Load Project Patterns

Use skill: layer-detector

1. 설정 파일에서 패턴 로드:

   • Naming convention (kebab-case, camelCase, etc.)
   • 사용 중인 세그먼트
   • Index file 패턴

2. 동일 레이어의 기존 슬라이스 분석:

   • 파일 구조 패턴
   • Export 스타일
   • 타입 정의 패턴

Step 3: Generate Structure

Use skill: slice-generator

1. 슬라이스 디렉토리 생성
2. 설정된 세그먼트별 파일 생성
3. Public API (index.ts) 생성

Step 4: Apply Patterns

1. Naming Convention 적용

   • 디렉토리명: 설정된 컨벤션 따름
   • 파일명: 기존 패턴 따름

2. Import Style 적용

   • Alias 사용 (설정된 경우)
   • 상대 경로 스타일

3. Code Style 적용

   • 기존 코드에서 학습한 패턴
   • TypeScript/JavaScript 설정

Step 5: Display Result

═══════════════════════════════════════════════════════════════
                    SLICE CREATED: auth
═══════════════════════════════════════════════════════════════

📁 Created structure:

src/features/auth/
├── index.ts          # Public API
├── ui/
│   ├── index.ts
│   ├── LoginForm.tsx
│   └── LoginForm.module.css
├── model/
│   ├── index.ts
│   ├── types.ts
│   └── useAuth.ts
├── api/
│   ├── index.ts
│   └── authApi.ts
└── lib/
    └── index.ts

📝 Files created: 10
🎨 Pattern applied: kebab-case, barrel exports

💡 Next steps:
   1. Implement your business logic in model/
   2. Create UI components in ui/
   3. Define API calls in api/
   4. Export public interface through index.ts

═══════════════════════════════════════════════════════════════