tomevault-io 워크플로우: 이슈 작업 완료 후 옵시디언 노트 업데이트
목표: 이슈 작업 완료 후 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.