---
description: ?Έμ…˜ μ’…λ£Œ ??devlog 기둝 + git commit + Vikunja ?™κΈ°??(?? 마무λ¦? 컀밋?? ?„λ£Œ)
---

# ?Έμ…˜ μ’…λ£Œ ?„λ‘œ? μ½œ

?‘μ—… ?„λ£Œ, "??, "마무λ¦?, "컀밋?? ???”μ²­ ?????Œν¬?Œλ‘œ?°λ? ?€ν–‰?©λ‹ˆ??

// turbo-all

## 0. ?™μŠ΅ 기둝 (?€νŒ¨/?œν–‰μ°©μ˜€ ?€??

?΄λ²ˆ ?Έμ…˜?μ„œ λ°œμƒ???€νŒ¨, ?œν–‰μ°©μ˜€, ?ˆλ‘œ ?Œκ²Œ ???¬μ‹€???•λ¦¬?©λ‹ˆ??

- [ ] `.agents/references/known-issues.md`??μΆ”κ?????ͺ©???ˆλŠ”지 ?•μΈ
- [ ] ?ˆλ‹€λ©??„λž˜ ?¬λ§·?Όλ‘œ μΆ”κ?:

```markdown
### [? μ§œ] [?€μ›Œ?? ???œμ€„ ?”μ•½
- **증상**: ...
- **?μΈ**: ...
- **?΄κ²°**: ...
- **주의**: ...
```

## 1. Devlog 기둝

### Index ?…데?΄νŠΈ (?„μˆ˜ ??λ§??‘μ—…)

?€λŠ˜ ? μ§œ??index ?ŒμΌ???„λ£Œ???‘μ—… 1쀄을 μΆ”κ??©λ‹ˆ??

- **?ŒμΌ**: `docs/devlog/YYYY-MM-DD.md`
- **?•μ‹**:
```markdown
| NNN | HH:MM | ?‘μ—… ?€λͺ… | `컀밋?΄μ‹œ` | ???λŠ” ?”§ |
```

> [!TIP]
> - ??= ?„λ£Œ, ?”§ = λ―Έμ™„λ£?(?€μŒ ?Έμ…˜?μ„œ ?΄μ–΄λ°›κΈ°)
> - ?ŒμΌ???†μœΌλ©??ˆλ‘œ ?μ„± (?Œμ΄λΈ??€λ” ?¬ν•¨)

### Entry ?‘μ„± (? νƒ?????„μš”???Œλ§Œ)

> [!IMPORTANT]
> Entry??**git/Vikunja/wiki???†λŠ” ?•λ³΄**κ°€ ?ˆμ„ ?Œλ§Œ ?‘μ„±?©λ‹ˆ??

**Entry ?‘μ„± κΈ°μ?:**
- ???€κ³„ κ²°μ •???ˆμ—ˆ????(??Aκ°€ ?„λ‹Œ Bλ₯?? νƒ?ˆλŠ”지)
- ??λ―Έμ™„λ£??¬ν•­???ˆμ„ ??(?€μŒ ?Έμ…˜???΄μ–΄λ°›μ•„????λ§₯락)
- ???½μ§ˆ/?ΈλŸ¬λΈ”μŠˆ?…이 ?ˆμ—ˆ????(κ°™μ? ?€μˆ˜ λ°©μ?)

**Entry λΆˆν•„??**
- ???¨μˆœ 버그 ?½μŠ€ (컀밋 λ©”μ‹œμ§€λ‘?μΆ©λΆ„)
- ??λ¬Έμ„œ ?…데?΄νŠΈ (git diffλ‘?μΆ©λΆ„)
- ???΄λ? Vikunja ?œμŠ€?¬μ— ?μ„Έ ?€λͺ…???ˆλŠ” 경우

**Entry ?ŒμΌ**: `docs/devlog/entries/YYYYMMDD-NNN.md`
```markdown
# ?‘μ—… ?œλͺ©

- **?œκ°„**: YYYY-MM-DD HH:MM~HH:MM
- **Commit**: `?΄μ‹œ`
- **Vikunja**: #?œμŠ€?¬λ²ˆ????done/진행μ€?

## κ²°μ • ?¬ν•­
- ????방식??? νƒ?ˆλŠ”지

## λ―Έμ™„λ£?
- ?¨μ? ?‘μ—… (?ˆμ„ 경우)
```

---

## 2. Vikunja ?™κΈ°??

> [!CAUTION]
> **λ°˜λ“œ??`vikunja_helper.py` ?¬μš©.** 직접 API ?ΈμΆœ 금μ?.
> Vikunja API??POST ??body???†λŠ” ?„λ“œλ₯?λΉˆκ°’?Όλ‘œ ??–΄?λ‹ˆ??

### 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}` |
| ? κ·œ ?‘μ—… ?„λ£Œ (κΈ°μ‘΄ ?œμŠ€???†μŒ) | `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]
> λͺ¨λ“  컀밋??κΈ°μ‘΄ ?λŠ” ? κ·œ ?œμŠ€?¬μ— 맀핑?˜μ—ˆ?”μ? ?•μΈ.

### 2-2. ?„λ£Œ 처리

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

### 2-3. ? κ·œ ?œμŠ€???μ„±

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

### ?Όλ²¨ κ·œμΉ™

**?μ—­ (?„μˆ˜ 1κ°??΄μƒ):** `Backend` / `Frontend` / `Engine` / `Infra` / `Test`
**?°μ„ ?œμœ„ (?„μˆ˜ 1κ°?:** `Priority:High` / `Priority:Mid` / `Priority:Low`

---

## 3. Wiki ?™κΈ°??(?΄λ‹Ή ?œμ—λ§?

| μ½”λ“œ λ³€κ²?| ?€??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: (? νƒ)
```

---

## 5. μ΅œμ’… 체크리슀??

> [!WARNING]
> ?„λž˜ ??ͺ© μ€??˜λ‚˜?Όλ„ ?„락?˜λ©΄ ?Έμ…˜ μ’…λ£Œλ₯??„λ£Œ?????†μŠ΅?ˆλ‹€.

- [ ] known-issues ?…데?΄νŠΈ??(???΄μŠˆκ°€ ?ˆμ—ˆ?€λ©΄)
- [ ] devlog index ?…데?΄νŠΈ??
- [ ] devlog entry ?‘μ„±??(?„μš”??경우λ§?
- [ ] Vikunja ?œμŠ€???μ„±/?„λ£Œ 처리??(컀밋 ?„μˆ˜ κ²€??기반)
- [ ] Wiki ?™κΈ°?”됨 (?„ν‚€?μ²˜ 변경이 ?ˆμ—ˆ?€λ©΄)
- [ ] git push ?„λ£Œ
- [ ] ?¬μš©?μ—κ²??„λ£Œ 보고