---
description: 세션 종료 시 git commit + Vikunja 동기화
---

# 세션 종료 프로토콜

작업 완료, "끝", "마무리", "커밋해" 등 요청 시 이 워크플로우를 실행합니다.

// turbo-all

## 1. Vikunja 동기화

> [!CAUTION]
> **반드시 `vikunja_helper.py` 사용.** 직접 API 호출 금지.

### 1-1. 커밋 전수 검사

이번 세션의 모든 커밋을 확인하고 Vikunja에 매핑:

```powershell
git log --oneline -20
```

| 커밋 유형 | Vikunja 액션 |
|-----------|-------------|
| 기존 태스크 해당 작업 완료 | `python .agents\workflows\vikunja_helper.py done {ID}` |
| 신규 작업 완료 (기존 태스크 없음) | `python .agents\workflows\vikunja_helper.py create "제목" "설명" --done --labels Backend,Priority:High` |
| 작업 중 발견된 미완료 TODO | `python .agents\workflows\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid` |

### 1-2. Wiki 동기화 (해당 시에만)

| 코드 변경 | 대상 Wiki |
|-----------|----------|
| 서버 변경 | Architecture |
| CDP 관련 | Architecture |
| 프론트엔드 변경 | Architecture |

```powershell
python .agents\workflows\wiki_helper.py update "Architecture" /tmp/wiki_content.md
```

## 2. Git Commit & Push

```powershell
git add -A
git status --short
```
```powershell
git commit -m "커밋 메시지"
```
```powershell
git push origin main
```

**커밋 메시지 컨벤션:**
```
<type>(<scope>): <description>

type: feat|fix|refactor|test|docs|chore|ci|infra
scope: server|frontend|cdp|infra (선택)
```

## 3. 최종 체크리스트

- [ ] Vikunja 태스크 생성/완료 처리됨
- [ ] Wiki 동기화됨 (해당 시)
- [ ] git push 완료
- [ ] 사용자에게 완료 보고