WBS-7.3/7.4/7.5/7.11: 거버넌스 문서 정합성 정리 + spec-코드 동기화 게이트

2026-06-21 비판적 리뷰에서 spec/governance YAML이 코드 상태와 어긋난
채로 방치되던 3개 구체적 사례를 발견하고 정정했다. 근본 원인(동기화를
보장하는 장치 없음)에 대응하는 신규 CI 게이트도 함께 추가한다.

- spec/aliases.yaml: deprecated alias 17건 제거(활성 참조 0건 확인 후,
  2026-06-30 데드라인 전). role: deprecated_redirect인 spec/03_risk_policy.yaml,
  spec/04_strategy_rules.yaml 2개만 실삭제 — spec/06_exit_policy.yaml은
  role: compatibility_index(영구유지 설계)였음을 재확인해 보존
- governance/gas_logic_migration_ledger_v1.yaml: 존재하지 않는 파일을
  canonical 구현으로 인용하던 오류 2건 발견·정정, parity 테스트 부재로
  GAS 코드 삭제 보류(F12/F13/F14)
- spec/13_formula_registry.yaml: OVERHANG_PRESSURE_V1의 "-500000"
  절대값 폴백을 avg_volume_5d 비례식으로 교체(EXPERT_PRIOR 등록)
- tools/validate_specs.py: validate_spec_code_sync() 신규 — has_code_implementation/
  code_path 필드가 있는 spec만 검사(점진적 롤아웃, 기존 PASS 상태 비파괴),
  12개 파일 1차 태깅
This commit is contained in:
2026-06-21 20:08:48 +09:00
parent ee4d1fdab8
commit 5166750b53
25 changed files with 351 additions and 165 deletions
-32
View File
@@ -1,32 +0,0 @@
meta:
title: "은퇴자산포트폴리오 — 전략 규칙 호환 인덱스 (redirect-only)"
parent_file: "RetirementAssetPortfolio.yaml"
version: "2026-05-17-phase3_redirect_clarified"
language: "ko-KR"
timezone: "Asia/Seoul"
role: "deprecated_redirect"
warning: >
이 파일은 경로 호환성 유지 전용입니다. 새 규칙·임계값 추가 금지.
실제 전략 규칙은 아래 canonical_split_files를 직접 참조하십시오.
canonical_split_files:
sector_model: "spec/strategy/sector_model.yaml"
entry_timing_guardrails: "spec/strategy/entry_gates.yaml"
anti_late_trade_rule: "spec/strategy/entry_gates.yaml"
stock_model: "spec/strategy/stock_model.yaml"
rebalancing_trigger: "spec/strategy/rebalancing_trigger.yaml"
legacy_path_aliases:
"spec/04_strategy_rules.yaml:sector_model": "spec/strategy/sector_model.yaml:sector_model"
"spec/04_strategy_rules.yaml:entry_timing_guardrails": "spec/strategy/entry_gates.yaml:entry_timing_guardrails"
"spec/04_strategy_rules.yaml:anti_late_trade_rule": "spec/strategy/entry_gates.yaml:anti_late_trade_rule"
"spec/04_strategy_rules.yaml:stock_model": "spec/strategy/stock_model.yaml:stock_model"
"spec/04_strategy_rules.yaml:rebalancing_trigger": "spec/strategy/rebalancing_trigger.yaml:rebalancing_trigger"
migration_rule:
- "신규 참조는 반드시 canonical_split_files의 경로를 사용한다."
- "기존 문서/예시에서 legacy path가 남아 있으면 alias로 해석하되, 수정 시 새 경로로 교체한다."
- "이 파일에는 수치 임계값을 추가하지 않는다."
validation:
- "python tools/validate_specs.py"