docs: fill .agents/references with actual project content (architecture, tech-stack, conventions)

.agent/.agents/references/tech-stack.md

@@ -6,32 +6,47 @@
 
 | 항목 | 버전 | 비고 |
 |------|------|------|
-| (예: Node.js) | (예: 20.x) | (설치 경로 등) |
-| (예: Python) | (예: 3.12) | (가상환경 경로 등) |
+| Python | 3.12 | `C:\ProgramData\miniforge3\envs\quant\python.exe` |
 
-## 프레임워크
+## 핵심 패키지
 
-| 항목 | 버전 | 용도 |
-|------|------|------|
-| (예: Express) | (예: 4.18) | (서버) |
-| (예: React) | (예: 18.x) | (프론트엔드) |
+| 패키지 | 용도 | 비고 |
+|--------|------|------|
+| numpy | 행렬 연산, 수치 계산 | 전이행렬 곱, PD 계산 |
+| scipy | 최적화(WLS), 정규분포 | Zt 추정, Vasicek 임계값 |
+| pandas | 데이터프레임, 시계열 | 거시변수, API 응답 처리 |
+| statsmodels | OLS 회귀, 진단 검정 | Zt~거시 모형, ADF/LB/BP |
+| matplotlib | 차트 생성 | 한글 폰트: Malgun Gothic |
+| requests | HTTP 요청 | ECOS API 호출 |
+| tabulate | 표 출력 | 콘솔 결과 테이블 |
+| pyyaml | 설정 파일 | config.yaml 파싱 |
 
 ## 패키지 관리
 
-- 패키지 매니저: (npm / yarn / pnpm / pip 등)
-- Lock 파일: (package-lock.json / yarn.lock 등)
+- 패키지 매니저: conda (miniforge3) + pip
+- 환경: `quant` (`C:\ProgramData\miniforge3\envs\quant`)
+- 의존성 목록: `requirements.txt`
+- 설치: `pip install -r requirements.txt`
 
 ## 개발 도구
 
 | 도구 | 명령어 |
 |------|--------|
-| 개발 서버 | (예: `cmd /c npm run dev`) |
-| 빌드 | (예: `cmd /c npm run build`) |
-| 테스트 | (예: `cmd /c npm test`) |
-| 린트 | (예: `cmd /c npm run lint`) |
+| 실행 (API 사용) | `C:\ProgramData\miniforge3\envs\quant\python.exe main.py` |
+| 실행 (Fallback) | `C:\ProgramData\miniforge3\envs\quant\python.exe main.py --no-api` |
+| Vikunja 조회 | `python .agents\workflows\helpers\vikunja_helper.py list` |
+| Wiki 업데이트 | `python .agents\workflows\helpers\wiki_helper.py update "페이지" /tmp/content.md` |
 
 ## 환경 변수
 
-| 변수명 | 용도 | 기본값 |
-|--------|------|--------|
-| (예: PORT) | (서버 포트) | (3000) |
+| 변수명 | 용도 | 설정 위치 |
+|--------|------|-----------|
+| ECOS API Key | 한은 Open API 인증 | `config.yaml` → `ecos.api_key` |
+
+## 외부 API
+
+| 서비스 | URL | 인증 |
+|--------|-----|------|
+| BOK ECOS | `https://ecos.bok.or.kr/api` | API Key in URL path |
+| Gitea | `https://git.variet.net` | Token in header |
+| Vikunja | `https://plan.variet.net` | Bearer token |