기획서를 읽고 User Story를 작성하여 knowledges/user-story/drafts/ 폴더에 마크다운 파일로 저장한다.

Create User Stories

기획서(PRD 등)를 읽고 애자일 User Story를 작성하여 마크다운 파일로 저장하는 스킬이다.

Process

Step 0: 대상 문서 선택

AskUserQuestion 도구로 사용자에게 어떤 기획서를 읽을지 묻는다.

  • 사용자가 이미 경로를 제공한 경우 이 단계를 건너뛴다
  • 경로를 모를 경우, knowledges/ 및 prototypes/ 아래의 주요 기획서 후보를 Glob으로 탐색하여 선택지를 제시한다
    • 탐색 패턴: knowledges/**/prd/*.md, knowledges/**/prd/**/*.md, prototypes/**/docs/product/*.md

Step 1: 도메인 컨텍스트 로드

다음 문서를 읽어 서비스 개요, 역할(Role), 제품 용어를 파악한다:

1knowledges/README.md

Step 2: 기획서 읽기

사용자가 지정한 문서를 Read 도구로 전체 읽는다. 문서가 길 경우 여러 번에 나눠 읽는다.

Step 3: User Story 작성

기획서 내용 전체를 분석하여 User Story를 작성한다.

User Story 작성 원칙

  1. 기능 명세 형식: 하나의 User Story가 하나의 구현할 기능으로 읽혀야 한다.
    • 형식: [역할]은(는) [기능]을 할 수 있다. 또는 [역할]은(는) [조건]일 때 [기능]을 할 수 없다.
    • "~를 원한다" 같은 희망/요구 형태가 아니라, "~할 수 있다/없다"로 작성하여 스코프 판단 기준으로 활용할 수 있게 한다.
    • 제약 조건이나 금지 사항도 별도 User Story로 분리한다.
  2. MECE 원칙: 기획서의 모든 기능을 빠짐없이 커버하되, 중복 없이 작성
  3. 역할 구분: 기획서에 명시된 역할(예: 관리자, 교육생)별로 User Story를 구분
  4. 적절한 크기: 하나의 User Story = 하나의 구현 단위. 너무 크면 분할, 너무 작으면 병합
  5. 독립성: 각 User Story는 독립적으로 구현/테스트 가능해야 한다

User Story 구조

각 User Story는 다음 구조를 갖는다:

  • 제목: User Story 본문 자체 (번호 없이)

  • 본문:

    1### User Story: {역할}은(는) {기능}을 할 수 있다.
2
3Acceptance Criteria:
4
5- {인수 조건 1: 기능이 올바르게 동작하기 위한 검증 가능한 조건}
6- {인수 조건 2: ...}
7- ...
8
9출처: {기획서 내 관련 섹션명들}

Step 4: 사용자 확인

작성한 User Story 목록을 사용자에게 보여주고, 수정/추가/삭제 요청이 있는지 확인한다.

  • User Story를 그룹별로 나열한다
  • 사용자가 승인하면 Step 5로 진행한다
  • 수정 요청이 있으면 반영 후 다시 확인받는다

Step 5: 마크다운 파일 저장

knowledges/user-story/drafts/ 폴더에 마크다운 파일로 저장한다.

파일 구조

  • 파일명: {기획서명}-user-stories-{YYYY-MM-DD}.md (예: custom-ai-roleplay-user-stories-2026-03-16.md)
  • 파일 내용: 그룹 타이틀로 구분된 User Story 목록
1# {기획서명} User Stories
2
3## {그룹 타이틀 1}
4
5### User Story: {역할}은(는) {기능}을 할 수 있다.
6
7Acceptance Criteria:
8
9- {인수 조건 1}
10- {인수 조건 2}
11
12출처: {섹션명1}, {섹션명2}
13
14### User Story: {역할}은(는) {조건}일 때 {기능}을 할 수 없다.
15
16Acceptance Criteria:
17
18- {인수 조건 1}
19- {인수 조건 2}
20
21출처: {섹션명}
22
23## {그룹 타이틀 2}
24
25### User Story: {역할}은(는) {기능}을 할 수 있다.
26
27...

Step 6: 결과 보고

저장 결과를 사용자에게 보고한다:

  • 총 User Story 수
  • 그룹별 User Story 목록
  • 저장된 파일 경로

Important Notes

  • Step 0의 사용자 입력을 반드시 받은 후에 작업을 시작한다
  • User Story는 기획서의 모든 기능을 커버해야 한다 (누락 금지)
  • 기획서가 한국어이면 User Story도 한국어로 작성한다

Example Usage

Basic

1/create-user-stories

→ 대상 문서를 대화형으로 선택

With Document Path

1/create-user-stories doc_path: knowledges/projects/custom-ai-roleplay/prd/prd_custom_ai_roleplay.md

Quality Checklist

  • 사용자에게 대상 문서를 확인받았는가
  • 기획서의 모든 기능이 User Story로 커버되었는가 (MECE)
  • 각 User Story가 "~할 수 있다/없다" 형식으로 하나의 구현 기능처럼 읽히는가
  • 각 User Story에 검증 가능한 Acceptance Criteria가 포함되어 있는가
  • 그룹 타이틀이 적절하게 분류되었는가
  • 파일이 올바른 경로에 저장되었는가