워크플로우: 이슈 작업 완료 후 옵시디언 노트 업데이트
목표: 이슈 작업 완료 후 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 순서 + 의존 관계 고려)
-
추천 이유 (의존 관계 해소됨, 우선순위 높음 등)