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

.agents/workflows/check-gitea.md

@@ -1,40 +1,40 @@
 ---
-description: Gitea API로 저장소 커밋/이슈/PR 현황을 조회하는 워크플로우
+description: Gitea APIë¡??€?¥ì†Œ 커밋/?´ìŠˆ/PR ?„황??조회?˜ëŠ” ?Œí<C592>¬?Œë¡œ??
 ---
 
-# Gitea 저장소 현황 조회
+# Gitea ?€?¥ì†Œ ?„황 조회
 
-서비스 정보는 `.agents/workflows/services.md` 참조.
+?œë¹„???•ë³´??`.agents/workflows/services.md` 참조.
 
 // turbo-all
 
-## 절차
+## ?ˆì°¨
 
-1. 최근 커밋 조회 (최신 10개):
+1. 최근 커밋 조회 (최신 10�:
 ```powershell
 $h = @{Authorization="token 3a01b4b15a39921572e64c413353e870d4d2161b"}
 $commits = Invoke-RestMethod -Uri "https://git.variet.net/api/v1/repos/Variet/variet-agent/commits?limit=10&sha=main" -Headers $h
 $commits | ForEach-Object { Write-Host "$($_.sha.Substring(0,7)) $($_.commit.message.Split("`n")[0])" }
 ```
 
-2. 열린 이슈 조회:
+2. ?´ë¦° ?´ìŠˆ 조회:
 ```powershell
 $h = @{Authorization="token 3a01b4b15a39921572e64c413353e870d4d2161b"}
 $issues = Invoke-RestMethod -Uri "https://git.variet.net/api/v1/repos/Variet/variet-agent/issues?state=open&type=issues" -Headers $h
 $issues | ForEach-Object { Write-Host "#$($_.number) $($_.title)" }
 ```
 
-3. Wiki 페이지 목록:
+3. Wiki ?˜ì<CB9C>´ì§€ 목ë¡<C3AB>:
 ```powershell
-C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\wiki_helper.py list
+C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\wiki_helper.py list
 ```
 
-4. Wiki 페이지 읽기:
+4. Wiki ?˜ì<CB9C>´ì§€ ?½ê¸°:
 ```powershell
-C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\wiki_helper.py read "Architecture"
+C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\wiki_helper.py read "Architecture"
 ```
 
-5. Wiki 페이지 업데이트:
+5. Wiki ?˜ì<CB9C>´ì§€ ?…ë<E280A6>°?´íŠ¸:
 ```powershell
-C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\wiki_helper.py update "페이지-제목" /tmp/wiki_content.md
+C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\wiki_helper.py update "?˜ì<CB9C>´ì§€-?œëª©" /tmp/wiki_content.md
 ```

.agents/workflows/check-vikunja.md

@@ -1,41 +1,41 @@
 ---
-description: Vikunja API로 프로젝트 태스크 현황을 조회하는 워크플로우
+description: Vikunja APIë¡??„ë¡œ?<3F>트 ?œìŠ¤???„황??조회?˜ëŠ” ?Œí<C592>¬?Œë¡œ??
 ---
 
-# Vikunja 태스크 현황 조회
+# Vikunja ?œìŠ¤???„황 조회
 
-서비스 정보는 `.agents/workflows/services.md` 참조.
+?œë¹„???•ë³´??`.agents/workflows/services.md` 참조.
 
 // turbo-all
 
-## 절차
+## ?ˆì°¨
 
-1. 전체 목록:
+1. ?„ì²´ 목ë¡<C3AB>:
 ```powershell
-C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py list
+C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py list
 ```
 
-2. TODO만:
+2. 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
 ```
 
-3. DONE만:
+3. DONE�
 ```powershell
-C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py list done
+C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py list done
 ```
 
-4. 태스크 완료 처리 (**⚠️ 반드시 이 방법 사용 — 직접 API 호출 금지**):
+4. ?œìŠ¤???„료 처리 (**? ï¸<C3AF> 반드????방법 ?¬ìš© ??ì§<C3AC>ì ‘ API ?¸ì¶œ 금ì?**):
 ```powershell
-C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
+C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
 ```
 
