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

description

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

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

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

// turbo-all

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

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

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

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

1. Devlog 기ë¡<C3AB>

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

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

• ?Œì<C592>¼: docs/devlog/YYYY-MM-DD.md
• ?•ì‹<C3AC>:

| 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

# ?‘ì—… ?œëª©

- **?œê°„**: 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??매핑?©ë‹ˆ??

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. ?„료 처리

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

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

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

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

---

4. Git Commit & Push

git add -A
git status --short

git commit -m "커밋 메시지"

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>ê²??„료 ë³´ê³