KArtSell.Aegis/ROADMAP_WBS_EXECUTION_PLAN.md

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가 즉시 통과할 수 있도록 검증

작업:

// 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