-5. 새 태스크 생성:
+5. ???œìŠ¤???<3F>성:
 ```powershell
-C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:High
+C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py create "?œëª©" "?¤ëª…" --labels Backend,Priority:High
 ```
 
 > [!CAUTION]
-> **절대로** `Invoke-RestMethod -Method Post -Body '{"done": true}'` 같은 직접 API 호출을 사용하지 마세요.
-> Vikunja API는 POST 시 body에 포함되지 않은 필드를 빈값으로 덮어씁니다.
-> `vikunja_helper.py`는 항상 GET → 기존 필드 보존 → POST 패턴을 사용합니다.
+> **?ˆë?ë¡?* `Invoke-RestMethod -Method Post -Body '{"done": true}'` ê°™ì? ì§<C3AC>ì ‘ API ?¸ì¶œ???¬ìš©?˜ì? 마세??
+> Vikunja API??POST ??body???¬í•¨?˜ì? ?Šì? ?„ë“œë¥?빈값?¼ë¡œ ??–´?<3F>니??
+> `vikunja_helper.py`????ƒ<> GET ??기존 ?„ë“œ ë³´ì¡´ ??POST ?¨í„´???¬ìš©?©ë‹ˆ??

.agents/workflows/end.md

@@ -1,129 +1,129 @@
 ---
-description: 세션 종료 시 devlog 기록 + git commit + Vikunja 동기화 (끝, 마무리, 커밋해, 완료)
+description: ?¸ì…˜ 종료 ??devlog 기ë¡<EFBFBD> + git commit + Vikunja ?™ê¸°??(?? 마무ë¦? 커밋?? ?„료)
 ---
 
-# 세션 종료 프로토콜
+# ?¸ì…˜ 종료 ?„ë¡œ? ì½œ
 
-작업 완료, "끝", "마무리", "커밋해" 등 요청 시 이 워크플로우를 실행합니다.
+?‘ì—… ?„료, "??, "마무ë¦?, "커밋?? ???”ì²­ ?????Œí<C592>¬?Œë¡œ?°ë? ?¤í–‰?©ë‹ˆ??
 
 // turbo-all
 
-## 0. 학습 기록 (실패/시행착오 저장)
+## 0. ?™ìŠµ 기ë¡<C3AB> (?¤íŒ¨/?œí–‰ì°©ì˜¤ ?€??
 
-이번 세션에서 발생한 실패, 시행착오, 새로 알게 된 사실을 정리합니다:
+?´ë²ˆ ?¸ì…˜?<3F>ì„œ ë°œìƒ<C3AC>???¤íŒ¨, ?œí–‰ì°©ì˜¤, ?ˆë¡œ ?Œê²Œ ???¬ì‹¤???•ë¦¬?©ë‹ˆ??
 
-- [ ] `.agents/references/known-issues.md`에 추가할 항목이 있는지 확인
-- [ ] 있다면 아래 포맷으로 추가:
+- [ ] `.agents/references/known-issues.md`??추ê?????ª©???ˆëŠ”지 ?•ì<E280A2>¸
+- [ ] ?ˆë‹¤ë©??„래 ?¬ë§·?¼ë¡œ 추ê?:
 
 ```markdown
-### [날짜] [키워드] — 한줄 요약
+### [? ì§œ] [?¤ì›Œ?? ???œì¤„ ?”약
 - **ì¦<C3AC>ìƒ<C3AC>**: ...
-- **원인**: ...
-- **해결**: ...
+- **?<3F>ì<EFBFBD>¸**: ...
+- **?´ê²°**: ...
 - **주ì<C2BC>˜**: ...
 ```
 
 ## 1. Devlog 기ë¡<C3AB>
 
