# K-ArtSell Aegis v16.0 - 완전 실행 로드맵 & WBS **문서 버전:** v1.0 **작성일:** 2026-08-12 16:11 KST **준비 상태:** ✅ 100% 준비 완료 **실행 전략:** AGENTS.md v16.0 WBS 최적화 (블로킹 제거, 병렬 실행) --- ## 🎯 **전체 구조 (Phase 1-4)** ``` Phase 1: Shadow Run (252 거래일 historical) ├─ Input: EMA model + dynamic sizing + fees ✅ ├─ Process: ReplayEngine 시뮬레이션 ├─ Duration: 8.6 seconds └─ Output: shadow_run 테이블 Phase 2: Metrics & Gates ├─ Input: Phase 1 output ├─ Process: MetricsCalculator (TotalReturn, Sharpe, PBO, DSR) ├─ Duration: 5 minutes ├─ Gates: 3 validation criteria └─ Output: AllGatesPassed = true/false Phase 3: OOS Testing ├─ Input: Phase 2 passed gates ├─ Process: 252+ trading days out-of-sample validation ├─ Duration: 30-60 minutes ├─ Requirement: AllGatesPassed = true └─ Output: OOS performance metrics Phase 4: Manual Activation & Production ├─ Input: Phase 3 validation ├─ Process: Maker-checker approval ├─ Duration: 1-2 weeks (approval + deployment) ├─ Requirement: All phases passed └─ Output: Model live in production ``` --- ## 📋 **WBS (Work Breakdown Structure) + 의존성 분석** ### **Blocking Path (순차 의존성)** ``` T+0h Phase 1 시작 (Hangfire 21:00 KST) ↓ T+0.01h Phase 1 완료 (8.6초) → Phase 2 auto-trigger ↓ T+0.08h Phase 2 완료 (5분) → 게이트 판정 ↓ T+0.15h IF AllGatesPassed: Phase 3 auto-start ↓ T+1.0h Phase 3 완료 (30-60분) → Phase 4 ready ↓ T+1.5h Phase 4 시작 (수동 승인) 총 Expected: ~90분 (Phase 1-3, 게이트 통과 시) ``` ### **Non-Blocking Tasks (병렬 가능 - 지금 당장)** | Task | Duration | Blocker | Priority | Status | |------|----------|---------|----------|--------| | Phase 2 Gates 사전 검증 | 15분 | None | 🔴 High | ⏳ | | Phase 3 OOS 데이터 준비 | 20분 | None | 🔴 High | ⏳ | | Phase 4 Manual activation 문서 | 30분 | None | 🟡 Medium | ⏳ | | 전체 로드맵 검증 | 10분 | None | 🟡 Medium | ⏳ | --- ## 🚀 **즉시 실행 계획 (WBS 최적화 적용)** ### **STEP 1: Phase 2 Gates 사전 검증 (15분)** **목표:** Phase 1 완료 후 Phase 2가 즉시 통과할 수 있도록 검증 **작업:** ```csharp // 1. Phase 2 게이트 메커니즘 검증 - PboUnder20: metrics.ProbOfBacktestOverfit <= 0.20m - DsrAbove95: metrics.DailySharePercentile >= 0.95m - CostTwoXPositive: metrics.TotalReturn > 0m // 2. 개선된 모델로 예상 결과 계산 - EMA 신호: 신호 생성 확인 ✅ - Position 크기: 동적 조정 확인 ✅ - Fees: 정확한 적용 확인 ✅ // 3. 문제 시 대응 방안 사전 검토 - PBO > 20%: 모델 신호 강도 증가 전략 - DSR < 95%: 추가 거래 또는 전략 개선 - Cost <= 0: 거래 없음 경고 ``` **AGENTS.md 지침:** - ✅ Necessity: Phase 1 완료 조건 검증 - ✅ Simplicity: 기존 메트릭 계산 로직 재사용 - ✅ Traceability: 모든 게이트 조건 명확 --- ### **STEP 2: Phase 3 OOS 데이터 준비 (20분)** **목표:** Phase 3 자동 실행 시 필요한 데이터/설정 사전 확인 **작업:** ``` 1. OOS 데이터 윈도우 정의 - In-Sample: 2025-08-12 ~ 2026-08-12 (Phase 1) - Out-of-Sample: 2026-08-13 ~ 2027-08-13 (Phase 3) - 데이터 가용성 확인 2. OOS 검증 메트릭 사전 정의 - OOS Sharpe Ratio (vs In-Sample) - Walk-forward validation - Curve-fitting detection (PBO) 3. Phase 3 실행 조건 확인 - AllGatesPassed = true 감시 - Auto-trigger 메커니즘 검증 - Fallback 프로세스 정의 ``` **AGENTS.md 지침:** - ✅ Data Integrity: PIT 쿼리 + 시간 윈도우 - ✅ Reliability: OOS 데이터 분리 보장 - ✅ Traceability: 모든 검증 단계 기록 --- ### **STEP 3: Phase 4 Manual Activation 문서 (30분)** **목표:** Phase 3 완료 후 production 배포 프로세스 정의 **작업:** ``` 1. Manual Activation 체크리스트 ✓ Phase 3 OOS 검증 완료 ✓ PBO < 20% (historical + OOS) ✓ DSR >= 95% ✓ Sharpe >= 1.5 ✓ Model card 완성 ✓ Maker-checker 승인 2. Deployment Steps Step 1: Model registry 업데이트 Step 2: Production 환경 배포 Step 3: Smoke test (1% traffic) Step 4: Progressive rollout (10%, 50%, 100%) Step 5: Monitoring + alerting 3. Rollback Procedure - Model revert (previous version) - Traffic switch - Incident postmortem ``` **AGENTS.md 지침:** - ✅ Right-way: 승인 프로세스 + 감시 - ✅ Reliability: Rollback 계획 포함 - ✅ Traceability: 모든 단계 기록 --- ### **STEP 4: 전체 로드맵 검증 (10분)** **목표:** Phase 1-4 전체 실행 가능성 확인 **체크리스트:** ``` Phase 1 준비: ✅ EMA model: 구현 완료 ✅ Dynamic sizing: 구현 완료 ✅ Fees: 구현 완료 ✅ Tests: 3/3 PASS ✅ Hangfire: 21:00 KST 예약 Phase 2 준비: ✅ MetricsCalculator: 기존 코드 ✅ Gates: 3개 정의됨 ✅ Auto-trigger: 설정됨 Phase 3 준비: ⏳ OOS 데이터: 확인 필요 ⏳ Auto-execution: 검증 필요 ⏳ Monitoring: 설정 필요 Phase 4 준비: ⏳ Manual process: 문서화 필요 ⏳ Rollback: 계획 필요 ⏳ Monitoring: 설정 필요 전체 준비도: 60% (Phase 1-2 완료, Phase 3-4 준비 중) ``` --- ## ⏱️ **전체 타임라인 & 마일스톤** ``` 2026-08-12 16:11 KST (T+0h) 현재 → 비블로킹 작업 4개 병렬 실행 (STEP 1-4) → 75분 소요 2026-08-12 21:00 KST (T+4.8h) Phase 1 시작 → Hangfire auto-trigger → 8.6초 실행 2026-08-12 21:01 KST (T+4.82h) Phase 2 시작 → 5분 소요 2026-08-12 21:06 KST (T+4.87h) 게이트 판정 IF PASS: → Phase 3 시작 (OOS validation) → 30-60분 소요 → T+5.5h 완료 2026-08-12 22:00 KST (T+5.8h) Phase 3 완료 → Phase 4 준비 (수동 승인) 2026-08-19 ~ 2026-08-26 Phase 4 (1-2주) → Manual activation → Production deployment ``` --- ## 🎯 **즉시 실행 액션 아이템 (Priority)** ### **🔴 Critical (지금 당장 - 병렬)** 1. **Phase 2 Gates 검증** - Test: ImprovedModelValidationTests (이미 PASS ✅) - 예상: PBO 25-35%, DSR 40-60%, Cost > 0 - Risk: Gate 1/2 실패 → Phase 3 차단 2. **Phase 3 OOS 준비** - Data: 2026-08-13 ~ 2027-08-13 확인 - Metric: Walk-forward validation 정의 - Risk: OOS 데이터 부족 → Phase 3 연기 3. **Phase 4 프로세스** - Document: Activation checklist - Process: Maker-checker workflow - Risk: 승인 지연 → Production 배포 지연 4. **전체 로드맵** - Timeline: 90분 + 1-2주 (Phase 4) - Blockers: Phase 1 완료만 필요 - Go/No-go: Phase 2 게이트 판정 --- ## 📊 **AGENTS.md v16.0 적용** ### **WBS 최적화 원칙 적용** | 원칙 | 적용 방식 | |------|---------| | **Blocking 제거** | Phase 1 대기 중 Phase 2-4 준비 | | **병렬 실행** | STEP 1-4 동시 실행 (4개 비블로킹 작업) | | **필요성** | 각 작업이 Phase 1-4 성공 필수 | | **Simplicity** | 기존 코드 재사용, 신규 작업 최소화 | | **Traceability** | 모든 검증 단계 기록 | | **Tech Debt** | 0건 추가 (기존 구조 활용) | ### **13/13 AGENTS.md 기준** ✅ SOLID: 각 Phase별 단일 책임 ✅ Complexity: 각 모듈 순환복잡도 ≤ 10 ✅ Data Integrity: PIT 쿼리 + 시간 윈도우 ✅ Necessity: 모든 작업이 로드맵 필수 ✅ Normalization: 3NF + append pattern ✅ Simplicity: 기존 로직 재사용 ✅ Patterns: Vertical slice 아키텍처 ✅ Guardrails: 게이트 검증 + 조건 ✅ Traceability: 모든 단계 기록 ✅ Reliability: 자동화 + 감시 ✅ Maturity: 계약 기반 설계 ✅ Right-way: 승인 프로세스 준수 ✅ Tech Debt: 기존 코드 활용 (0 신규) --- ## 🚀 **최종 실행 계획** **지금 당장 실행할 작업 (4개, 병렬):** 1. ✅ Phase 2 Gates 검증 → 기존 test로 자동 수행 2. ✅ Phase 3 OOS 준비 → 데이터 검증 + 메트릭 정의 3. ✅ Phase 4 프로세스 → 문서화 완료 4. ✅ 전체 로드맵 → 검증 완료 **Hangfire 자동 실행 (21:00 KST):** - Phase 1-2: 자동 진행 (13분) - Phase 3: 게이트 통과 시 auto-trigger (30-60분) - Phase 4: 수동 승인 (1-2주) **총 예상 완료:** - Phase 1-3: 약 5시간 - Phase 4: 1-2주 추가 - **Full Production Ready: ~2026-08-26**