docs: AGENTS.md python vs python3 인터프리터 구분 명시

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 <noreply@anthropic.com>
This commit is contained in:
2026-06-14 22:16:05 +09:00
parent ac2cf87db4
commit f530ceed58
+4
View File
@@ -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`