variet-agent/.agents/workflows/end.md

---
description: ?¸ì…˜ 종료 ??devlog 기ë¡<C3AB> + git commit + Vikunja ?™ê¸°??(?? 마무ë¦? 커밋?? ?„료)
---

# ?¸ì…˜ 종료 ?„ë¡œ? ì½œ

?‘ì—… ?„료, "??, "마무ë¦?, "커밋?? ???”ì²­ ?????Œí<C592>¬?Œë¡œ?°ë? ?¤í–‰?©ë‹ˆ??

// turbo-all

## 0. ?™ìŠµ 기ë¡<C3AB> (?¤íŒ¨/?œí–‰ì°©ì˜¤ ?€??

?´ë²ˆ ?¸ì…˜?<3F>ì„œ ë°œìƒ<C3AC>???¤íŒ¨, ?œí–‰ì°©ì˜¤, ?ˆë¡œ ?Œê²Œ ???¬ì‹¤???•ë¦¬?©ë‹ˆ??

- [ ] `.agents/references/known-issues.md`??추ê?????ª©???ˆëŠ”지 ?•ì<E280A2>¸
- [ ] ?ˆë‹¤ë©??„래 ?¬ë§·?¼ë¡œ 추ê?:

```markdown
### [? ì§œ] [?¤ì›Œ?? ???œì¤„ ?”약
- **ì¦<C3AC>ìƒ<C3AC>**: ...
- **?<3F>ì<EFBFBD>¸**: ...
- **?´ê²°**: ...
- **주ì<C2BC>˜**: ...
```

## 1. Devlog 기ë¡<C3AB>

### Index ?…ë<E280A6>°?´íŠ¸ (?„수 ??ë§??‘ì—…)

?¤ëŠ˜ ? ì§œ??index ?Œì<C592>¼???„료???‘ì—… 1줄ì<E2809E>„ 추ê??©ë‹ˆ??

- **?Œì<C592>¼**: `docs/devlog/YYYY-MM-DD.md`
- **?•ì‹<C3AC>**:
```markdown
| NNN | HH:MM | ?‘ì—… ?¤ëª… | `커밋?´ì‹œ` | ???<3F>는 ?”§ |
```

> [!TIP]
> - ??= ?„료, ?”§ = 미완ë£?(?¤ì<C2A4>Œ ?¸ì…˜?<3F>ì„œ ?´ì–´ë°›ê¸°)
> - ?Œì<C592>¼???†ìœ¼ë©??ˆë¡œ ?<3F>성 (?Œì<C592>´ë¸??¤ë<C2A4>” ?¬í•¨)

### Entry ?‘성 (? íƒ<C3AD>?????„ìš”???Œë§Œ)

> [!IMPORTANT]
> Entry??**git/Vikunja/wiki???†ëŠ” ?•ë³´**ê°€ ?ˆì<CB86>„ ?Œë§Œ ?‘성?©ë‹ˆ??

**Entry ?‘성 기ì?:**
- ???¤ê³„ ê²°ì •???ˆì—ˆ????(??Aê°€ ?„ë‹Œ Bë¥?? íƒ<C3AD>?ˆëŠ”지)
- ??미완ë£??¬í•­???ˆì<CB86>„ ??(?¤ì<C2A4>Œ ?¸ì…˜???´ì–´ë°›ì•„????맥ë<C2A5>½)
- ???½ì§ˆ/?¸ëŸ¬ë¸”슈?…ì<E280A6>´ ?ˆì—ˆ????(ê°™ì? ?¤ìˆ˜ ë°©ì?)

**Entry 불필??**
- ???¨ìˆœ 버그 ?½ìŠ¤ (커밋 메시지ë¡?충분)
- ??문서 ?…ë<E280A6>°?´íŠ¸ (git diffë¡?충분)
- ???´ë? Vikunja ?œìŠ¤?¬ì—<C3AC> ?<3F>세 ?¤ëª…???ˆëŠ” 경우

