requirements-analyzer
requirements-analyzer
fsd-workshop 파이프라인의 입구 스킬. 요구사항 문서를 읽고 FSD 설계에 필요한 최소 정보를 추출해 fsd-blueprint.md의 초기 뼈대를 작성한다.
이 스킬은 설계 결정을 내리지 않는다. 레이아웃 분류, 공용 컴포넌트 추출, 인증 설계는 다음 스킬(structure-planner)의 역할이다. 여기서는 "무엇이 있는가"만 정리한다.
대화 UX 규약
- 1문 1답 기본. 단순 Yes/No만 2~3개까지 번호로 묶기 허용.
- "모름" / "미정" / "스킵" 항상 허용 → 산출물에
⚠️ 미정으로 기록. - 추출한 목록은 항상 사용자에게 보여주고 확인받은 뒤 파일을 작성한다.
1. 입력
다음 중 하나를 입력으로 받는다.
- DDD 산출물:
ddd-workshop이 생성한requirements.md,event-storming.md,screen-inventory.md등 - PRD / 기획 문서: 자유 형식의 요구사항 문서 (파일 경로 또는 인라인 텍스트)
- 러프한 설명: 한 문단짜리 아이디어도 가능 — 부족한 부분은 인터뷰로 보완
2. 진행 순서
Step 1 — 입력 유형 파악 + 문서 읽기
문서가 있으면 읽는다. 없으면 사용자에게 간단히 설명을 요청한다.
DDD 산출물이 있는 경우 screen-inventory.md가 있으면 우선 활용한다. 없으면 requirements.md에서 액터·범위 섹션을 기준으로 페이지를 추론한다.
Step 2 — 프레임워크 확인
어떤 프레임워크를 사용할 예정인가요?
1) Next.js (App Router)
2) Next.js (Pages Router)
3) SvelteKit
4) Nuxt
5) Angular
6) React + Vite (직접 라우터 설정)
7) Vue + Vite (직접 라우터 설정)
8) 기타 (직접 입력)
9) 아직 미정
프레임워크는 이후 framework-adapter 스킬이 폴더 구조를 생성할 때 핵심 변수가 된다. 미정이어도 괜찮다 — 나중에 채울 수 있다.
Step 3 — 페이지 목록 추출
문서에서 페이지/화면 후보를 추론하고, 아래 형식으로 목록을 제안한다.
추출된 페이지 목록입니다. 빠진 것, 잘못 된 것, 추가할 것이 있으면 말씀해 주세요.
| 페이지명 | 경로 (예상) | 접근 권한 |
|--------------|----------------|----------------|
| 로그인 | /login | 비인증 |
| 회원가입 | /register | 비인증 |
| 대시보드 | /dashboard | 인증 필요 |
| ... | ... | ... |
경로가 불명확하면 ⚠️ 미정으로 둔다. 라우트 설계는 이 스킬의 범위가 아니다.
자동으로 추가할 페이지들 (요구사항에 없어도 대부분 필요):
- 에러 페이지 (404, 500 등)
- 인증이 있으면: 로그인, 로그아웃 처리 경로
Step 4 — 사용자 역할 확인
사용자 역할(액터)을 확인합니다.
추출된 역할: [역할1], [역할2], ...
맞나요? 추가하거나 수정할 역할이 있으면 알려주세요.
(예: 일반 사용자 / 관리자 / 슈퍼어드민 / 게스트 등)
Step 5 — 도메인 힌트 메모
문서에서 다음 정보가 보이면 별도로 메모해 둔다. structure-planner가 레이아웃·공용 컴포넌트 결정 시 활용한다.
- 등록/수정이 페이지에서 이루어지는지, 모달에서 이루어지는지 힌트가 있으면 기록
- 목록+상세 패턴이 반복되는 도메인 객체가 있으면 기록
- 관리자 페이지가 별도 존재하는지 여부
3. 산출물
파일 경로: fsd-blueprint.md (프로젝트 루트 또는 사용자 지정 경로)
사용자가 경로를 지정하지 않으면 프로젝트 루트에 생성한다.
# FSD Blueprint
> fsd-workshop 파이프라인이 단계적으로 채워나가는 FSD 설계 문서.
> **현재 단계**: 1/3 — requirements-analyzer 완료
---
## 메타
- 프레임워크: [값 또는 ⚠️ 미정]
- 언어: [TypeScript / JavaScript / ⚠️ 미정]
- 스타일링: [⚠️ 미정 — structure-planner에서 결정 불필요, 참고용]
---
## 사용자 역할
| 역할 | 설명 |
|---------|--------------------|
| 일반 사용자 | ... |
| 관리자 | ... |
---
## 페이지 & 라우트
| 페이지명 | 경로 | 접근 권한 | 비고 |
|-----------|-------------|------------|-----|
| 로그인 | /login | 비인증 | |
| 대시보드 | /dashboard | 인증 필요 | |
| 404 에러 | /not-found | 공통 | |
---
## 도메인 힌트
> structure-planner가 레이아웃·공용 컴포넌트 결정 시 참고할 내용.
- (예: "연차 신청은 별도 모달로 처리할 가능성 있음")
- (예: "사원 목록 + 사원 상세 패턴 반복")
---
<!-- 아래 섹션은 structure-planner가 채웁니다 -->
## 레이아웃 구조
*(2단계 structure-planner 실행 후 채워짐)*
## 공용 컴포넌트 후보
*(2단계 structure-planner 실행 후 채워짐)*
## 인증 설계
*(2단계 structure-planner 실행 후 채워짐)*
## 폴더 트리
*(3단계 framework-adapter 실행 후 채워짐)*
---
*다음 단계: `fsd-workshop:structure-planner`를 실행하세요.*
4. 강제 체크리스트 (파일 작성 전)
□ 프레임워크 확인됨 (또는 ⚠️ 미정)
□ 페이지 목록 사용자 확인 완료
□ 404 등 공통 에러 페이지 포함됨
□ 사용자 역할 목록 사용자 확인 완료
□ 도메인 힌트 섹션에 메모 있음 (없으면 "(힌트 없음)" 명시)
□ 하위 섹션 (레이아웃/공용 컴포넌트/인증/폴더 트리)은 주석 플레이스홀더로 남겨둠
□ 산출물 경로 사용자와 합의됨
5. 절대 하지 말 것
- 레이아웃 분류, 공용 컴포넌트 결정, 인증 방식 설계 — 이는
structure-planner역할. - 폴더 트리 작성 — 이는
framework-adapter역할. - 페이지 목록 확인 없이 파일 작성.
- 요구사항에 없는 기능을 임의로 추가.
More from dev-goraebap/skills
claude-hook-notify-setup
>
23media-storage
파일 업로드·저장소·첨부 관리 패턴. Actions: 파일 업로드, 이미지 업로드, 파일 처리, 저장소 연동, 썸네일 첨부, 색상 추출, file upload, image upload, storage, attachment, thumbnail. Patterns: Active Storage, blobs 테이블, attachments 테이블, 다형적 첨부, 중복 파일 감지. Storage: Cloudflare R2, AWS S3, @aws-sdk/client-s3, UUID key, 2-level 디렉토리, CDN URL, presigned URL. DB: Drizzle ORM, blob, checksum, MD5, metadata JSON, MIME, byte_size. Color: 지배적 색상 추출, dominant color, Gemini API, hex, blobs.metadata. Query: 썸네일 조회, 서브쿼리, leftJoin, view-model, CDN URL 변환.
22sveltekit-progressive-architecture
SvelteKit 프로젝트 아키텍처·코드 규칙. Actions: 작성, 구현, 리뷰, 리팩터, 검토, 추가, 설계, 수정, write, implement, review, refactor, fix. Base Rules: 컴포넌트 재사용, $lib, 라우트 배치, 인라인 타입 금지, interface, type, script 섹션, 주석, 가독성, code style, TypeScript. Server Architecture: 서버 아키텍처, Active Record, Query Service, REST API, Drizzle, +server.ts, +page.server.ts, server/domain, server/infra, 뷰모델, view-model, form actions, ORM, schema, 레이어 분리, CUD, load.
18agent-wiki
>
15html-prototype
>
12mvp-preview
아이디어나 기능을 빠르게 만들어 링크로 공유하는 MVP 워크플로우. 사용자가 '프로토타입 만들어줘', '데모 페이지 필요해', '빠르게 만들어줘', '클라이언트한테 보여줄 거 만들어줘', '아이디어 구체화해줘', '링크 공유해야 해', '배포해줘', 'MVP 만들기', '기획 검토용 화면'처럼 말하면 반드시 이 스킬을 사용한다. 아이디어가 막연해도 괜찮다. 토론으로 범위를 좁히고, 최소 코드로 가치를 증명하고, 링크 하나로 전달하는 전 과정을 다룬다.
12