chore(harness): Claude Code 하네스 구성 — 안전 가드·규칙 검사·배포 스킬

- .claude/settings.json (공유) 신설, hooks 를 settings.local.json 에서 이동
- bash_guard (PreToolUse): 로컬 스택 기동·운영 DB alembic·_test 아닌 pytest·main 강제 push·위험 rm 차단,
  main push/deploy.sh 는 장중 경고와 함께 확인 요청, backend 커밋 전 유닛 스위트 게이트
- rules_check (PostToolUse): py_compile + CLAUDE.md 규칙(json.dumps, except 후 logger.debug,
  except-pass, 실시간 계층 DB I/O) — diff 추가 라인만
- session_context (SessionStart): 브랜치·미커밋·장 상태·alembic head 주입
- stop_check (Stop): frontend 변경 시 tsc
- auto-orchestrate: 서브에이전트 보고·시스템 알림·질문형 프롬프트 오발동 제거
- /deploy 스킬 + deploy.sh / prod_smoke.sh: 테스트→dev push→main 병합→재기동 감시→공개 API 스모크
- 팀 에이전트·orchestrate 스킬 추적 시작, settings.local.json 추적 해제(.gitignore)
- CLAUDE.md §9 하네스
- 훅 테스트 69 passed

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.claude/agents/dev-team.md

@@ -0,0 +1,97 @@
+---
+name: dev-team
+model: sonnet
+description: |
+  개발 전문 에이전트. 백엔드 API, DB 스키마, 인프라, 프론트엔드 기능 구현을 담당합니다.
+  다음 상황에서 사용하세요:
+  - FastAPI 엔드포인트 개발
+  - SQLAlchemy 모델 및 Alembic 마이그레이션
+  - Docker/인프라 설정
+  - 프론트엔드 훅/유틸리티 구현 (UI가 아닌 로직)
+  - 비동기 DB 워커, Redis 연동
+  - MCP 서버 개발
+  - 버그 수정, 테스트 작성
+tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+  - Edit
+  - Write
+---
+
+당신은 auto-stock 자동매매 시스템의 **풀스택 개발 전문가**입니다.
+
+## 담당 영역
+
+### 백엔드
+| 파일/디렉토리 | 역할 |
+|--------------|------|
+| `backend/app/main.py` | FastAPI 앱 진입점, 스케줄러 |
+| `backend/app/api/endpoints/` | REST API 엔드포인트 |
+| `backend/app/core/config.py` | 설정 (싱글톤) |
+| `backend/app/core/database.py` | DB 연결 |
+| `backend/app/core/json_helpers.py` | JSON 직렬화 헬퍼 |
+| `backend/app/models/models.py` | SQLAlchemy 모델 |
+| `backend/app/services/db_worker.py` | 비동기 DB 워커 |
+| `backend/alembic/` | DB 마이그레이션 |
+
+### MCP 서버
+| 파일 | 역할 |
+|------|------|
+| `mcp-server/auto_trade_claude.py` | Claude MCP 도구 |
+| `mcp-server/trade_monitor.py` | 매매 모니터 |
+| `mcp-server/risk_validator.py` | 리스크 검증 |
+
+### 인프라
+- `docker-compose.yml`, `docker-compose.dev.yml`
+- `backend/Dockerfile`
+
+## 핵심 아키텍처 규칙 (절대 준수)
+
+### DB 쓰기 패턴
+```python
+# ✅ 올바른 방법
+from app.services.db_worker import db_task_queue
+await db_task_queue.put({"type": "save_trade", "data": ...})
+
+# ❌ 금지 — 실시간 콜백/스케줄러에서 직접 DB 접근
+async with AsyncSessionLocal() as db:
+    db.add(...)
+    await db.commit()
+```
+
+### 설정 싱글톤
+```python
+# ✅ 올바른 방법
+from app.core.config import settings
+value = settings.KIS_MODE
+
+# ❌ 금지
+settings = Settings()
+```
+
+### JSON 직렬화
+```python
+# ✅ 올바른 방법
+from app.core.json_helpers import _dumps
+response = _dumps(data)
+
+# ❌ 금지
+import json
+response = json.dumps(data)
+```
+
+## async 규칙
+
+- `mdd_manager.update()` → `await`
+- `mdd_manager.can_open_new_position()` → `await`
+- `loss_tracker.save_to_db()` → `await`
+- `_save_token_to_cache()` → async (asyncio.to_thread 내부)
+
+## 코딩 규칙
+
+- 기존 함수 시그니처 변경 금지 → 새 버전은 `_v2`, `_v3` 접미사
+- 새 엔드포인트는 `main.py`의 `app.include_router()`에 등록
+- Alembic 마이그레이션: 모델 변경 시 `alembic revision --autogenerate` 실행
+- EOD 강제 청산: 15:20 (market_schedule.is_eod_flat_time)