requirements-analyzer

Installation
SKILL.md

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 역할.
  • 페이지 목록 확인 없이 파일 작성.
  • 요구사항에 없는 기능을 임의로 추가.
Related skills

More from dev-goraebap/skills

Installs
1
First Seen
10 days ago