Files
QuantEngineByItz/spec/53_factor_conflict_matrix.yaml
kjh2064 4b1a33ba48 WBS-7.11 2차 확장: spec-코드 동기화 태깅 12→20개 (7.5%→12.5%)
이미 harness_file:/python_tool:/validator: 필드로 1:1 코드 매핑을
스스로 명시하고 있던 H001~H008 결정론적 하네스 계약 7개(spec/52~58)와
spec/32(canonical_artifact_resolver), spec/37(evaluation_dashboard_contract)에
has_code_implementation/code_path를 추가했다. 모든 대상 파일의 code_path
실존을 사전 확인했다.

governance/rules/00~05, spec/40·45·46·gas_adapter_contract 등 다중 구현체에
걸친 계약은 단일 code_path로 환원하면 거짓 1:1 매핑이 되므로 의도적으로
제외했다(WBS-7.11 핵심 원칙 유지).
2026-06-22 01:36:55 +09:00

70 lines
2.3 KiB
YAML

schema_version: factor_conflict_matrix.v1
contract_id: H002_FACTOR_CONFLICT_MATRIX
harness_file: tools/validate_factor_conflict_matrix_v1.py
has_code_implementation: true
code_path: "tools/validate_factor_conflict_matrix_v1.py"
authority: spec/53_factor_conflict_matrix.yaml
created_at: '2026-06-10T23:29:00+09:00'
purpose: >
스마트머니/펀더멘털/모멘텀/리스크 팩터 충돌 시 우선순위를 자동으로 판정한다.
미해결 충돌이 있으면 릴리즈를 차단한다.
conflict_precedence_rules:
- rank: 1
family: portfolio_risk_budget
rationale: 현금방어선·MDD 상한은 어떤 alpha 신호보다 우선한다
- rank: 2
family: execution_quality
rationale: 주문 불가 상태(틱 오류·현금 부족)는 매수/매도 모두 차단한다
- rank: 3
family: entry_timing
rationale: 추격매수 방지 gate는 smart money 신호보다 우선한다
- rank: 4
family: smart_money_liquidity
rationale: 외국인/기관 신호가 fundamental 신호보다 선행성이 높다
- rank: 5
family: fundamental_quality
rationale: 장기 생존력 신호
- rank: 6
family: market_regime
rationale: 거시 위험 판단으로 포지션 스케일 조정
- rank: 7
family: exit_value_preservation
rationale: 수익금 보전 신호
inputs:
- field: factor_lifecycle_registry.yaml
source: spec/factor_lifecycle_registry.yaml
required: true
- field: final_decision_packet_active.json
source: Temp/final_decision_packet_active.json
required: true
output_fields:
- name: conflict_matrix
type: list[dict]
description: 충돌 팩터 쌍과 우선순위 결과
- name: unresolved_conflict_count
type: int
description: 우선순위 미정의 충돌 수
- name: gate
type: str
enum: [PASS, FAIL]
acceptance_criteria:
- conflict_precedence_defined_for_every_active_factor: true
- unresolved_conflict_count: 0
hard_gates:
- gate_id: CONFLICT_RESOLVED
condition: unresolved_conflict_count == 0
on_fail: BLOCK_RELEASE
- gate_id: PRECEDENCE_COMPLETE
condition: every active factor has conflict_precedence rank
on_fail: BLOCK_RELEASE
owner: quant_architect
lifecycle_state: active
retirement_condition: >
팩터 충돌 해소 체계를 전면 재설계하는 계약이 등장할 때까지 유효하다.