---
name: issue-update
description: >
  이슈 작업 완료 후 옵시디언 노트 업데이트. 작업 로그 작성, TODO 체크박스 업데이트, 관련 이슈 연관 관계 표기.
  "이슈 업데이트", "이슈 완료", "작업 기록" 등의 요청 시 사용
disable-model-invocation: false
---

# 워크플로우: 이슈 작업 완료 후 옵시디언 노트 업데이트

**목표**: 이슈 작업 완료 후 Obsidian 이슈 파일에 작업 로그를 기록하고, TODO 체크박스를 갱신하고, 관련 이슈를 업데이트합니다.

**이슈 문서 경로**: `/Users/choegihwan/Documents/Projects/Obsidian-frontend-journey/Project/claude-gui-app/`
**프로젝트 경로**: `/Users/choegihwan/Documents/Projects/claude-code-gui/`

## 1단계: 작업 내용 분석

대화 컨텍스트에서 작업한 이슈를 파악합니다.

실제 변경사항을 수집합니다:

```bash
git diff --stat          # 변경된 파일 통계
git log --oneline -20    # 최근 커밋 이력
```

정리할 항목:

- **구현 내용**: 무엇을 만들었는지 (기능 단위 요약)
- **생성 파일**: 새로 만든 파일 목록 (경로 + 한 줄 설명)
- **수정 파일**: 수정한 파일 목록 (경로 + 변경 내용 요약)
- **기술 결정**: 구현 과정에서 내린 설계 결정 (왜 이 방식을 택했는지)
- **미해결 사항**: 남은 이슈, TODO, 후속 작업 (있는 경우)
- **검증 결과**: `pnpm check:all` 결과 요약

## 2단계: 이슈 파일 작업 로그 작성

해당 이슈의 `.md` 파일을 읽고 `## 작업 로그` 섹션을 추가/업데이트합니다.

**기존 완료 이슈의 형식을 준수합니다:**

```markdown
## 작업 로그

### [YYYY-MM-DD] 구현

**구현 내용:**

- Zustand ui-store에 상태/액션 추가
- 뷰 컴포넌트 생성
- (구체적인 기능 단위 나열)

**생성 파일:**

- `src/components/views/ExampleView.tsx` — 설명
- `src/components/layout/ExampleBar.tsx` — 설명

**수정 파일:**

- `src/store/ui-store.ts` — 변경 내용 요약
- `locales/en.json`, `locales/ar.json`, `locales/fr.json` — i18n 키 추가

**기술 결정:**

- 결정 1 (이유)
- 결정 2 (이유)

**미해결 사항:** (있는 경우만)

- 항목 1

**검증:**

- `pnpm check:all` 전체 통과 (typecheck, lint, ast-grep, format, rust checks, N/N tests)
```

**주의사항:**

- 이미 `## 작업 로그` 섹션이 있으면 기존 로그 아래에 새 날짜 항목을 추가합니다.
- 날짜 형식: `YYYY-MM-DD` (오늘 날짜 사용)
- 생성/수정 파일은 실제 git diff 기반으로 작성합니다 (추측하지 않음).

## 3단계: 개발 TODO.md 체크박스 업데이트

`개발 TODO.md`를 읽고 완료된 이슈의 체크박스를 업데이트합니다.

**완료 판정 기준:**

- 코드 작성 완료
- `pnpm check:all` 통과

**처리:**

- 확실히 완료된 항목: `[ ]` → `[x]` 변경
- 불확실한 항목: `AskUserQuestion`으로 사용자에게 확인 요청
- 부분 완료 항목: 체크하지 않고 작업 로그에 미해결 사항으로 기록

## 4단계: 관련 이슈 업데이트

이슈 본문의 `[[위키링크]]`로 연결된 **직접 의존 이슈** 파일을 확인합니다.

필요한 경우:

- 후속 이슈에 참고 메모 추가 (예: "선행 이슈 `[[A]]` 완료됨, 이제 착수 가능")
- 의존 관계가 해소된 이슈에 메모 추가

**사용자 확인 후 수정합니다** — 관련 이슈 변경 전 반드시 `AskUserQuestion`으로 확인.

## 5단계: 진행률 보고

`개발 TODO.md` 전체를 분석하여 보고합니다:

```
📊 프로젝트 진행률

Phase 1: ██████████░░ 3/5 (60%)
Phase 2: ░░░░░░░░░░░░ 0/8 (0%)
Phase 3: ░░░░░░░░░░░░ 0/3 (0%)
Phase 4: ░░░░░░░░░░░░ 0/4 (0%)
Phase 5: ░░░░░░░░░░░░ 0/12 (0%)

전체: 3/32 (9.4%)

🔜 다음 추천 이슈: [[xterm.js 터미널 컴포넌트 통합]]
   Phase 1 · #UI · 의존 없음
```

보고 내용:

- Phase별 완료/전체 비율 (프로그레스 바 시각화)
- 전체 프로젝트 진행률
- 다음 추천 이슈 (Phase 순서 + 의존 관계 고려)
- 추천 이유 (의존 관계 해소됨, 우선순위 높음 등)