102 lines
3.1 KiB
Markdown
102 lines
3.1 KiB
Markdown
---
|
|
description: 세션 종료 시 학습 기록 + Vikunja 동기화 + git commit (끝, 마무리, 커밋해, 완료)
|
|
---
|
|
|
|
# 세션 종료 프로토콜
|
|
|
|
작업 완료, "끝", "마무리", "커밋해" 등 요청 시 이 워크플로우를 실행합니다.
|
|
|
|
// turbo-all
|
|
|
|
## 0. 학습 기록 (실패/시행착오 저장)
|
|
|
|
이번 세션에서 발생한 실패, 시행착오, 새로 알게 된 사실을 정리합니다:
|
|
|
|
- [ ] `.agents/references/known-issues.md`에 추가할 항목이 있는지 확인
|
|
- [ ] 있다면 아래 포맷으로 추가:
|
|
|
|
```markdown
|
|
### [날짜] [키워드] — 한줄 요약
|
|
- **증상**: ...
|
|
- **원인**: ...
|
|
- **해결**: ...
|
|
- **주의**: ...
|
|
```
|
|
|
|
## 1. Vikunja 동기화
|
|
|
|
> [!CAUTION]
|
|
> **반드시 `vikunja_helper.py` 사용.** 직접 API 호출 금지.
|
|
|
|
### 1-1. 커밋 전수 검사
|
|
|
|
이번 세션의 **모든 커밋을 하나씩 검사**하고 Vikunja에 매핑합니다.
|
|
누락 없이 모든 커밋을 처리해야 합니다.
|
|
|
|
```powershell
|
|
git log --oneline -20
|
|
```
|
|
|
|
각 커밋에 대해 아래 표를 기준으로 판단합니다:
|
|
|
|
| 커밋 유형 | Vikunja 액션 |
|
|
|-----------|-------------|
|
|
| 기존 태스크 해당 작업 **완료** | `python .agents\workflows\helpers\vikunja_helper.py done {ID}` |
|
|
| 신규 작업 완료 (기존 태스크 없음) | `python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --done --labels Backend,Priority:High` |
|
|
| 작업 중 발견된 **미완료 TODO** | `python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid` |
|
|
|
|
> [!IMPORTANT]
|
|
> - 커밋 1개 = Vikunja 액션 1개 이상 대응
|
|
> - 여러 커밋이 같은 태스크에 해당하면 마지막 커밋에서 `done` 처리
|
|
> - 매핑할 기존 태스크를 모르면 먼저 `list todo`로 조회
|
|
|
|
### 1-2. Wiki 동기화 (해당 시에만)
|
|
|
|
코드 변경이 아키텍처에 영향을 주는 경우 Wiki를 업데이트합니다:
|
|
|
|
| 코드 변경 | 대상 Wiki |
|
|
|-----------|----------|
|
|
| 서버 변경 (새 API, 모듈) | Architecture |
|
|
| 프론트엔드 변경 (새 컴포넌트) | Architecture |
|
|
| 인프라 변경 (Docker, CI/CD) | Architecture |
|
|
| 새 모듈/패키지 추가 | Architecture |
|
|
|
|
```powershell
|
|
python .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md
|
|
```
|
|
|
|
> [!TIP]
|
|
> Wiki 내용은 먼저 `read`로 기존 내용을 확인한 후, 수정된 전체 내용을 파일로 만들어 `update`합니다.
|
|
|
|
## 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: (선택 — 모듈명 등)
|
|
```
|
|
|
|
## 3. 최종 체크리스트
|
|
|
|
> [!WARNING]
|
|
> 아래 항목 중 하나라도 누락되면 세션 종료를 완료할 수 없습니다.
|
|
|
|
- [ ] known-issues 업데이트 완료 (새 이슈가 있었다면)
|
|
- [ ] Vikunja 태스크 생성/완료 처리됨 (커밋 전수 검사 기반)
|
|
- [ ] Wiki 동기화됨 (아키텍처 변경이 있었다면)
|
|
- [ ] git push 완료
|
|
- [ ] 사용자에게 완료 보고
|