UseCase를 폐기(deprecate)하거나 제거(remove)한다. 메인 설계서 또는 초안에서 특정 UC를 대상으로 영향 분석을 수행하고, 소프트 폐기(deprecated 마킹) 또는 하드 제거(문서에서 삭제)를 실행한다. 의존하는 UC, 도메인 모델, 상태 모델, 변수, 예외, 사전/사후조건, Mermaid 다이어그램까지 연쇄 갱신한다. 영향 분석 리포트를 마크다운 파일에 기록한다. '폐기', 'deprecate', '제거', 'remove', 'UC 삭제', '기능 제거', '유스케이스 폐기', 'UC 정리' 등의 요청에 사용한다.
How this skill is triggered — by the user, by Claude, or both
Slash command
/usecase-driven-design:uc-deprecateThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
프로젝트의 메인 설계서 또는 초안에서 하나 이상의 UseCase를 **폐기(deprecate)** 하거나 **제거(remove)** 한다.
프로젝트의 메인 설계서 또는 초안에서 하나 이상의 UseCase를 폐기(deprecate) 하거나 제거(remove) 한다. 해당 UC에 의존하는 모든 요소를 체계적으로 분석하고, 영향 분석 리포트를 파일에 기록한 뒤 연쇄 갱신한다.
두 가지 모드:
[DEPRECATED] 마킹이 스킬은 클로드 코드 환경에서 사용한다. 영향 분석과 결과를 파일에 기록한다.
# 영향 분석 완료 시 (예시)
UC-02 폐기 영향 분석을 완료했습니다.
→ docs/usecase/impact-analysis-UC-02.md
요약: ❌ CRITICAL 2건 | ⚠️ WARNING 3건
CRITICAL: UC-05 기본흐름 단절, UC-INT-03 트리거 소멸
리포트를 확인하신 후, 소프트 폐기 / 하드 제거 중 선택해주세요.
[project-root]/
└── docs/
└── usecase/
├── [project-name]-usecase-design.md ← 메인 문서 (이 스킬이 갱신)
├── impact-analysis-[UC-ID].md ← 영향 분석 리포트
├── deprecation-report-[날짜].md ← 실행 결과 리포트
├── drafts/
└── deprecated/
└── [UC-ID]-[name]-deprecated.md ← 하드 제거 시 백업
ls docs/usecase/
사용자에게 확인: 폐기 대상 문서, 폐기 대상 UC (ID 또는 이름)
메인 문서를 읽고, 폐기 대상 UC의 전체 내용을 파악한다:
7개 관점에서 분석하고 파일에 기록한다. 모드에 관계없이 항상 수행한다.
파일: docs/usecase/impact-analysis-[UC-ID].md
# UseCase 폐기 영향 분석
> 대상: UC-[ID] [유스케이스명]
> 문서: docs/usecase/[project-name]-usecase-design.md
> 분석일: [날짜]
## 영향 요약
| 분석 관점 | 영향 등급 | 항목 수 |
|----------|----------|--------|
| UC 의존성 | ❌/⚠️/✅ | N개 |
| 변수 연쇄 | ❌/⚠️/✅ | N개 |
| 도메인 모델 | ❌/⚠️/✅ | N개 |
| 상태 모델 | ❌/⚠️/✅ | N개 |
| 시스템 경계 | ❌/⚠️/✅ | N개 |
| 예외/조건 | ❌/⚠️/✅ | N개 |
| Mermaid | ❌/⚠️/✅ | N개 |
---
## 1. UC 의존성 분석
다른 UC가 폐기 대상 UC를 참조하는 곳:
| 참조 위치 | 참조 내용 | 영향 등급 |
|----------|----------|----------|
| UC-05 기본 흐름 3단계 | "UC-02 완료 후 시작" | CRITICAL |
| UC-INT-03 트리거 | "UC-02의 4단계에서 호출" | CRITICAL |
| UC-07 사전조건 | "UC-02가 성공 완료되어야 함" | WARNING |
## 2. 변수 연쇄 영향
| 폐기 UC 변수 | 범주 | 참조하는 UC | 참조 범주 | 영향 |
|-------------|------|-----------|----------|------|
| 주문 상태 | 종속변수 | UC-05 | 상수 | 상수 근거 소멸 |
## 3. 도메인 모델 영향
### 이 UC에서만 사용 (제거 가능)
| 요소 | 유형 |
|------|------|
| Refund | 엔티티 |
### 다른 UC에서도 사용 (유지 필요)
| 요소 | 유형 | 사용하는 다른 UC |
|------|------|----------------|
| Order | 엔티티 | UC-01, UC-03, UC-05 |
## 4. 상태 모델 영향
### 이 UC에서 발생하는 비즈니스 이벤트
| 이벤트 | 대상 엔티티 | 일으키는 전이 | 다른 발생 UC | 영향 |
|--------|-----------|-------------|-------------|------|
| 주문 확인 | Order | CREATED → CONFIRMED | 없음 | CRITICAL: 이벤트 소멸 → 전이 불가 |
| 결제 완료 | Order | CONFIRMED → PAID | UC-04 | WARNING: 대체 발생 UC 존재 |
### 이벤트 소멸로 도달 불가해지는 상태
| 엔티티 | 상태 | 소멸 이벤트 | 영향 |
|--------|------|-----------|------|
| Order | CONFIRMED | 주문 확인 | CRITICAL: 후속 전이 단절 (CONFIRMED → PAID 불가) |
### 이 UC의 폐기로 불필요해지는 이벤트/전이
| 이벤트 | 엔티티 | 전이 | 사유 |
|--------|--------|------|------|
## 5. 시스템 경계 영향
(액터 고아 여부, 내부 UC 트리거 소멸 여부)
## 6. 예외/조건 영향
(삭제/마킹 대상, 의존 관계)
## 7. Mermaid 다이어그램 영향
| 다이어그램 | 위치 | 영향 |
|-----------|------|------|
| 시퀀스 다이어그램 | 2단계 | 전체 제거/마킹 |
| 변수 관계도 | 3단계 | 전체 제거/마킹 |
| 클래스/ER 다이어그램 | 4단계 | 엔티티 제거/유지 |
| 상태 다이어그램 | 5단계 | 전이 제거/마킹 |
| 유스케이스 다이어그램 | 6단계 | 노드 제거/마킹 |
| 시스템 경계 다이어그램 | 6단계 | 노드 제거/마킹 |
---
## CRITICAL 항목 해결 방안
(각 CRITICAL 항목에 대한 해결 방안 제안)
## 권장 조치
1. ...
2. ...
→ 파일 저장 후, 채팅에 요약과 CRITICAL 항목만 안내하고 사용자 확인을 받는다.
사용자가 소프트 폐기를 선택하면 메인 문서를 직접 편집한다:
[DEPRECATED] 마킹, 취소선 적용[DEPRECATED by UC-XX 폐기] 주석[DEPRECATED by UC-XX 폐기] 주석 추가classDef deprecated fill:#f1efe8,stroke:#b4b2a9,stroke-dasharray:5 5,color:#888780
상태 다이어그램에서도 폐기 전이를 회색 점선 스타일로 변경한다.파일: docs/usecase/deprecated/UC-[ID]-[name]-deprecated.md
제거 대상 UC의 전체 내용(시나리오, 변수, 예외, 조건, 상태 모델 기여, Mermaid)을 백업한다.
# UC-[ID]: [유스케이스명] — 폐기 백업
> 프로젝트: [project-name]
> 폐기일: [날짜]
> 사유: [폐기 사유]
> 원본 문서: docs/usecase/[project-name]-usecase-design.md
## 폐기 시점 영향 분석 요약
(영향 분석 리포트 요약)
## 원본 내용
(유스케이스 정보, 시나리오, 변수, 도메인 모델 기여, 상태 모델 기여, 시스템 경계, 예외, 조건, Mermaid)
파일: docs/usecase/deprecation-report-[날짜].md
# 폐기/제거 결과 리포트
> 대상 UC: [ID — 이름]
> 모드: 소프트 폐기 / 하드 제거
> 실행일: [날짜]
> 백업: [백업 파일 경로] (하드 제거 시)
## 삭제/마킹된 항목
| 항목 | 처리 |
|------|------|
| 시나리오 | 삭제/마킹 |
| 변수 | 독립 N개, 상수 N개, 종속 N개 |
| 도메인 모델 | 엔티티 N개, 속성 N개, 관계 N개, 규칙 N개 |
| 상태 모델 | 전이 N개, 상태 N개 |
| 예외 | N개 |
| 사전/사후조건 | 삭제/마킹 |
## 갱신된 의존 UC
| UC | 갱신 내용 |
|----|----------|
| UC-05 | 기본 흐름 3단계 수정 |
| UC-07 | 사전조건에서 UC-02 참조 제거 |
## 갱신된 Mermaid 다이어그램
- 시퀀스 다이어그램
- 변수 관계도
- 클래스/ER 다이어그램
- 상태 다이어그램
- UML 유스케이스 다이어그램
- 시스템 경계 다이어그램
## 고아 요소 처리
- 고아 액터: [처리 내역]
- 고아 내부 UC: [처리 내역]
- 고아 엔티티/속성: [처리 내역]
- 고아 상태/전이: [처리 내역]
폐기를 완료했습니다.
메인 문서: docs/usecase/[project]-usecase-design.md (갱신됨)
결과 리포트: docs/usecase/deprecation-report-[날짜].md
백업: docs/usecase/deprecated/UC-02-환불처리-deprecated.md
uc-review로 전체 일관성을 확인하는 것을 권장합니다.
npx claudepluginhub gogradually/usecase-driven-design-skills --plugin usecase-driven-designCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.