-### Index 업데이트 (필수 — 매 작업)
+### Index ?…ë<E280A6>°?´íŠ¸ (?„수 ??ë§??‘ì—…)
 
-오늘 날짜의 index 파일에 완료된 작업 1줄을 추가합니다.
+?¤ëŠ˜ ? ì§œ??index ?Œì<C592>¼???„료???‘ì—… 1줄ì<E2809E>„ 추ê??©ë‹ˆ??
 
-- **파일**: `docs/devlog/YYYY-MM-DD.md`
-- **형식**:
+- **?Œì<C592>¼**: `docs/devlog/YYYY-MM-DD.md`
+- **?•ì‹<C3AC>**:
 ```markdown
-| NNN | HH:MM | 작업 설명 | `커밋해시` | ✅ 또는 🔧 |
+| NNN | HH:MM | ?‘ì—… ?¤ëª… | `커밋?´ì‹œ` | ???<3F>는 ?”§ |
 ```
 
 > [!TIP]
-> - ✅ = 완료, 🔧 = 미완료 (다음 세션에서 이어받기)
-> - 파일이 없으면 새로 생성 (테이블 헤더 포함)
+> - ??= ?„료, ?”§ = 미완ë£?(?¤ì<C2A4>Œ ?¸ì…˜?<3F>ì„œ ?´ì–´ë°›ê¸°)
+> - ?Œì<C592>¼???†ìœ¼ë©??ˆë¡œ ?<3F>성 (?Œì<C592>´ë¸??¤ë<C2A4>” ?¬í•¨)
 
-### Entry 작성 (선택적 — 필요할 때만)
+### Entry ?‘성 (? íƒ<C3AD>?????„ìš”???Œë§Œ)
 
 > [!IMPORTANT]
-> Entry는 **git/Vikunja/wiki에 없는 정보**가 있을 때만 작성합니다.
+> Entry??**git/Vikunja/wiki???†ëŠ” ?•ë³´**ê°€ ?ˆì<CB86>„ ?Œë§Œ ?‘성?©ë‹ˆ??
 
-**Entry 작성 기준:**
-- ✅ 설계 결정이 있었을 때 (왜 A가 아닌 B를 선택했는지)
-- ✅ 미완료 사항이 있을 때 (다음 세션이 이어받아야 할 맥락)
-- ✅ 삽질/트러블슈팅이 있었을 때 (같은 실수 방지)
+**Entry ?‘성 기ì?:**
+- ???¤ê³„ ê²°ì •???ˆì—ˆ????(??Aê°€ ?„ë‹Œ Bë¥?? íƒ<C3AD>?ˆëŠ”지)
+- ??미완ë£??¬í•­???ˆì<CB86>„ ??(?¤ì<C2A4>Œ ?¸ì…˜???´ì–´ë°›ì•„????맥ë<C2A5>½)
+- ???½ì§ˆ/?¸ëŸ¬ë¸”슈?…ì<E280A6>´ ?ˆì—ˆ????(ê°™ì? ?¤ìˆ˜ ë°©ì?)
 
-**Entry 불필요:**
-- ❌ 단순 버그 픽스 (커밋 메시지로 충분)
-- ❌ 문서 업데이트 (git diff로 충분)
-- ❌ 이미 Vikunja 태스크에 상세 설명이 있는 경우
+**Entry 불필??**
+- ???¨ìˆœ 버그 ?½ìŠ¤ (커밋 메시지ë¡?충분)
+- ??문서 ?…ë<E280A6>°?´íŠ¸ (git diffë¡?충분)
+- ???´ë? Vikunja ?œìŠ¤?¬ì—<C3AC> ?<3F>세 ?¤ëª…???ˆëŠ” 경우
 
