agent_guide/.agents/workflows/end.md

description

description
세션 종료 시 학습 기록 + Vikunja 동기화 + git commit (끝, 마무리, 커밋해, 완료)

세션 종료 프로토콜

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

// turbo-all

0. 학습 기록 (실패/시행착오 저장)

이번 세션에서 발생한 실패, 시행착오, 새로 알게 된 사실을 정리합니다:

• .agents/references/known-issues.md에 추가할 항목이 있는지 확인
• 있다면 아래 포맷으로 추가:

### [날짜] [키워드] — 한줄 요약
- **증상**: ...
- **원인**: ...
- **해결**: ...
- **주의**: ...

1. Vikunja 동기화

Caution

반드시 vikunja_helper.py 사용. 직접 API 호출 금지.

1-1. 커밋 전수 검사

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

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

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

코드 변경	대상 Wiki
서버 변경	Architecture
프론트엔드 변경	Architecture
새 모듈 추가	Architecture

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

2. 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: (선택 — 모듈명 등)

3. 최종 체크리스트

• known-issues 업데이트 완료
• Vikunja 태스크 생성/완료 처리됨
• Wiki 동기화됨 (해당 시)
• git push 완료
• 사용자에게 완료 보고