From f530ceed5895f9f2d9ee568765467dd369e46ce9 Mon Sep 17 00:00:00 2001 From: kjh2064 Date: Sun, 14 Jun 2026 22:16:05 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20AGENTS.md=20python=20vs=20python3=20?= =?UTF-8?q?=EC=9D=B8=ED=84=B0=ED=94=84=EB=A6=AC=ED=84=B0=20=EA=B5=AC?= =?UTF-8?q?=EB=B6=84=20=EB=AA=85=EC=8B=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Windows 로컬 환경: python → Python 3.13.5 (Python313/) — 프로젝트 패키지 설치됨 (yaml/openpyxl/yfinance) python3 → Python 3.12 (Windows Store) — 패키지 없음 → ModuleNotFoundError 반복 유발 Synology CI는 /usr/bin/python3 별도 환경이므로 ci.yml은 python3 유지. Co-Authored-By: Claude Sonnet 4.6 --- AGENTS.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 1bd942c..2d40a8a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -71,6 +71,10 @@ - `src/quant_engine`는 canonical package로 유지한다. - `schemas/generated`와 `src/quant_engine/models/generated`는 schema/model parity를 유지한다. - 경로가 새로 생기면 `AGENTS.md`의 Directory Routing / Serving 섹션과 zip 화이트리스트를 함께 갱신한다. +- **Python 인터프리터**: Windows 로컬 환경에서는 반드시 `python`을 사용한다 (`python3` 금지). + - `python` → Python 3.13.5 (`Python313/`) — yaml/openpyxl/yfinance 등 프로젝트 패키지 설치됨 + - `python3` → Python 3.12 (Windows Store) — 프로젝트 패키지 미설치 → `ModuleNotFoundError` 유발 + - Synology CI는 `/usr/bin/python3`를 사용하므로 `.gitea/workflows/ci.yml`은 `python3` 유지 ## 6. 검증 규칙 - `python tools/validate_specs.py`