docs: restore onboarding context and clarify runtime-impact gaps

README.md

@@ -22,6 +22,35 @@ KIS API 기반 자동매매 + Gemini 기반 장전 전략 생성 + 장중 로컬
 - `src/dashboard/app.py`: FastAPI 관측 API
 - `src/notifications/telegram_client.py`: 알림 및 명령 핸들러
 
+## Quick Start
+
+### 1. 환경 설정
+
+```bash
+cp .env.example .env
+```
+
+필수 값:
+
+- `KIS_APP_KEY`
+- `KIS_APP_SECRET`
+- `KIS_ACCOUNT_NO`
+- `GEMINI_API_KEY`
+
+### 2. 의존성 설치
+
+```bash
+pip install -e ".[dev]"
+```
+
+### 3. 테스트
+
+```bash
+pytest -v --cov=src
+ruff check src/ tests/
+mypy src/ --strict
+```
+
 ## 실행
 
 ### 기본 실행
@@ -64,11 +93,12 @@ DASHBOARD_PORT=8080
 - `Issue 4-1` 미구현: `/report`, `/scenarios`, `/review`, `/dashboard` Telegram 명령 미등록
 - `Issue 1-7` 일부 미완:
 - `price_change_pct` 정규화 어댑터 명시 구현 없음
+- 영향: `price_change_pct_above/below` 조건을 사용하는 시나리오는 사실상 매칭 불가(dead path)
 - HOLD 시 별도 손절 모니터링 플래그 처리 분리 미흡
 - 시장 코드 정합성 이슈:
 - 설정 기본값은 `ENABLED_MARKETS="KR,US"`
 - 스케줄 정의는 `US_NASDAQ`, `US_NYSE` 중심
-- 완전 통합 전 추가 정리 필요
+- 영향: `get_open_markets(["KR", "US"])`에서 `US` 미정의로 US 시장이 누락될 수 있음(런타임 영향)
 
 ## 테스트