-**Entry 파일**: `docs/devlog/entries/YYYYMMDD-NNN.md`
+**Entry ?Œì<C592>¼**: `docs/devlog/entries/YYYYMMDD-NNN.md`
 ```markdown
-# 작업 제목
+# ?‘ì—… ?œëª©
 
-- **시간**: YYYY-MM-DD HH:MM~HH:MM
-- **Commit**: `해시`
-- **Vikunja**: #태스크번호 → done/진행중
+- **?œê°„**: YYYY-MM-DD HH:MM~HH:MM
+- **Commit**: `?´ì‹œ`
+- **Vikunja**: #?œìŠ¤?¬ë²ˆ????done/진행ì¤?
 
-## 결정 사항
-- 왜 이 방식을 선택했는지
+## ê²°ì • ?¬í•­
+- ????ë°©ì‹<C3AC>??? íƒ<C3AD>?ˆëŠ”지
 
-## 미완료
-- 남은 작업 (있을 경우)
+## 미완�
+- ?¨ì? ?‘ì—… (?ˆì<CB86>„ 경우)
 ```
 
 ---
 
-## 2. Vikunja 동기화
+## 2. Vikunja ?™ê¸°??
 
 > [!CAUTION]
-> **반드시 `vikunja_helper.py` 사용.** 직접 API 호출 금지.
-> Vikunja API는 POST 시 body에 없는 필드를 빈값으로 덮어씁니다.
+> **반드??`vikunja_helper.py` ?¬ìš©.** ì§<C3AC>ì ‘ API ?¸ì¶œ 금ì?.
+> Vikunja API??POST ??body???†ëŠ” ?„ë“œë¥?빈값?¼ë¡œ ??–´?<3F>니??
 
-### 2-1. 커밋 전수 검사
+### 2-1. 커밋 ?„수 ê²€??
 
-이번 세션의 **모든 커밋을 하나씩 검사**하고 Vikunja에 매핑합니다.
+?´ë²ˆ ?¸ì…˜??**모든 커밋???˜ë‚˜??ê²€??*?˜ê³  Vikunja??매핑?©ë‹ˆ??
 
 ```powershell
 git log --oneline -20
 ```
 
-| 커밋 유형 | Vikunja 액션 |
+| 커밋 ? í˜• | Vikunja ?¡ì…˜ |
 |-----------|-------------|
-| 기존 태스크 해당 작업 **완료** | `C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py done {ID}` |
-| 신규 작업 완료 (기존 태스크 없음) | `C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --done --labels Backend,Priority:High` |
-| 작업 중 발견된 **미완료 TODO** | `C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid` |
+| 기존 ?œìŠ¤???´ë‹¹ ?‘ì—… **?„료** | `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. 완료 처리
+### 2-2. ?„료 처리
 
 ```powershell
-C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
+C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
 ```
 
-### 2-3. 신규 태스크 생성
+### 2-3. ? ê·œ ?œìŠ¤???<3F>성
 
 ```powershell
-C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:High
+C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\vikunja_helper.py create "?œëª©" "?¤ëª…" --labels Backend,Priority:High
 ```
 
-### 라벨 규칙
+### ?¼ë²¨ 규칙
 
-**영역 (필수 1개 이상):** `Backend` / `Frontend` / `Engine` / `Infra` / `Test`
-**우선순위 (필수 1개):** `Priority:High` / `Priority:Mid` / `Priority:Low`
+**?<3F>ì—­ (?„수 1ê°??´ìƒ<C3AC>):** `Backend` / `Frontend` / `Engine` / `Infra` / `Test`
+**?°ì„ ?œìœ„ (?„수 1ê°?:** `Priority:High` / `Priority:Mid` / `Priority:Low`
 
 ---
 
-## 3. Wiki 동기화 (해당 시에만)
+## 3. Wiki ?™ê¸°??(?´ë‹¹ ?œì—<C3AC>ë§?
 
-| 코드 변경 | 대상 Wiki |
+| 코드 ë³€ê²?| ?€??Wiki |
 |-----------|----------|
-| 서버 변경 | Architecture |
-| 프론트엔드 변경 | Architecture |
-| 인프라 변경 | Architecture |
-| 새 모듈/패키지 추가 | Architecture |
+| ?œë²„ ë³€ê²?| Architecture |
+| ?„ë¡ ?¸ì—”??ë³€ê²?| Architecture |
+| ?¸í”„??ë³€ê²?| Architecture |
+| ??모듈/?¨í‚¤ì§€ 추ê? | Architecture |
 
 ```powershell
