refactor: sync .agents/ with agent_guide template (helpers/ subdir, devlog, pre-task, debug, references)

This commit is contained in:
2026-03-08 08:38:59 +09:00
parent a2aed87b05
commit e7521433cb
14 changed files with 453 additions and 35 deletions

View File

@@ -1,5 +1,5 @@
---
description: 세션 시작 시 프로젝트 맥락을 빠르게 복구하는 워크플로우
description: 세션 시작 시 프로젝트 맥락을 빠르게 복구하는 워크플로우 (시작, continue, 이어서, 작업 시작)
---
# 세션 시작 프로토콜
@@ -10,7 +10,33 @@ description: 세션 시작 시 프로젝트 맥락을 빠르게 복구하는 워
## 절차
### 1. Git 상태 확인
### 0. 에이전트 룰 & 맥락 로딩 (자동)
`.agents/AGENT.md`를 읽고 에이전트 행동 규칙을 로딩합니다.
`.agents/references/known-issues.md`를 읽어 최근 이슈를 파악합니다.
### 1. Devlog 맥락 복구
오늘 + 어제 devlog index를 읽고 최근 작업 흐름을 파악합니다.
```powershell
$today = Get-Date -Format "yyyy-MM-dd"
$yesterday = (Get-Date).AddDays(-1).ToString("yyyy-MM-dd")
if (Test-Path "docs\devlog\$today.md") {
Write-Host "=== Devlog: $today ==="
Get-Content "docs\devlog\$today.md"
} elseif (Test-Path "docs\devlog\$yesterday.md") {
Write-Host "=== Devlog: $yesterday (no entry for today yet) ==="
Get-Content "docs\devlog\$yesterday.md"
} else {
Write-Host "=== No recent devlog found ==="
}
```
미완료(🔧) 항목이 있으면 해당 entry 파일을 읽어 이어받기 맥락을 확보합니다:
- Entry 경로: `docs/devlog/entries/YYYYMMDD-NNN.md`
### 2. Git 상태 확인
```powershell
git status --short
@@ -19,27 +45,21 @@ git status --short
git log --oneline -5
```
### 2. Vikunja TODO 태스크
### 3. Vikunja TODO 태스크
```powershell
python .agents\workflows\vikunja_helper.py list todo
```
### 3. Wiki 아키텍처 확인 (필요 시)
```powershell
python .agents\workflows\wiki_helper.py read "Architecture"
python .agents\workflows\helpers\vikunja_helper.py list todo
```
### 4. 종합 보고
결과를 종합하여 사용자에게 보고:
- 마지막 커밋 + 미완료 태스크
- 마지막 작업 맥락 + 미완료 항목 (devlog 🔧 기반)
- TODO 태스크 목록 (라벨 + 우선순위)
- 다음 작업 제안
**우선순위 판단 기준:**
- P0: CDP 연결 관련 (Antigravity 연결이 안되면 전체 기능 불가)
- P1: 서버/WebSocket 통신 장애
**우선순위 판단 기준** (라벨만으로 판단 금지):
- P0: 핵심 기능 연결 관련 (전체 기능 불가)
- P1: 서버/통신 장애
- P2: 기능 미완성/UX 개선
- P3: 문서, 코드 정리