chore: Agent Guide 셋업 — agent_guide.git 기반 .agents 재구성 + 프로젝트별 설정

This commit is contained in:
2026-03-10 22:51:14 +09:00
parent e1aca2b79f
commit 044200a786
11 changed files with 287 additions and 154 deletions

View File

@@ -1,23 +1,23 @@
---
description: 세션 시작 시 프로젝트 맥락을 빠르게 복구하는 워크플로우 (시작, continue, 이어서, 작업 시작)
description: ?¸ì…˜ ?œìž‘ ???„로?<3F>트 ë§¥ë<C2A5>½??빠르ê²?복구?˜ëŠ” ?Œí<C592>¬?Œë¡œ??(?œìž‘, continue, ?´ì–´?? ?‘ì—… ?œìž‘)
---
# 세션 시작 프로토콜
# ?¸ì…˜ ?œìž‘ ?„로? ì½œ
새 대화 시작, "continue", "이어서", "작업 시작" 등 요청 시 이 워크플로우를 실행합니다.
???€???œìž‘, "continue", "?´ì–´??, "?‘ì—… ?œìž‘" ???”ì²­ ?????Œí<C592>¬?Œë¡œ?°ë? ?¤í–‰?©ë‹ˆ??
// turbo-all
## 절차
## ?ˆì°¨
### 0. 에이전트 룰 & 맥락 로딩 (자동)
### 0. ?<3F>ì<EFBFBD>´?„트 ë£?& ë§¥ë<C2A5>½ 로딩 (?<3F>ë<EFBFBD>)
`.agents/AGENT.md`를 읽고 에이전트 행동 규칙을 로딩합니다.
`.agents/references/known-issues.md`를 읽어 최근 이슈를 파악합니다.
`.agents/AGENT.md`ë¥??½ê³  ?<3F>ì<EFBFBD>´?„트 ?‰ë<E280B0>™ 규칙??로딩?©ë‹ˆ??
`.agents/references/known-issues.md`ë¥??½ì–´ 최근 ?´ìŠˆë¥??Œì•…?©ë‹ˆ??
### 1. Devlog ë§¥ë<C2A5>½ 복구
오늘 + 어제 devlog index를 읽고 최근 작업 흐름을 파악합니다.
?¤ëŠ˜ + ?´ì œ devlog indexë¥??½ê³  최근 ?‘ì—… ?<3F>름???Œì•…?©ë‹ˆ??
```powershell
$today = Get-Date -Format "yyyy-MM-dd"
@@ -33,10 +33,10 @@ if (Test-Path "docs\devlog\$today.md") {
}
```
미완료(🔧) 항목이 있으면 해당 entry 파일을 읽어 이어받기 맥락을 확보합니다:
미완ë£??”§) ??ª©???ˆìœ¼ë©??´ë‹¹ entry ?Œì<C592>¼???½ì–´ ?´ì–´ë°›ê¸° ë§¥ë<C2A5>½???•ë³´?©ë‹ˆ??
- Entry 경로: `docs/devlog/entries/YYYYMMDD-NNN.md`
### 2. Git 상태 확인
### 2. Git ?<3F>태 ?•ì<E280A2>¸
```powershell
git status --short
@@ -45,21 +45,21 @@ git status --short
git log --oneline -5
```
### 3. Vikunja TODO 태스크
### 3. Vikunja TODO ?œìФ??
```powershell
C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py list todo
C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py list todo
```
### 4. 종합 보고
결과를 종합하여 사용자에게 보고:
- 마지막 작업 맥락 + 미완료 항목 (devlog 🔧 기반)
- TODO 태스크 목록 (라벨 + 우선순위)
- 다음 작업 제안
ê²°ê³¼ë¥?종합?˜ì—¬ ?¬ìš©?<3F>ì—<C3AC>ê²?ë³´ê³ :
- 마ì?ë§??‘ì—… ë§¥ë<C2A5>½ + 미완ë£???ª© (devlog ?”§ 기반)
- TODO ?œìФ??목ë¡<C3AB> (?¼ë²¨ + ?°ì„ ?œìœ„)
- ?¤ì<C2A4>Œ ?‘ì—… ?œì•ˆ
**우선순위 판단 기준** (라벨만으로 판단 금지):
- P0: 최근 커밋에서 스키마/모델/인터페이스 변경 → 연쇄 영향 점검
- P1: 서버 기동/API 응답 장애
- P2: 기능 미완성/UX 개선
- P3: 정확도 향상, 신규 기능, CI/CD, 문서 정리
**?°ì„ ?œìœ„ ?<3F>ë¨ ê¸°ì?** (?¼ë²¨ë§Œìœ¼ë¡??<3F>ë¨ ê¸ˆì?):
- P0: 최근 커밋?<3F>서 ?¤í‚¤ë§?모ë<C2A8>¸/?¸í„°?˜ì<CB9C>´??ë³€ê²????°ì‡„ ?<3F>í¥ ?<3F>ê?
- P1: ?œë²„ 기ë<C2B0>™/API ?‘답 ?¥ì• 
- P2: 기능 미완??UX 개선
- P3: ?•확???¥ìƒ<C3AC>, ? ê·œ 기능, CI/CD, 문서 ?•리