issue-update

name	issue-update
description	> Use when this capability is needed.

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

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

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

1단계: 작업 내용 분석

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

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

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

정리할 항목:

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

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

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

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

## 작업 로그

### [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 순서 + 의존 관계 고려)
• 추천 이유 (의존 관계 해소됨, 우선순위 높음 등)

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.