uc-deprecate

UseCase 폐기/제거

개요

프로젝트의 메인 설계서 또는 초안에서 하나 이상의 UseCase를 폐기(deprecate) 하거나 제거(remove) 한다. 해당 UC에 의존하는 모든 요소를 체계적으로 분석하고, 영향 분석 리포트를 파일에 기록한 뒤 연쇄 갱신한다.

두 가지 모드:

• 소프트 폐기 — UC를 문서에 남기되 [DEPRECATED] 마킹
• 하드 제거 — UC와 관련 내용을 문서에서 완전 삭제

---

파일 기반 출력 규칙 (핵심)

이 스킬은 클로드 코드 환경에서 사용한다. 영향 분석과 결과를 파일에 기록한다.

원칙

1. 영향 분석 리포트를 파일에 기록한다.
2. 실행 결과 리포트도 파일에 기록한다.
3. 채팅에는 요약과 CRITICAL 항목만 안내한다.

채팅 출력 패턴

# 영향 분석 완료 시 (예시)
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     ← 하드 제거 시 백업

---

시작 절차

1. 대상 문서 및 UC 확인

ls docs/usecase/

사용자에게 확인: 폐기 대상 문서, 폐기 대상 UC (ID 또는 이름)

2. 대상 문서 읽기 및 추출

메인 문서를 읽고, 폐기 대상 UC의 전체 내용을 파악한다:

• UC 기본 정보 (ID, 이름, 액터, 목적)
• 시나리오 (기본/대안 흐름)
• 변수 (독립/상수/종속)
• 도메인 모델 기여 (이 UC로 추가된 엔티티, 속성, 관계, 규칙)
• 상태 모델 기여 (이 UC가 트리거하는 상태 전이, 이 UC에서만 사용되는 상태)
• 시스템 경계 (외부/내부 분류, 트리거)
• 예외, 사전/사후조건
• Mermaid 다이어그램 (이 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 항목만 안내하고 사용자 확인을 받는다.

---

실행: 소프트 폐기

사용자가 소프트 폐기를 선택하면 메인 문서를 직접 편집한다:

1. UC 목록에 [DEPRECATED] 마킹, 취소선 적용
2. 시나리오 섹션에 폐기 안내 추가 (본문은 유지)
3. 변수 식별 섹션에 폐기 안내 추가
4. 도메인 모델에 [DEPRECATED by UC-XX 폐기] 주석
5. 상태 모델에서 이 UC가 트리거하는 전이에 [DEPRECATED by UC-XX 폐기] 주석 추가
6. 시스템 경계 목록에 마킹
7. 예외/사전·사후조건에 폐기 안내
8. Mermaid 다이어그램에서 폐기 노드를 회색 점선 스타일로 변경:

   classDef deprecated fill:#f1efe8,stroke:#b4b2a9,stroke-dasharray:5 5,color:#888780
   

   상태 다이어그램에서도 폐기 전이를 회색 점선 스타일로 변경한다.
9. 의존 UC에 참조 경고 주석 추가

---

실행: 하드 제거

0단계: 백업

파일: docs/usecase/deprecated/UC-[ID]-[name]-deprecated.md

제거 대상 UC의 전체 내용(시나리오, 변수, 예외, 조건, 상태 모델 기여, Mermaid)을 백업한다.

# UC-[ID]: [유스케이스명] — 폐기 백업

> 프로젝트: [project-name]
> 폐기일: [날짜]
> 사유: [폐기 사유]
> 원본 문서: docs/usecase/[project-name]-usecase-design.md

## 폐기 시점 영향 분석 요약
(영향 분석 리포트 요약)

## 원본 내용
(유스케이스 정보, 시나리오, 변수, 도메인 모델 기여, 상태 모델 기여, 시스템 경계, 예외, 조건, Mermaid)

1~9단계: 메인 문서에서 제거

1. UC 목록에서 행 삭제 (ID 재정렬은 기본적으로 안 함)
2. 시나리오 섹션 삭제
3. 변수 식별 섹션 삭제 (참조 UC에 주석 추가)
4. 도메인 모델에서 이 UC 전용 요소 삭제
5. 상태 모델에서 이 UC 전용 전이 삭제, 이 UC에서만 도달 가능했던 상태 삭제 (후속 전이 처리 필요)
6. 시스템 경계에서 행 삭제 (고아 액터/내부 UC 처리)
7. 예외/조건 섹션 삭제
8. Mermaid 다이어그램에서 노드 제거 후 재생성 (상태 다이어그램 포함)
9. 의존 UC를 사용자와 합의한 방안대로 수정

---

실행 결과 리포트

파일: 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로 전체 일관성을 확인하는 것을 권장합니다.