analyze

대상: $ARGUMENTS

실행 순서

1단계: 분석 대상 파악

인자가 폴더 경로면 → 해당 폴더의 .cs 파일 Read 인자가 기능명이면 → Grep으로 관련 .cs 파일 탐색 후 Read 인자가 없으면 → 현재 대화 컨텍스트의 내용 분석

2단계: 분석 결과 출력

저장 없이 채팅에 바로 출력한다.

## 분석 결과: [대상명]

### 개요
이 기능/시스템이 하는 역할 2~3줄

### 관련 파일
| 파일 경로 | 클래스/모듈 | 역할 |
|----------|------------|------|

### 동작 흐름

```mermaid
flowchart TD
    %% 실제 코드 흐름을 Mermaid로 작성

설계 패턴

사용된 패턴

발견된 이슈

분석 중 눈에 띄는 문제점 (없으면 생략)

### 3단계: 저장 여부 확인

출력 후 반드시 질문한다:

이 분석 결과를 docs/analysis/ 에 저장할까요? [y/N]

**N 또는 무응답 → 종료**

**Y → 4단계로 진행**

---

### 4단계: 병합 대상 문서 결정

다음 우선순위로 병합 대상을 결정한다.

**우선순위 1: 프로젝트 CLAUDE.md의 카테고리 맵 확인**

`.claude/CLAUDE.md` 의 `## 문서 카테고리 맵` 섹션을 찾는다.

문서 카테고리 맵

• 전투-시스템: Combat/, Damage/, StatusEffect/
• 인벤토리: Inventory/, Item/, Shop/
• 플레이어: Player/, Input/, Camera/

카테고리 맵이 있으면:
- 분석 대상이 어느 카테고리에 속하는지 매칭
- 해당 카테고리의 기존 문서를 찾아 병합 대상으로 결정

**우선순위 2: Claude 판단 (카테고리 맵 없거나 매칭 안 될 때)**

`docs/analysis/` 의 기존 파일 목록 확인 후:
- 80% 이상 같은 시스템 → 기존 파일에 병합
- 확실히 새로운 기능 → 신규 파일 생성
- 판단 애매 → "기존 [파일명]에 병합할까요, 새 파일로 만들까요?" 확인

### 5단계: 저장 또는 병합

**기존 문서에 병합할 때:**
1. 기존 파일 Read
2. 섹션별 업데이트 (관련 파일 추가, 이슈 추가, 변경 이력 갱신)
3. Write로 저장

**신규 파일 생성할 때:**

파일명 규칙: `카테고리명-분석.md` (한국어 하이픈)

```markdown
# [기능명] 분석

작성일: YYYY-MM-DD
최종수정: YYYY-MM-DD

## 개요

## 관련 파일
| 파일 경로 | 클래스 | 역할 |
|----------|--------|------|

## 동작 흐름

```mermaid
flowchart TD
    %% 실제 코드 흐름을 Mermaid로 작성

설계 패턴

설정값 위치

관련 ScriptableObject 또는 설정 파일

발견된 이슈

주의사항

변경 이력

날짜	변경 내용
YYYY-MM-DD	최초 작성

### 6단계: 결과 보고

💾 저장 완료: docs/analysis/[파일명].md