Break product scope into user stories with clear acceptance criteria. — Claude Skill
Claude Code용 Claude 스킬 · 제공: Pawel Huryn · 실행: /write-stories (Claude 내)·업데이트: 2026년 6월 14일·vmain@d384f0c
기능, 디자인, PRD 맥락을 3C와 INVEST 기준에 맞춘 작은 사용자 스토리로 바꾸고 테스트 가능한 인수 조건, 예외, 스프린트 준비 메모를 붙입니다.
- 기능이나 PRD를 누가 무엇을 왜 필요로 하는지 설명하는 스토리로 바꿉니다.
- Card, Conversation, Confirmation을 사용해 스토리가 단순 작업이 아니라 의도를 담게 합니다.
- INVEST 기준으로 스토리가 독립적이고 작고 가치 있고 테스트 가능하게 유지됩니다.
- QA, 디자인, 엔지니어링이 검증할 수 있는 인수 조건, 예외, 범위 제외 메모를 작성합니다.
팀이 “온보딩 체크리스트 만들기”라는 큰 티켓을 만든 뒤 구현 중 예외를 발견합니다.
/write-stories를 실행해 스프린트 계획 전에 기능을 명확한 인수 조건이 있는 사용자 중심 스토리로 나눕니다.
대상
기능
기능을 인수 조건이 있는 sprint 크기 스토리로 나눕니다.
Figma 흐름과 PRD 메모를 구현 준비된 백로그 항목으로 바꿉니다.
엔지니어링 시작 전에 기대 동작을 테스트 가능하게 만듭니다.
작동 방식
기능, PRD, 디자인 링크, 사용자 역할, 가정을 읽습니다.
서로 다른 사용자 여정을 식별하고 작업을 독립적인 스토리로 나눕니다.
각 스토리를 사용자, 행동, 이점으로 작성합니다.
정상 동작, 예외, 검증, 접근성, 연동을 포함한 인수 조건을 추가합니다.
너무 크거나 결정 누락으로 막혔거나 스프린트 계획 준비가 안 된 스토리를 표시합니다.
입력 옵션
백로그 항목으로 바뀌어야 하는 범위입니다.
예시
기능: 새 워크스페이스 관리자를 위한 onboarding 체크리스트. 사용자: 워크스페이스 관리자, 초대받은 팀원. 디자인: Figma 링크. 비즈니스 목표: 활성화를 38%에서 55%로 올리기. 규칙: 처음 14일 동안만 체크리스트 표시; 완료된 작업은 관리자를 방해하지 않아야 함; 초대 알림은 하루 한 번만 보낼 수 있음; 관리자는 활성화를 막는 요소를 알아야 함; 지원팀은 알림 발송 event log가 필요함.
“onboarding 체크리스트 만들기”라는 큰 티켓 하나를 만들지 마세요. 관리자가 진행 상황을 이해하고, 팀원에게 알림를 보내고, 팀원가 invite를 수락하고, 지원팀가 알림 이력를 보는 여정으로 나눕니다.
워크스페이스 관리자로서 활성화를 막는 요소를 알 수 있도록 완료되지 않은 설정 단계를 보고 싶습니다. 인수 조건: 1. 체크리스트는 생성 후 14일 미만 워크스페이스에만 표시됩니다. 2. 현재 활성화 장애 요소가 먼저 표시됩니다. 3. 완료된 작업은 완료 표시되고 시각적으로 덜 강조됩니다. 4. 모든 작업가 완료되면 설정 완료를 설명하는 빈 상태가 표시됩니다. 5. 체크리스트는 키보드 탐색과 스크린 리더로 사용할 수 있습니다.
워크스페이스 관리자로서 설정이 멈추지 않도록 체크리스트에서 초대받은 팀원에게 알림를 보내고 싶습니다. 인수 조건: 1. 알림 button은 pending invite에만 표시됩니다. 2. 팀원별 하루 한 번만 보낼 수 있습니다. 3. 성공 또는 실패 메시지가 명확히 표시됩니다. 4. 알림 활동은 지원팀용으로 기록됩니다. 5. 일일 제한 도달 후 button은 설명과 함께 비활성화됩니다.
초대받은 팀원로서 관리자에게 도움을 요청하지 않고 바로 협업할 수 있도록 초대 링크가 올바른 워크스페이스로 이동하길 원합니다. 인수 조건: 1. 유효한 invite는 올바른 워크스페이스를 엽니다. 2. 만료된 invite는 상황을 설명하고 새 invite 요청 경로를 제공합니다. 3. 이미 수락한 invite는 워크스페이스로 이동합니다. 4. 수락 상태는 예상 새로고침 반영 시간 안에 관리자 체크리스트에 반영됩니다.
CSV 대량 초대, role-permission redesign, SSO provisioning은 이 스토리 세트에 포함하지 않습니다. 여전히 필요하면 별도 발견 항목을 만드세요.
제품팀가 14일 표시 규칙을 확인하고, 디자인팀이 빈 상태를 확인하고, 엔지니어링이 알림 전송 제한를 확인하고, 지원팀가 필요한 이벤트 로그 필드를 확인하면 준비됩니다.
개선되는 지표
지원 도구
사용자 스토리을(를) 사용해 보시겠어요?
시작 방법을 선택하세요.
이 스킬을 컴퓨터에 로컬로 설치하고 실행합니다.
컴퓨터에서 터미널을 열고 이 명령을 붙여넣으세요:
이 명령은 스킬과 모든 파일을 컴퓨터에 다운로드합니다:
모든 프로젝트에서 사용하려면 끝에 -g를 추가하세요.
Claude Code를 시작한 다음 명령을 입력하세요:
사용자 스토리
3C(카드, 대화, 확인)와 INVEST 기준을 따라 사용자 스토리를 작성합니다. 설명, 디자인 링크, 인수 기준이 포함된 스토리를 생성합니다.
사용 시점: 사용자 스토리 작성, 기능을 스토리로 분해, 백로그 항목 생성, 인수 기준 정의.
인수:
$PRODUCT: 제품 또는 시스템 이름$FEATURE: 스토리로 나눌 새 기능$DESIGN: 디자인 파일 링크(Figma, Miro 등)$ASSUMPTIONS: 핵심 가정 또는 맥락
단계별 프로세스
- 제공된 디자인과 맥락을 바탕으로 기능을 분석합니다.
- 사용자 역할과 서로 다른 사용자 여정을 식별합니다.
- 3C 프레임워크 적용:
- 카드: 간단한 제목과 한 줄 설명
- 대화: 의도에 대한 상세 논의
- 확인: 명확한 인수 기준
- INVEST 기준 준수: 독립적, 협상 가능, 가치 있음, 추정 가능, 작음, 테스트 가능
- 초등학교 졸업자도 이해할 수 있는 쉬운 언어를 사용합니다.
- 시각적 참조를 위해 디자인 파일에 연결합니다.
- 사용자 스토리 출력을 구조화된 형식으로 제공합니다.
스토리 템플릿
제목: [기능 이름]
설명: [사용자 역할]로서, [혜택]을 얻기 위해 [행동]하고 싶습니다.
디자인: [디자인 파일 링크]
인수 기준:
- [명확하고 테스트 가능한 기준]
- [관찰 가능한 동작]
- [시스템의 올바른 검증]
- [경계 사례 처리]
- [성능 또는 접근성 고려 사항]
- [연동 지점]
사용자 스토리 예시
제목: 최근 본 항목 섹션
설명: 온라인 쇼핑객으로서, 검토했던 상품을 쉽게 다시 보려면 상품 페이지에서 '최근 본 항목' 섹션을 보고 싶습니다.
디자인: [Figma 링크]
인수 기준:
- 이전에 최소 1개 상품을 본 모든 사용자에게 상품 페이지 하단에 '최근 본 항목' 섹션이 표시됩니다.
- 세션에서 첫 상품 페이지를 방문하는 사용자에게는 표시되지 않습니다.
- 현재 상품 자체는 표시 항목에서 제외됩니다.
- 섹션은 이미지, 제목, 가격이 포함된 상품 카드 또는 썸네일을 보여줍니다.
- 각 상품 카드는 본 시점을 표시합니다(예: '5분 전에 봄').
- 상품 카드를 클릭하면 해당 상품 페이지로 이동합니다.
출력 산출물
- 기능에 대한 완전한 사용자 스토리 세트
- 각 스토리는 제목, 설명, 디자인 링크, 4-6개의 인수 기준을 포함합니다.
- 스토리는 독립적이며 어떤 순서로든 개발할 수 있습니다.
- 스토리는 한 스프린트 주기에 맞는 크기입니다.
- 스토리는 관련 디자인 문서를 참조합니다.
추가 자료
참조 문서
name: user-stories description: "3C(카드, 대화, 확인)와 INVEST 기준을 따라 설명, 디자인 링크, 인수 기준이 포함된 사용자 스토리를 작성합니다. 사용자 스토리 작성, 기능을 백로그 항목으로 분해, 인수 기준 정의에 사용합니다."
사용자 스토리
3C(카드, 대화, 확인)와 INVEST 기준을 따라 사용자 스토리를 작성합니다. 설명, 디자인 링크, 인수 기준이 포함된 스토리를 생성합니다.
사용 시점: 사용자 스토리 작성, 기능을 스토리로 분해, 백로그 항목 생성, 인수 기준 정의.
인수:
$PRODUCT: 제품 또는 시스템 이름$FEATURE: 스토리로 나눌 새 기능$DESIGN: 디자인 파일 링크(Figma, Miro 등)$ASSUMPTIONS: 핵심 가정 또는 맥락
단계별 프로세스
- 제공된 디자인과 맥락을 바탕으로 기능을 분석합니다.
- 사용자 역할과 서로 다른 사용자 여정을 식별합니다.
- 3C 프레임워크 적용:
- 카드: 간단한 제목과 한 줄 설명
- 대화: 의도에 대한 상세 논의
- 확인: 명확한 인수 기준
- INVEST 기준 준수: 독립적, 협상 가능, 가치 있음, 추정 가능, 작음, 테스트 가능
- 초등학교 졸업자도 이해할 수 있는 쉬운 언어를 사용합니다.
- 시각적 참조를 위해 디자인 파일에 연결합니다.
- 사용자 스토리 출력을 구조화된 형식으로 제공합니다.
스토리 템플릿
제목: [기능 이름]
설명: [사용자 역할]로서, [혜택]을 얻기 위해 [행동]하고 싶습니다.
디자인: [디자인 파일 링크]
인수 기준:
- [명확하고 테스트 가능한 기준]
- [관찰 가능한 동작]
- [시스템의 올바른 검증]
- [경계 사례 처리]
- [성능 또는 접근성 고려 사항]
- [연동 지점]
사용자 스토리 예시
제목: 최근 본 항목 섹션
설명: 온라인 쇼핑객으로서, 검토했던 상품을 쉽게 다시 보려면 상품 페이지에서 '최근 본 항목' 섹션을 보고 싶습니다.
디자인: [Figma 링크]
인수 기준:
- 이전에 최소 1개 상품을 본 모든 사용자에게 상품 페이지 하단에 '최근 본 항목' 섹션이 표시됩니다.
- 세션에서 첫 상품 페이지를 방문하는 사용자에게는 표시되지 않습니다.
- 현재 상품 자체는 표시 항목에서 제외됩니다.
- 섹션은 이미지, 제목, 가격이 포함된 상품 카드 또는 썸네일을 보여줍니다.
- 각 상품 카드는 본 시점을 표시합니다(예: '5분 전에 봄').
- 상품 카드를 클릭하면 해당 상품 페이지로 이동합니다.
출력 산출물
- 기능에 대한 완전한 사용자 스토리 세트
- 각 스토리는 제목, 설명, 디자인 링크, 4-6개의 인수 기준을 포함합니다.
- 스토리는 독립적이며 어떤 순서로든 개발할 수 있습니다.
- 스토리는 한 스프린트 주기에 맞는 크기입니다.
- 스토리는 관련 디자인 문서를 참조합니다.