auto_trader: Instructions file for Codex

AGENTS.md

이 파일이 이 레포의 유일한 에이전트 진입점이자 정본이다. Codex 등 모든 에이전트가 이 파일을 읽고, Claude Code는 한 줄 스텁 CLAUDE.md(@AGENTS.md)를 통해 같은 파일을 읽는다. 에이전트 지침은 여기에만 쓴다 — CLAUDE.md에 내용을 추가하지 마라.

프로젝트 개요

AI 기반 자동 거래 분석 시스템으로, 다양한 금융 데이터를 수집하고 out-of-process MCP consumer(claude 세션 등)를 통해 투자 분석을 제공합니다.

주요 특징:

• 다중 시장 지원: 국내주식(KIS), 해외주식(KIS/Yahoo Finance), 암호화폐(Upbit)
• 다중 시간대 분석: 일봉 200개 + 분봉(60분/5분/1분)
• AI 분석: out-of-process MCP consumer(claude 세션 등)가 담당 (런타임은 in-process LLM provider 미탑재 — ROB-501 가드)

핵심 명령어

테스트

make test                         # 모든 테스트 실행
make test-unit                    # 단위 테스트만
make test-integration             # 통합 테스트만
make test-cov                     # 커버리지 리포트 포함
uv run pytest tests/test_*.py -v -k "test_name"  # 특정 테스트만

코드 품질

make lint                         # Ruff + ty 검사
make format                       # Ruff로 코드 포맷팅
make typecheck                    # ty 타입 체킹
make security                     # bandit, safety 보안 검사

데이터베이스

# 마이그레이션 생성 및 적용
uv run alembic revision --autogenerate -m "migration message"
uv run alembic upgrade head

# 마이그레이션 롤백
uv run alembic downgrade -1

# 현재 버전 확인
uv run alembic current

개발 도구

python manage_users.py list                 # 사용자 권한/상태 확인
python websocket_monitor.py --mode both     # 통합 WebSocket 모니터링
python kis_websocket_monitor.py             # KIS WebSocket 모니터링
python upbit_websocket_monitor.py           # Upbit WebSocket 모니터링

작업 시작 전 필독 계약

작업을 시작하기 전에 이 파일 전체와 아래 계약 파일 전부를 읽어라. 관심 기능만 골라 읽는 것은 허용되지 않는다.

@docs/agent-contracts/mcp-and-analysis-contracts.md @docs/agent-contracts/broker-and-ledger-contracts.md @docs/agent-contracts/market-data-and-screener-contracts.md @docs/agent-contracts/approval-and-shadow-contracts.md @docs/agent-contracts/data-model-and-symbol-contracts.md @docs/agent-contracts/developer-reference-contracts.md

필독 파일 중 하나라도 없거나 읽을 수 없으면 작업을 중단하라. 찾아보기 표는 탐색 보조일 뿐 필독 면제가 아니다. 문서 속 예시 명령은 실행 승인이나 운영 권한을 부여하지 않는다.