Files
QuantEngineByItz/spec/57_shadow_promotion_scorecard.yaml
kjh2064 366a6da825 WBS-8.7: spec-코드 동기화 100% 완료
모든 spec 파일에 has_code_implementation 메타데이터 추가:
- 140개 spec 파일 중 100% 태깅 완료
- 코드 참조 자동 판정 (formula_registry, decision_flow, routing 등)
- tag_spec_code_implementation.py: 자동화 도구 추가

진행률: 66.4% → 100%

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-06-23 00:22:28 +09:00

66 lines
2.3 KiB
YAML

acceptance_criteria:
- live_sample_count_gte_30: true
- edge_improvement_positive: true
- drawdown_not_worse: true
- conflict_rate_within_cap: true
authority: spec/57_shadow_promotion_scorecard.yaml
code_path: tools/build_shadow_promotion_scorecard_v1.py
contract_id: H007_SHADOW_PROMOTION_SCORECARD
created_at: '2026-06-10T23:29:00+09:00'
forbidden_promotion_shortcuts:
- replay 성과를 live 성과로 혼용하여 승격 기준 달성 금지
- shadow 단계를 건너뛰고 바로 active 승격 금지
- LLM narrative로 promotion gate 완화 금지
- live_sample_count < 30인 팩터에 PASS_100 등급 부여 금지
harness_file: tools/build_shadow_promotion_scorecard_v1.py
has_code_implementation: true
inputs:
- field: shadow_ledger_v2.json
required: true
source: Temp/shadow_ledger_v2.json
- field: live_replay_separation_v3.json
required: true
source: Temp/live_replay_separation_v3.json
lifecycle_state: active
meta:
has_code_implementation: false
output_fields:
- description: 승격 가능 팩터 목록 (live_sample >= 30 and all gates pass)
name: promotion_candidates
type: list[dict]
- description: 승격 차단 팩터 목록과 차단 사유
name: blocked_factors
type: list[dict]
- enum:
- PASS
- FAIL
- WARN
name: gate
type: str
owner: quant_researcher
promotion_gate_criteria:
conflict_rate_cap:
max_conflict_rate_pct: 10.0
note: 다른 active 팩터와 충돌하는 신호 비율
drawdown_constraint:
rule: 신규 팩터 적용 후 portfolio max drawdown이 기존 대비 악화되지 않아야 한다
tolerance_pct: 0.5
edge_improvement:
metric: prediction_match_rate_improvement
minimum_delta_pct: 2.0
note: replay 표본은 포함하지 않는다. live 표본만 집계한다.
false_positive_reduction:
minimum_reduction_pct: 5.0
note: false positive = 매수 추천했으나 T+5 기준 손실 발생 건
live_sample_count_minimum: 30
provenance_coverage:
required_pct: 100.0
purpose: '신규 팩터를 active로 올릴지 수치로 판단한다. live 표본 30개 미만, 또는 drawdown 악화, 또는 conflict
비율 초과 시 active 승격을 차단한다.
'
retirement_condition: '팩터 승격 체계를 전면 재설계하는 계약이 등장할 때까지 유효하다.
'
schema_version: shadow_promotion_scorecard.v1