feat: add complete project init templates (Vikunja, Gitea, Wiki helpers)

This commit is contained in:
2026-03-08 08:09:25 +09:00
parent 2e0a1e37e4
commit 19795bd7ac
8 changed files with 613 additions and 16 deletions

View File

@@ -1,5 +1,5 @@
---
description: 세션 종료 시 학습 기록 + git commit (끝, 마무리, 커밋해, 완료)
description: 세션 종료 시 학습 기록 + Vikunja 동기화 + git commit (끝, 마무리, 커밋해, 완료)
---
# 세션 종료 프로토콜
@@ -12,8 +12,8 @@ description: 세션 종료 시 학습 기록 + git commit (끝, 마무리, 커
이번 세션에서 발생한 실패, 시행착오, 새로 알게 된 사실을 정리합니다:
- [ ] `known-issues.md`에 추가할 항목이 있는지 확인
- [ ] 있다면 `.agents/references/known-issues.md`에 표준 포맷으로 추가:
- [ ] `.agents/references/known-issues.md`에 추가할 항목이 있는지 확인
- [ ] 있다면 아래 포맷으로 추가:
```markdown
### [날짜] [키워드] — 한줄 요약
@@ -23,7 +23,38 @@ description: 세션 종료 시 학습 기록 + git commit (끝, 마무리, 커
- **주의**: ...
```
## 1. Git Commit & Push
## 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` |
### 1-2. Wiki 동기화 (해당 시에만)
| 코드 변경 | 대상 Wiki |
|-----------|----------|
| 서버 변경 | Architecture |
| 프론트엔드 변경 | Architecture |
| 새 모듈 추가 | Architecture |
```powershell
python .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md
```
## 2. Git Commit & Push
```powershell
git add -A
@@ -44,11 +75,10 @@ type: feat|fix|refactor|test|docs|chore|ci|infra
scope: (선택 — 모듈명 등)
```
## 2. 최종 체크리스트
## 3. 최종 체크리스트
- [ ] known-issues 업데이트 완료
- [ ] Vikunja 태스크 생성/완료 처리됨
- [ ] Wiki 동기화됨 (해당 시)
- [ ] git push 완료
- [ ] 사용자에게 완료 보고
> [!TIP]
> 프로젝트별 워크플로우(Vikunja 동기화, Wiki 업데이트 등)가 있다면 여기에 단계를 추가하세요.