-C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md
+C:\ProgramData\miniforge3\envs\agent_chat\python.exe .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md
 ```
 
 ---
@@ -141,25 +141,25 @@ git commit -m "커밋 메시지"
 git push origin main
 ```
 
-**커밋 메시지 컨벤션:**
+**커밋 메시지 컨벤??**
 ```
 <type>(<scope>): <description>
 
 type: feat|fix|refactor|test|docs|chore|ci|infra
-scope: (선택)
+scope: (? íƒ<C3AD>)
 ```
 
 ---
 
-## 5. 최종 체크리스트
+## 5. 최종 ì²´í<C2B4>¬ë¦¬ìŠ¤??
 
 > [!WARNING]
-> 아래 항목 중 하나라도 누락되면 세션 종료를 완료할 수 없습니다.
+> ?„래 ??ª© ì¤??˜ë‚˜?¼ë<C2BC>„ ?„ë<E2809E>½?˜ë©´ ?¸ì…˜ 종료ë¥??„료?????†ìŠµ?ˆë‹¤.
 
-- [ ] known-issues 업데이트됨 (새 이슈가 있었다면)
-- [ ] devlog index 업데이트됨
-- [ ] devlog entry 작성됨 (필요한 경우만)
-- [ ] Vikunja 태스크 생성/완료 처리됨 (커밋 전수 검사 기반)
-- [ ] Wiki 동기화됨 (아키텍처 변경이 있었다면)
-- [ ] git push 완료
-- [ ] 사용자에게 완료 보고
+- [ ] known-issues ?…ë<E280A6>°?´íŠ¸??(???´ìŠˆê°€ ?ˆì—ˆ?¤ë©´)
+- [ ] devlog index ?…ë<E280A6>°?´íŠ¸??
+- [ ] devlog entry ?‘성??(?„ìš”??경우ë§?
+- [ ] Vikunja ?œìŠ¤???<3F>성/?„료 처리??(커밋 ?„수 ê²€??기반)
+- [ ] Wiki ?™ê¸°?”ë<E2809D>¨ (?„키?<3F>처 변경ì<C2BD>´ ?ˆì—ˆ?¤ë©´)
+- [ ] git push ?„료
+- [ ] ?¬ìš©?<3F>ì—<C3AC>ê²??„료 ë³´ê³ 

.agents/workflows/helpers/vikunja_helper.py

@@ -29,7 +29,7 @@ if sys.stdout.encoding != "utf-8":
 # ============================================================
 API_BASE = "https://plan.variet.net/api/v1"
 TOKEN = "tk_070f8e0b715e818bb7178c3815ed5389040eddca"
-PROJECT_ID = 7                                  # variet-agent 프로젝트
+PROJECT_ID = 7                                  # Variet Agent 프로젝트
 # ============================================================
 
 HEADERS = {

.agents/workflows/helpers/wiki_helper.py

@@ -1,4 +1,4 @@
-"""Gitea Wiki helper: list, read, create, update wiki pages.
+"""Gitea Wiki helper: list, read, create, update wiki pages.
 
 Usage:
   wiki_helper.py list                     — list all pages
@@ -15,7 +15,7 @@ sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
 # ============================================================
 GITEA_BASE_URL = "https://git.variet.net"
 GITEA_OWNER = "Variet"
-GITEA_REPO = "variet-agent"                    # ← 프로젝트별 변경 필요
+GITEA_REPO = "variet-agent"                       # Variet Agent 프로젝트
 GITEA_TOKEN = "3a01b4b15a39921572e64c413353e870d4d2161b"
 # ============================================================
 

.agents/workflows/start.md

@@ -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, 문서 ?•ë¦¬