UseCase 설계 스킬 사용 가이드
버전: v3 (상태 모델 추가, UC 다이어그램 위치 수정)
대상 환경: Claude Code
스킬 수: 6개
목차
- 개요
- 설치
- 스킬 구성 한눈에 보기
- 워크플로우 흐름도
- 스킬별 사용법
- 산출물 디렉토리 구조
- 실전 시나리오별 가이드
- 파일 상태 관리
- FAQ
1. 개요
이 스킬 셋은 유스케이스 주도 설계(Use-Case Driven Design) 를 체계적으로 수행하기 위한 Claude Code 전용 도구입니다.
핵심 특징
파일 기반 출력 — 모든 산출물은 채팅이 아닌 마크다운 파일에 기록됩니다. 채팅에는 파일 경로와 간략한 안내만 표시되며, 실제 내용은 파일을 열어서 확인합니다. 이를 통해 다음과 같은 이점을 얻습니다:
- 긴 채팅 히스토리를 스크롤하며 내용을 찾을 필요가 없음
- 단계별 파일로 분리되어 특정 단계만 빠르게 찾아볼 수 있음
- Git 등 버전 관리 시스템과 자연스럽게 연동
- 수정 시 파일을 직접 편집하므로 변경 이력이 명확
OOA 완전 커버리지 — 객체지향 분석(OOA)의 세 축을 모두 다룹니다:
- 기능 모델링: 유스케이스, 시나리오, 시스템 경계
- 구조 모델링: 도메인 모델, 변수 식별
- 행위 모델링: 상태 모델 (엔티티 생애주기)
스킬 간 관계
새 프로젝트 시작 기존 프로젝트에 기능 추가
│ │
uc-new-project uc-add-feature
│ │
└──────────┬──────────────┘
│
uc-review ← 리뷰 (선택)
│
uc-merge ← 메인 문서로 통합
│
uc-deprecate ← 기능 폐기/제거 (필요 시)
usecase-driven-design은 위 워크플로우의 경량 버전(7단계)으로, 초안/메인 문서 분리 없이 바로 설계서를 만들 때 사용합니다.
2. 설치
방법 1: 플러그인으로 설치 (권장)
Claude Code에서 Git 저장소를 마켓플레이스로 등록한 뒤 플러그인을 설치합니다.
# 1. 마켓플레이스 등록
/plugin marketplace add GoGradually/usecase-driven-design-skills
# 2. 플러그인 설치
/plugin install usecase-driven-design@GoGradually-usecase-driven-design-skills
설치 후 스킬은 usecase-driven-design:uc-new-project 형태로 네임스페이스가 붙습니다.
방법 2: 로컬 개발/테스트
저장소를 클론한 뒤 플러그인 디렉토리로 직접 지정합니다.
git clone https://github.com/GoGradually/usecase-driven-design-skills.git
claude --plugin-dir ./usecase-driven-design-skills/usecase-driven-design
방법 3: 수동 설치
스킬 폴더를 직접 복사합니다.
SKILL_DIR="$HOME/.claude/skills"
for skill in uc-new-project uc-add-feature uc-review uc-merge uc-deprecate usecase-driven-design; do
cp -r usecase-driven-design/skills/$skill "$SKILL_DIR/"
done
3. 스킬 구성 한눈에 보기
| 스킬 | 용도 | 트리거 키워드 | 단계 | 주요 산출물 |
|---|
uc-new-project | 새 프로젝트 UC 설계 | "새 프로젝트", "프로젝트 시작" | 8단계 | step1~8.md → 통합 초안 |
uc-add-feature | 기존 프로젝트에 기능 추가 | "기능 추가", "새 기능 UseCase" | 8단계 + step0 | step0~8.md → 통합 초안 |
uc-review | UC 문서 리뷰 | "리뷰", "검토", "초안 확인" | 5개 관점 | review-report.md |
uc-merge | 초안을 메인 문서에 병합 | "병합", "머지", "merge" | 2개 시나리오 | 메인 설계서 + 병합 리포트 |
uc-deprecate | UC 폐기/제거 | "폐기", "deprecate", "제거" | 7개 분석 + 실행 | 영향 분석 + 결과 리포트 |
usecase-driven-design | 경량 UC 설계 | /usecase-driven-design | 7단계 | step1~7.md → 통합 설계서 |
4. 워크플로우 흐름도
일반적인 프로젝트 흐름
1. 프로젝트 시작
└─→ uc-new-project (8단계 → 초안 생성)
2. 초안 리뷰 (권장)
└─→ uc-review (리뷰 리포트 → 수정 반영)
3. 메인 문서 생성
└─→ uc-merge (초안 → 메인 설계서)
4. 기능 추가 (반복)
└─→ uc-add-feature (8단계 → 새 초안)
└─→ uc-review (리뷰)
└─→ uc-merge (메인에 병합)
5. 기능 폐기 (필요 시)
└─→ uc-deprecate (영향 분석 → 실행)
간단한 설계
규모가 작거나 빠르게 진행할 때는 usecase-driven-design만 사용합니다:
usecase-driven-design (7단계 → 바로 설계서)
5. 스킬별 사용법
5.1 uc-new-project
새로운 프로젝트의 UseCase 설계를 처음부터 시작합니다.
호출 예시
"주문 관리 시스템 프로젝트를 새로 시작하려고 해. UseCase를 설계해줘."
"새 프로젝트 이름은 delivery-app이야. 배달 앱의 유스케이스를 만들어줘."
진행 흐름
사용자: 프로젝트 설명
↓
Claude: 디렉토리 생성 + 1단계 작성 → step1-usecases.md 저장
↓
사용자: 파일 확인 → "OK" 또는 "수정해줘"
↓
Claude: (수정 시 파일 편집) → 2단계 작성 → step2-scenarios.md 저장
↓
... (3~8단계 반복) ...
↓
Claude: 8단계 완료 → [feature]-draft.md 통합본 생성
생성되는 파일
docs/usecase/drafts/[feature-name]/
├── step1-usecases.md ← 유스케이스 목록
├── step2-scenarios.md ← 시나리오 + 시퀀스 다이어그램
├── step3-variables.md ← 독립변수/상수/종속변수 + 관계도
├── step4-domain-model.md ← 엔티티, 관계, 규칙 + 클래스 다이어그램
├── step5-state-model.md ← 상태 모델 + 상태 다이어그램
├── step6-system-boundary.md ← 시스템 경계 + UC 다이어그램
├── step7-exceptions.md ← 예외 정리
├── step8-conditions.md ← 사전/사후조건
└── [feature-name]-draft.md ← 최종 통합본
단계별 확인 포인트
| 단계 | 확인할 내용 |
|---|
| 1단계 | UC 식별이 빠짐없는지, 크기가 적절한지 |
| 2단계 | 기본 흐름이 자연스러운지, 대안 흐름이 충분한지 |
| 3단계 | 변수 분류가 타당한지, 종속변수의 결정 요인이 맞는지 |
| 4단계 | 엔티티가 누락 없는지, 관계가 맞는지 |
| 5단계 | 라이프사이클 엔티티를 빠짐없이 다루는지, 전이가 시나리오와 일치하는지 |
| 6단계 | 내/외부 분리가 올바른지, UC 다이어그램이 경계를 정확히 표현하는지 |
| 7단계 | 예외가 빠짐없는지, 대응이 구체적인지 |
| 8단계 | 조건이 검증 가능한 형태인지, 상태 모델의 출발/도착 상태가 반영되었는지 |
5.2 uc-add-feature
기존 프로젝트에 새로운 기능의 UseCase를 추가합니다.
호출 예시
"기존 주문 시스템에 환불 기능을 추가하고 싶어."
"delivery-app 프로젝트에 리뷰/평점 기능 UseCase를 만들어줘."
전제 조건
docs/usecase/ 디렉토리가 이미 존재해야 합니다. 없으면 uc-new-project를 먼저 사용하세요.
진행 흐름
AI-Unified-Process
sean-sunagaku
sethdford
JuliusBrussee
anthropics
wshobson