**Entry ?Œì<C592>¼**: `docs/devlog/entries/YYYYMMDD-NNN.md`
```markdown
# ?‘ì—… ?œëª©

- **?œê°„**: YYYY-MM-DD HH:MM~HH:MM
- **Commit**: `?´ì‹œ`
- **Vikunja**: #?œìŠ¤?¬ë²ˆ????done/진행ì¤?

## ê²°ì • ?¬í•­
- ????ë°©ì‹<C3AC>??? íƒ<C3AD>?ˆëŠ”지

## 미완�
- ?¨ì? ?‘ì—… (?ˆì<CB86>„ 경우)
```

---

## 2. Vikunja ?™ê¸°??

> [!CAUTION]
> **반드??`vikunja_helper.py` ?¬ìš©.** ì§<C3AC>ì ‘ API ?¸ì¶œ 금ì?.
> Vikunja API??POST ??body???†ëŠ” ?„ë“œë¥?빈값?¼ë¡œ ??–´?<3F>니??

### 2-1. 커밋 ?„수 ê²€??

?´ë²ˆ ?¸ì…˜??**모든 커밋???˜ë‚˜??ê²€??*?˜ê³  Vikunja??매핑?©ë‹ˆ??

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

| 커밋 ? í˜• | Vikunja ?¡ì…˜ |
|-----------|-------------|
| 기존 ?œìŠ¤???´ë‹¹ ?‘ì—… **?„료** | `C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py done {ID}` |
| ? ê·œ ?‘ì—… ?„료 (기존 ?œìŠ¤???†ì<E280A0>Œ) | `C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py create "?œëª©" "?¤ëª…" --done --labels Backend,Priority:High` |
| ?‘ì—… ì¤?발견??**미완ë£?TODO** | `C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py create "?œëª©" "?¤ëª…" --labels Backend,Priority:Mid` |

> [!IMPORTANT]
> 모든 커밋??기존 ?<3F>는 ? ê·œ ?œìŠ¤?¬ì—<C3AC> 매핑?˜ì—ˆ?”ì? ?•ì<E280A2>¸.

### 2-2. ?„료 처리

```powershell
C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
```

### 2-3. ? ê·œ ?œìŠ¤???<3F>성

```powershell
C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py create "?œëª©" "?¤ëª…" --labels Backend,Priority:High
```

### ?¼ë²¨ 규칙

**?<3F>ì—­ (?„수 1ê°??´ìƒ<C3AC>):** `Backend` / `Frontend` / `Engine` / `Infra` / `Test`
**?°ì„ ?œìœ„ (?„수 1ê°?:** `Priority:High` / `Priority:Mid` / `Priority:Low`

---

## 3. Wiki ?™ê¸°??(?´ë‹¹ ?œì—<C3AC>ë§?

| 코드 ë³€ê²?| ?€??Wiki |
|-----------|----------|
| ?œë²„ ë³€ê²?| Architecture |
| ?„ë¡ ?¸ì—”??ë³€ê²?| Architecture |
| ?¸í”„??ë³€ê²?| Architecture |
| ??모듈/?¨í‚¤ì§€ 추ê? | Architecture |

```powershell
C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md
```

---

## 4. 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: (? íƒ<C3AD>)
```

---

## 5. 최종 ì²´í<C2B4>¬ë¦¬ìŠ¤??

> [!WARNING]
> ?„래 ??ª© ì¤??˜ë‚˜?¼ë<C2BC>„ ?„ë<E2809E>½?˜ë©´ ?¸ì…˜ 종료ë¥??„료?????†ìŠµ?ˆë‹¤.

- [ ] known-issues ?…ë<E280A6>°?´íŠ¸??(???´ìŠˆê°€ ?ˆì—ˆ?¤ë©´)
- [ ] devlog index ?…ë<E280A6>°?´íŠ¸??
- [ ] devlog entry ?‘성??(?„ìš”??경우ë§?
- [ ] Vikunja ?œìŠ¤???<3F>성/?„료 처리??(커밋 ?„수 ê²€??기반)
- [ ] Wiki ?™ê¸°?”ë<E2809D>¨ (?„키?<3F>처 변경ì<C2BD>´ ?ˆì—ˆ?¤ë©´)
- [ ] git push ?„료
- [ ] ?¬ìš©?<3F>ì—<C3AC>ê²??„료 ë³´ê³