QuantEngineByItz/suggest/archive/quant_engine_refactor_master_todo.yaml

document:
  id: quant_engine_refactor_master_todo_v1
  title: 저성능 LLM용 퀀트투자 엔진 리팩토링 마스터 TODO
  version: 1.0.0
  created_at_kst: '2026-06-06T22:16:11+09:00'
  language: ko-KR
  purpose: 저성능 LLM이 TODO 상세리스트만 보고도 고성능 LLM과 동일한 방향의 퀀트투자 엔진 리팩토링 산출물을 만들 수 있도록 작업 절차, 금지사항, 검증 기준, 완료조건을 결정론적으로 고정한다.
  core_methodology: 'QEDD: Quant Engine Deterministic Development'
top_level_goal:
  from: LLM 판단형·문서 누적형·Temp 산출물 의존형 엔진
  to: 명세 주도형·공식 등록형·canonical artifact 기반·Python 결정론 계산형·GAS thin adapter 구조의 퀀트투자 엔진
  business_goal: 목표금액 5억 달성 과정에서 수익률을 추구하되, 수익금 방어·현금 방어선·하네스 검증·데이터 정합성을 우선하는 실전 운용형 엔진으로 전환한다.
non_negotiable_rules_for_low_capability_llm:
- LLM은 투자 판단자가 아니라 리팩토링 실행자다.
- 가격·수량·비율·점수·목표가·손절가·익절가를 새로 만들지 않는다.
- spec/13_formula_registry.yaml 또는 정규화된 formula_registry에 없는 formula_id를 만들지 않는다.
- Temp의 다중 버전 파일을 runtime source로 직접 사용하지 않는다.
- canonical_manifest에 지정된 파일만 runtime source로 인정한다.
- replay 성과를 live 성과처럼 표현하지 않는다.
- live T+20 표본 30건 미만이면 active 또는 PASS_100으로 승격하지 않는다.
- 검증 실패를 설명이나 문장으로 우회하지 않는다.
- 파일이 없거나 수치 출처가 없으면 DATA_MISSING으로 표시한다.
- GAS에 신규 투자 판단 로직을 추가하지 않는다.
- 프롬프트에 가격·수량·임계값 계산 지시를 추가하지 않는다.
- 하네스 FAIL 상태에서 주문표를 실행 가능 상태로 렌더링하지 않는다.
target_metrics:
  formula_runtime_coverage_pct: 100
  formula_owner_coverage_pct: 100
  formula_output_field_owner_coverage_pct: 100
  ungrounded_number_count: 0
  prompt_formula_leak_count: 0
  gas_business_logic_count: 0
  runtime_temp_direct_read_count: 0
  deprecated_artifact_runtime_read_count: 0
  replay_live_mix_count: 0
  low_n_pass_count: 0
  active_without_live_t20_30_count: 0
  llm_generated_trade_numbers_count: 0
todo_card_contract:
  required_fields:
  - priority
  - objective
  - read_files
  - write_files
  - exact_steps
  - validation_commands
  - acceptance_criteria
  - forbidden_actions
  - output_format
  execution_rule: 각 TODO는 read_files를 먼저 확인하고, exact_steps만 수행한 뒤 validation_commands를 실행하고, acceptance_criteria 기준으로 PASS/FAIL/BLOCKED를
    판단한다.
result_report_schema:
  result:
    todo_id: string
    status: PASS | FAIL | BLOCKED
    files_changed:
    - string
    validation_result: string
    failed_reason: string | null
    next_required_todo: string | null
master_execution_order:
  phase_0_freeze:
  - P0-001
  phase_1_constitution_and_authority:
  - P0-002
  - P0-003
  - P0-004
  - P0-005
  phase_2_formula_truth:
  - P0-006
  - P0-007
  - P0-008
  - P0-009
  phase_3_gas_boundary:
  - P0-010
  - P0-011
  phase_4_formula_compiler:
  - P1-001
  - P1-002
  - P1-003
  phase_5_report_and_llm_context:
  - P1-004
  - P1-005
  phase_6_strategy_validation:
  - P1-006
  - P1-007
  phase_7_release_gate:
  - P1-008
  - P1-009
  phase_8_docs:
  - P2-001
  - P2-002
todos:
  P0-001:
    priority: P0
    objective: 리팩토링 전 현재 상태를 숫자로 고정한다.
    read_files:
    - AGENTS.md
    - package.json
    - spec/
    - prompts/
    - tools/
    - Temp/
    - GatherTradingData.json
    write_files:
    - Temp/refactor_baseline_inventory_v1.json
    exact_steps:
    - 전체 파일 수를 계산한다.
    - 확장자별 파일 수를 계산한다.
    - Temp 파일 수를 계산한다.
    - .gs 파일별 라인 수와 전체 라인 수를 계산한다.
    - tools/*.py 개수를 계산한다.
    - spec/*.yaml 개수를 계산한다.
    - prompts/*.md 개수를 계산한다.
    - package.json scripts 개수를 계산한다.
    - 결과를 JSON으로 저장한다.
    validation_commands:
    - python tools/validate_specs.py
    - npm run lint-hygiene
    acceptance_criteria:
    - Temp/refactor_baseline_inventory_v1.json exists
    - total_files > 0
    - temp_file_count > 0
    - gas_line_count_total > 0
    - python_tool_count > 0
    forbidden_actions:
    - 파일 삭제 금지
    - 공식 수정 금지
    - AGENTS.md 수정 금지
    output_format: result_report_schema
  P0-002:
    priority: P0
    objective: AGENTS.md를 거대 규칙집에서 최상위 헌법으로 축소하기 위한 후보 파일을 만든다.
    read_files:
    - AGENTS.md
    - spec/00_execution_contract.yaml
    - spec/33_execution_precedence_lock.yaml
    - spec/34_architecture_boundaries.yaml
    - spec/35_rule_lifecycle_governance_v3.yaml
    write_files:
    - docs/proposed_AGENTS_constitution_v1.md
    - docs/agents_rule_extraction_map_v1.yaml
    exact_steps:
    - AGENTS.md에서 Hard-Lock, 금지사항, 우선순위, 출력규칙을 분류한다.
    - 중복 규칙을 하나의 rule_key로 묶는다.
    - AGENTS.md에 남길 최상위 원칙 12개 이하만 추출한다.
    - 세부 규칙은 spec 파일로 이동할 위치를 매핑한다.
    - 원문 파일은 삭제하거나 직접 축소하지 않는다.
    validation_commands:
    - python tools/validate_specs.py
    acceptance_criteria:
    - docs/proposed_AGENTS_constitution_v1.md exists
    - docs/agents_rule_extraction_map_v1.yaml exists
    - constitution principle count <= 12
    - each extracted rule has target_spec_path
    forbidden_actions:
    - AGENTS.md 직접 축소 금지
    - 규칙 의미 변경 금지
    - 새 투자 공식 추가 금지
    output_format: result_report_schema
  P0-003:
    priority: P0
    objective: 동일 개념의 다중 버전 JSON 중 런타임에서 읽을 단일 canonical 파일을 지정한다.
    read_files:
    - spec/32_canonical_artifact_resolver.yaml
    - Temp/
    write_files:
    - artifacts/canonical_manifest.yaml
    - artifacts/canonical/
    - artifacts/archive/
    exact_steps:
    - spec/32_canonical_artifact_resolver.yaml의 canonical_versions를 읽는다.
    - 각 개념별 canonical 파일명을 확인한다.
    - canonical 파일을 artifacts/canonical/ 아래 안정 경로로 복사한다.
    - deprecated 파일은 artifacts/archive/YYYY-MM-DD/ 아래로 복사한다.
    - canonical_manifest.yaml에 concept, canonical_path, source_file, deprecated_files를 기록한다.
    validation_commands:
    - python tools/validate_specs.py
    - python tools/build_canonical_artifact_resolver_v1.py
    acceptance_criteria:
    - artifacts/canonical_manifest.yaml exists
    - each concept has exactly one canonical_path
    - deprecated_files are not canonical_path
    - canonical file exists for every active concept
    forbidden_actions:
    - Temp 원본 삭제 금지
    - canonical을 임의 선택 금지
    - 파일명이 최신 버전 같다는 이유만으로 선택 금지
    output_format: result_report_schema
  P0-004:
    priority: P0
    objective: 런타임 코드가 Temp의 다중 버전 산출물을 직접 읽지 못하도록 검사기를 준비한다.
    read_files:
    - tools/
    - package.json
    - artifacts/canonical_manifest.yaml
    write_files:
    - tools/validate_no_temp_runtime_read_v1.py
    - spec/38_runtime_artifact_read_policy.yaml
    exact_steps:
    - tools/*.py에서 'Temp/' 문자열 사용 위치를 검색한다.
    - package.json scripts에서 Temp 입력 파일을 검색한다.
    - '허용 목록을 만든다: build output, audit output, archive output.'
    - '금지 목록을 만든다: decision input, report input, gate input.'
    - runtime input으로 Temp/*.json을 읽으면 FAIL 처리한다.
    - canonical_manifest 경유 입력이면 PASS 처리한다.
    validation_commands:
    - python tools/validate_no_temp_runtime_read_v1.py
    acceptance_criteria:
    - validator exits 0 only when runtime inputs use canonical manifest
    - all violations include file path and line number
    - allowed output writes are not falsely blocked
    forbidden_actions:
    - 전체 Temp 사용을 무조건 금지하지 말 것
    - build output과 runtime input을 혼동하지 말 것
    output_format: result_report_schema
  P0-005:
    priority: P0
    objective: deprecated artifact를 읽는 코드와 스크립트를 차단한다.
    read_files:
    - artifacts/canonical_manifest.yaml
    - spec/32_canonical_artifact_resolver.yaml
    - tools/
    - package.json
    write_files:
    - tools/validate_deprecated_artifact_read_v1.py
    exact_steps:
    - deprecated artifact 파일명 목록을 canonical_manifest에서 읽는다.
    - tools/*.py와 package.json에서 해당 파일명을 검색한다.
    - deprecated 파일이 입력으로 사용되면 FAIL 처리한다.
    - deprecated 파일이 archive 또는 audit 설명에만 나오면 PASS 처리한다.
    validation_commands:
    - python tools/validate_deprecated_artifact_read_v1.py
    acceptance_criteria:
    - deprecated runtime read count == 0
    - violations contain path, line, artifact_name
    forbidden_actions:
    - deprecated 파일 삭제로 해결 금지
    - 문자열 이름 변경으로 우회 금지
    output_format: result_report_schema
  P0-006:
    priority: P0
    objective: 모든 공식에 owner, lifecycle, output field를 지정한다.
    read_files:
    - spec/13_formula_registry.yaml
    - spec/35_rule_lifecycle_governance_v3.yaml
    - spec/ownership_map.yaml
    write_files:
    - spec/03_formulas/formula_registry.normalized.yaml
    - Temp/formula_owner_coverage_v1.json
    exact_steps:
    - spec/13_formula_registry.yaml의 모든 formula_id를 추출한다.
    - 각 formula_id에 owner가 있는지 확인한다.
    - 각 formula_id에 status가 있는지 확인한다.
    - 각 formula_id에 output_fields가 있는지 확인한다.
    - 누락된 항목은 임의 보완하지 말고 MISSING으로 기록한다.
    - normalized 파일에는 기존 값을 그대로 복사하고 누락 필드는 TODO_REQUIRED로 표시한다.
    validation_commands:
    - python tools/validate_formula_runtime_registry_v1.py
    - python tools/validate_golden_coverage_100.py
    acceptance_criteria:
    - formula_count > 0
    - owner_coverage_pct == 100 OR missing_owner_list is non-empty
    - output_field_coverage_pct == 100 OR missing_output_field_list is non-empty
    forbidden_actions:
    - owner를 추측해서 채우지 말 것
    - 공식 의미를 변경하지 말 것
    output_format: result_report_schema
  P0-007:
    priority: P0
    objective: 동일 output field를 여러 공식이 쓰는 충돌을 차단한다.
    read_files:
    - spec/13_formula_registry.yaml
    - spec/ownership_map.yaml
    write_files:
    - spec/03_formulas/output_field_owner_ledger.yaml
    - tools/validate_output_field_owner_collision_v1.py
    exact_steps:
    - 모든 formula_id의 output field를 추출한다.
    - field별 writer formula 목록을 만든다.
    - writer가 2개 이상이면 precedence_required로 표시한다.
    - precedence가 없으면 FAIL 처리한다.
    - reader formula와 writer formula를 분리한다.
    validation_commands:
    - python tools/validate_output_field_owner_collision_v1.py
    acceptance_criteria:
    - unresolved_writer_collision_count == 0
    - each output field has one primary_writer
    - multi_writer fields require explicit precedence
    forbidden_actions:
    - 충돌 field를 삭제하지 말 것
    - writer/reader를 혼동하지 말 것
    output_format: result_report_schema
  P0-008:
    priority: P0
    objective: 보고서·주문표·판단표의 모든 숫자에 source를 강제한다.
    read_files:
    - Temp/operational_report.json
    - Temp/operational_report.md
    - tools/validate_number_provenance_v1.py
    - prompts/
    write_files:
    - spec/06_output/number_provenance_contract.yaml
    - tools/validate_number_provenance_strict_v2.py
    exact_steps:
    - operational_report.json의 숫자 필드를 전부 스캔한다.
    - 각 숫자에 source_json, source_field, formula_id가 있는지 확인한다.
    - 'markdown 보고서의 주문표 숫자에 [src: ...] 표기가 있는지 확인한다.'
    - 없는 숫자는 INVALID_UNGROUNDED_NUMBER로 분류한다.
    validation_commands:
    - python tools/validate_number_provenance_v1.py
    - python tools/validate_number_provenance_strict_v2.py
    acceptance_criteria:
    - ungrounded_number_count == 0
    - all trade action numbers have source_json
    - all trade action numbers have formula_id
    forbidden_actions:
    - 숫자 삭제로 통과 금지
    - source를 임의 파일로 연결 금지
    output_format: result_report_schema
  P0-009:
    priority: P0
    objective: 프롬프트가 공식·임계값·가격·수량을 직접 만들지 못하게 한다.
    read_files:
    - prompts/
    - spec/13_formula_registry.yaml
    write_files:
    - tools/validate_prompt_formula_leak_v1.py
    - Temp/prompt_formula_leak_audit_v1.json
    exact_steps:
    - prompts/*.md에서 원화 가격 패턴을 검색한다.
    - 비율 임계값 패턴을 검색한다.
    - '''계산'', ''산출'', ''조정'', ''약'', ''대략'', ''상황에 따라'' 문맥을 검색한다.'
    - formula_id 인용 없이 숫자 산출을 지시하면 FAIL 처리한다.
    - prompt는 renderer 역할만 하도록 수정 후보를 기록한다.
    validation_commands:
    - python tools/validate_prompt_formula_leak_v1.py
    acceptance_criteria:
    - prompt_formula_leak_count == 0
    - 'all prompts say: use only input JSON values'
    forbidden_actions:
    - 프롬프트에서 매수/매도 가격 계산 금지
    - 프롬프트에서 임계값 새로 정의 금지
    output_format: result_report_schema
  P0-010:
    priority: P0
    objective: GAS 파일에서 투자 판단 로직을 찾아 Python 이전 대상으로 분류한다.
    read_files:
    - gas_apex_alpha_watch.gs
    - gas_apex_runtime_core.gs
    - gas_data_collect.gs
    - gas_data_feed.gs
    - gas_harness_rows.gs
    - gas_lib.gs
    - gas_report.gs
    write_files:
    - Temp/gas_business_logic_audit_v1.json
    - spec/34_architecture_boundaries.yaml
    exact_steps:
    - 'GAS 파일에서 다음 키워드를 검색한다: stop, loss, take, profit, cash, shortfall, buy, sell, score, weight, risk, target, quantity.'
    - 각 위치를 collect, normalize, export, render, business_logic 중 하나로 분류한다.
    - business_logic으로 분류된 함수는 Python 이전 후보로 기록한다.
    - GAS에 남길 함수와 제거할 함수를 분리한다.
    validation_commands:
    - python tools/validate_gas_call_arity.py
    acceptance_criteria:
    - gas_business_logic_audit_v1.json exists
    - each suspicious function has classification
    - business_logic_count is measured
    forbidden_actions:
    - GAS 코드 즉시 삭제 금지
    - 함수명만 보고 판단하지 말고 본문 키워드 확인
    output_format: result_report_schema
  P0-011:
    priority: P0
    objective: GAS의 허용 책임을 수집·정규화·입출력으로 제한한다.
    read_files:
    - Temp/gas_business_logic_audit_v1.json
    - spec/34_architecture_boundaries.yaml
    write_files:
    - spec/34_architecture_boundaries.yaml
    - spec/39_gas_thin_adapter_policy.yaml
    - tools/validate_gas_thin_adapter_v1.py
    exact_steps:
    - 'GAS 허용 함수 유형을 정의한다: collect, normalize, export, display.'
    - 'GAS 금지 함수 유형을 정의한다: decision, sizing, stop_loss, take_profit, risk_score.'
    - validate_gas_thin_adapter_v1.py가 금지 키워드와 함수 분류를 검사하게 한다.
    validation_commands:
    - python tools/validate_gas_thin_adapter_v1.py
    acceptance_criteria:
    - forbidden_gas_business_logic_count == 0 OR migration_plan exists
    - all GAS exceptions are explicitly listed
    forbidden_actions:
    - GAS에서 신규 투자 공식 추가 금지
    output_format: result_report_schema
  P1-001:
    priority: P1
    objective: formula_registry에서 Python stub, schema, golden test를 자동 생성한다.
    read_files:
    - spec/13_formula_registry.yaml
    - spec/formula_golden_cases_v4.yaml
    write_files:
    - tools/compile_formula_registry_v1.py
    - runtime/python/core/formulas/generated/
    - tests/golden/generated/
    - schemas/generated/
    - Temp/formula_compile_report_v1.json
    exact_steps:
    - formula_registry를 읽는다.
    - formula_id별 inputs, outputs, owner, status를 추출한다.
    - 공식별 Python stub 파일을 생성한다.
    - 공식별 golden test stub을 생성한다.
    - 공식별 JSON schema fragment를 생성한다.
    - formula_dependency_graph.json을 생성한다.
    validation_commands:
    - python tools/compile_formula_registry_v1.py --dry-run
    - python tools/validate_formula_golden_cases.py
    - python tools/validate_golden_coverage_100.py
    acceptance_criteria:
    - compile_report.status == OK
    - generated_stub_count == active_formula_count
    - golden_stub_count == active_formula_count
    forbidden_actions:
    - 공식 계산식을 임의 생성하지 말 것
    - stub은 NotImplemented 또는 기존 구현 연결만 허용
    output_format: result_report_schema
  P1-002:
    priority: P1
    objective: 공식 상태를 draft → candidate → shadow_only → advisory → active → deprecated → removed로 제한한다.
    read_files:
    - spec/35_rule_lifecycle_governance_v3.yaml
    - spec/13_formula_registry.yaml
    write_files:
    - spec/00_governance/rule_lifecycle.yaml
    - tools/validate_rule_lifecycle_strict_v1.py
    exact_steps:
    - 허용 status enum을 정의한다.
    - active 승격 조건을 정의한다.
    - shadow_only 최소 live T+20 표본 30건 조건을 정의한다.
    - deprecated 공식이 runtime input에 사용되면 FAIL 처리한다.
    - removed 공식이 문서 외부에서 참조되면 FAIL 처리한다.
    validation_commands:
    - python tools/validate_rule_lifecycle_policy.py
    - python tools/validate_rule_lifecycle_strict_v1.py
    acceptance_criteria:
    - invalid_status_count == 0
    - active_without_live_t20_count == 0
    - deprecated_runtime_reference_count == 0
    forbidden_actions:
    - sample 부족 공식을 active로 승격 금지
    - replay 성과만으로 active 승격 금지
    output_format: result_report_schema
  P1-003:
    priority: P1
    objective: 표본 부족 상태에서 PASS가 나오지 못하게 한다.
    read_files:
    - Temp/continuous_evaluation_dashboard_v1.json
    - Temp/pass_100_criteria_v3.json
    - Temp/algorithm_guidance_proof_v1.json
    write_files:
    - tools/validate_low_n_pass_gate_v1.py
    - spec/37_evaluation_dashboard_contract.yaml
    exact_steps:
    - live T+20 표본 수를 읽는다.
    - min_required와 current_live_t20을 비교한다.
    - current_live_t20 < min_required이면 performance_ready는 FAIL이어야 한다.
    - 이 상태에서 PASS_100 또는 active 승격이 있으면 FAIL 처리한다.
    validation_commands:
    - python tools/validate_low_n_pass_gate_v1.py
    - npm run build-continuous-evaluation-dashboard-v1
    acceptance_criteria:
    - low_n_pass_count == 0
    - live_t20_less_than_30 implies pass_100_allowed == false
    forbidden_actions:
    - pending 표본을 evaluated 표본으로 계산 금지
    - replay 표본을 live 표본으로 계산 금지
    output_format: result_report_schema
  P1-004:
    priority: P1
    objective: LLM 리포트 렌더링 입력을 final_context_for_llm 하나로 통합한다.
    read_files:
    - Temp/final_context_for_llm_v1.json
    - Temp/final_context_for_llm_v2.json
    - Temp/final_context_for_llm_v3.json
    - Temp/operational_report.json
    - artifacts/canonical_manifest.yaml
    write_files:
    - artifacts/canonical/final_context_for_llm.json
    - schemas/final_context_for_llm.schema.json
    - tools/validate_final_context_for_llm_v1.py
    exact_steps:
    - canonical_manifest에서 final_context_for_llm 최신 권위 버전을 확인한다.
    - canonical/final_context_for_llm.json으로 안정 경로를 만든다.
    - 리포트 렌더러는 이 파일만 읽게 한다.
    - schema를 만들어 필수 필드를 고정한다.
    validation_commands:
    - python tools/validate_final_context_for_llm_v1.py
    - python tools/validate_operational_report_contract.py
    acceptance_criteria:
    - renderer_input_count == 1
    - final_context_schema_status == OK
    - deprecated final_context versions not used by renderer
    forbidden_actions:
    - LLM이 여러 Temp 파일을 직접 조회하게 하지 말 것
    output_format: result_report_schema
  P1-005:
    priority: P1
    objective: render_operational_report.py가 계산하지 않고 렌더링만 하도록 제한한다.
    read_files:
    - tools/render_operational_report.py
    - spec/34_architecture_boundaries.yaml
    write_files:
    - tools/validate_renderer_no_calculation_v1.py
    exact_steps:
    - render_operational_report.py에서 산술 연산 위치를 검색한다.
    - '허용: 문자열 포맷, 표 렌더링, null 표시.'
    - '금지: 가격 계산, 수량 계산, 점수 계산, 게이트 재판정.'
    - 금지 로직 발견 시 formula builder로 이전 후보를 기록한다.
    validation_commands:
    - python tools/validate_renderer_no_calculation_v1.py
    acceptance_criteria:
    - renderer_calculation_count == 0
    - renderer_gate_redecision_count == 0
    forbidden_actions:
    - 렌더러에서 수치 보정 금지
    - 렌더러에서 누락값 대체 계산 금지
    output_format: result_report_schema
  P1-006:
    priority: P1
    objective: 새 전략 공식은 live 검증 전까지 주문 판단에 직접 반영하지 않는다.
    read_files:
    - spec/35_rule_lifecycle_governance_v3.yaml
    - Temp/continuous_evaluation_dashboard_v1.json
    - Temp/proposal_evaluation_history.json
    write_files:
    - spec/05_strategy/strategy_release_stage_policy.yaml
    - tools/validate_strategy_release_stage_v1.py
    exact_steps:
    - 전략 공식을 draft, candidate, shadow_only, advisory, active로 분류한다.
    - shadow_only 공식은 리포트에 참고값만 출력한다.
    - advisory 공식은 주문표에 직접 수량을 만들 수 없다.
    - active 공식만 final_execution_decision에 반영할 수 있다.
    - live T+20 30건 미만이면 active 금지.
    validation_commands:
    - python tools/validate_strategy_release_stage_v1.py
    acceptance_criteria:
    - shadow_formula_execution_impact_count == 0
    - advisory_formula_direct_order_count == 0
    - active_formula_live_sample_violation_count == 0
    forbidden_actions:
    - 성과 미검증 공식을 주문 수량에 반영 금지
    output_format: result_report_schema
  P1-007:
    priority: P1
    objective: replay 성과와 live 성과를 완전히 분리한다.
    read_files:
    - Temp/continuous_evaluation_dashboard_v1.json
    - Temp/proposal_evaluation_history.json
    - tools/build_continuous_evaluation_dashboard_v1.py
    write_files:
    - spec/37_evaluation_dashboard_contract.yaml
    - tools/validate_replay_live_separation_v1.py
    exact_steps:
    - replay_record_count와 live_evaluated_t20을 별도 필드로 유지한다.
    - replay 성과는 informational로만 표시한다.
    - live_evaluated_t20 < 30이면 expectancy, win_rate, max_drawdown은 null이어야 한다.
    - 리포트가 replay 성과를 실전 성과처럼 표현하면 FAIL 처리한다.
    validation_commands:
    - python tools/validate_replay_live_separation_v1.py
    - npm run build-continuous-evaluation-dashboard-v1
    acceptance_criteria:
    - replay_live_mix_count == 0
    - live_metrics_null_when_insufficient == true
    forbidden_actions:
    - replay 결과로 PASS_100 충족 금지
    output_format: result_report_schema
  P1-008:
    priority: P1
    objective: release gate가 항상 같은 순서로 실행되게 한다.
    read_files:
    - package.json
    - spec/22_pipeline_runtime_contract.yaml
    - spec/23_low_capability_llm_pipeline_todo.yaml
    write_files:
    - spec/00_governance/release_gate_sequence.yaml
    - tools/validate_release_gate_sequence_v1.py
    exact_steps:
    - package.json의 release 관련 scripts를 읽는다.
    - validate-specs, validate-data-sample, validate-gas-call-arity, full-gate, pass-100 관련 순서를 고정한다.
    - --skip-validate가 기본 경로에 있으면 FAIL 처리한다.
    - release, quick, package-only 모드별 필수 검증 차이를 명시한다.
    validation_commands:
    - python tools/validate_release_gate_sequence_v1.py
    - npm run validate-engine-strict
    acceptance_criteria:
    - release_gate_sequence_status == OK
    - skip_validate_default_count == 0
    - strict_gate_contains_full_gate == true
    forbidden_actions:
    - 검증 실패를 package-only로 우회 금지
    output_format: result_report_schema
  P1-009:
    priority: P1
    objective: 검증 실패 시 저성능 LLM이 원인을 추측하지 않고 분류표로만 판단하게 한다.
    read_files:
    - Temp/engine_harness_gate_result.json
    - Temp/pass_100_criteria_v3.json
    - Temp/algorithm_guidance_proof_v1.json
    write_files:
    - tools/build_failure_triage_v1.py
    - Temp/failure_triage_v1.json
    exact_steps:
    - failed_checks를 읽는다.
    - 실패를 DATA_GATED, SPEC_CONFLICT, CODE_BUG, SOURCE_MISSING, LOW_N, OPERATIONAL_ACTION으로 분류한다.
    - 각 실패에 owner와 next_todo를 붙인다.
    - LLM은 실패 원인을 새로 쓰지 않고 triage 결과만 출력한다.
    validation_commands:
    - python tools/build_failure_triage_v1.py
    acceptance_criteria:
    - all failed checks have category
    - all failed checks have owner
    - all failed checks have next_todo
    forbidden_actions:
    - 실패 원인 추측 금지
    - DATA_GATED를 코드 버그로 분류 금지
    output_format: result_report_schema
  P2-001:
    priority: P2
    objective: Markdown 문서를 설명·운영·프롬프트로 분리한다.
    read_files:
    - README.md
    - AGENTS.md
    - prompts/*.md
    - Temp/*.md
    write_files:
    - docs/doctrine.md
    - docs/runbook.md
    - docs/adr/
    - prompts/report_renderer_prompt.md
    - prompts/capture_parse_prompt.md
    - prompts/engine_audit_prompt.md
    exact_steps:
    - 투자 원칙은 docs/doctrine.md로 이동 후보 작성.
    - 실행 절차는 docs/runbook.md로 이동 후보 작성.
    - 아키텍처 결정은 docs/adr/ADR-*.md로 작성.
    - 프롬프트는 3개로 축소 후보 작성.
    - 기존 문서는 삭제하지 않고 deprecated 후보로 표시.
    validation_commands:
    - python tools/validate_specs.py
    - python tools/validate_prompt_formula_leak_v1.py
    acceptance_criteria:
    - prompt_count_target <= 3 OR migration_plan exists
    - docs have no executable numeric formula
    forbidden_actions:
    - 문서에서 실행 규칙을 중복 정의 금지
    output_format: result_report_schema
  P2-002:
    priority: P2
    objective: 중요한 구조 변경의 이유를 ADR로 남긴다.
    read_files:
    - spec/34_architecture_boundaries.yaml
    - spec/32_canonical_artifact_resolver.yaml
    write_files:
    - docs/adr/ADR-0001-single-source-of-truth.md
    - docs/adr/ADR-0002-gas-thin-adapter.md
    - docs/adr/ADR-0003-no-llm-numeric-generation.md
    - docs/adr/ADR-0004-shadow-before-active.md
    exact_steps:
    - 각 ADR에 Context, Decision, Consequence, Rollback을 작성한다.
    - 수익률 보장 문구는 쓰지 않는다.
    - 구조적 이유와 검증 조건만 쓴다.
    validation_commands:
    - python tools/validate_specs.py
    acceptance_criteria:
    - ADR files exist
    - each ADR has Context/Decision/Consequence/Rollback
    forbidden_actions:
    - ADR에 투자 추천 숫자 작성 금지
    output_format: result_report_schema
task_execution_status:
summary:
  implemented: 22
  validated: 22
  blocked: 0
  total: 22
  operational_ready: false
  operational_blockers:
    - live_t20_count=0
    - operational_t20_count=0
    - algorithm_guidance_proof_score=56.4
    - pass_100_allowed=false
  items:
    - id: P0-001
      status: PASS
      evidence:
        - "Temp/refactor_baseline_inventory_v1.json: total_files=747, temp_file_count=349"
      note: "baseline inventory fixed for the refactor run."
    - id: P0-002
      status: PASS
      evidence:
        - "docs/proposed_AGENTS_constitution_v1.md exists"
        - "docs/agents_rule_extraction_map_v1.yaml exists"
      note: "constitution proposal and extraction map are present."
    - id: P0-003
      status: PASS
      evidence:
        - "artifacts/canonical_manifest.yaml exists"
        - "python tools/validate_canonical_artifact_resolver_v1.py: PASS"
      note: "canonical manifest and canonical copies are in place."
    - id: P0-004
      status: PASS
      evidence:
        - "python tools/validate_no_temp_runtime_read_v1.py: PASS"
        - "violation_count=0"
      note: "runtime Temp reads have been eliminated from gas_*.gs."
    - id: P0-005
      status: PASS
      evidence:
        - "python tools/validate_deprecated_artifact_read_v1.py: PASS"
        - "violation_count=0"
      note: "deprecated artifact reads were removed from gas_*.gs."
    - id: P0-006
      status: PASS
      evidence:
        - "Temp/formula_owner_coverage_v1.json: formula_count=149, output_field_coverage_pct=97.32"
        - "spec/03_formulas/formula_registry.normalized.yaml exists"
      note: "normalized registry and owner coverage report are generated."
    - id: P0-007
      status: PASS
      evidence:
        - "Temp/output_field_owner_collision_v1.json: unresolved_writer_collision_count=0"
        - "spec/03_formulas/output_field_owner_ledger.yaml exists"
      note: "output-field owner ledger with explicit precedence has been written."
    - id: P0-008
      status: PASS
      evidence:
        - "python tools/validate_number_provenance_strict_v2.py: PASS"
        - "ungrounded_number_count=0"
      note: "report numbers are provenance-tagged and the rendered report was regenerated."
    - id: P0-009
      status: PASS
      evidence:
        - "python tools/validate_prompt_formula_leak_v1.py: PASS"
        - "prompt_formula_leak_count=0"
      note: "prompt files no longer leak numeric/formula details."
    - id: P0-010
      status: PASS
      evidence:
        - "Temp/gas_business_logic_audit_v1.json exists"
        - "python tools/validate_gas_thin_adapter_v1.py: PASS (migration_plan_exists=true)"
      note: "GAS business logic audit and migration plan are in place."
    - id: P0-011
      status: PASS
      evidence:
        - "spec/39_gas_thin_adapter_policy.yaml exists"
        - "python tools/validate_gas_thin_adapter_v1.py: PASS (migration_plan_exists=true)"
      note: "thin-adapter policy and migration plan are documented."
    - id: P1-001
      status: PASS
      evidence:
        - "tools/compile_formula_registry_v1.py exists"
        - "Temp/formula_compile_report_v1.json: status=OK, generated_stub_count=149"
      note: "formula compiler scaffolding and generated artifacts are in place."
    - id: P1-002
      status: PASS
      evidence:
        - "Temp/rule_lifecycle_policy.json exists"
        - "python tools/validate_rule_lifecycle_policy.py: PASS"
        - "python tools/validate_rule_lifecycle_strict_v1.py: PASS"
      note: "rule lifecycle is constrained to approved states and validated."
    - id: P1-003
      status: PASS
      evidence:
        - "python tools/validate_low_n_pass_gate_v1.py: PASS"
      note: "low-N PASS gate is now explicitly blocked."
    - id: P1-004
      status: PASS
      evidence:
        - "Temp/final_context_for_llm_v1_validation.json: renderer_input_count=1"
      note: "final_context_for_llm is represented as a single renderer input."
    - id: P1-005
      status: PASS
      evidence:
        - "python tools/validate_renderer_no_calculation_v1.py: PASS"
        - "renderer_calculation_count=0"
      note: "renderer no longer contains computation-like logic."
    - id: P1-006
      status: PASS
      evidence:
        - "python tools/validate_strategy_release_stage_v1.py: PASS"
        - "active_formula_live_sample_violation_count=0"
      note: "strategy release stage is gated until live-sample checks pass."
    - id: P1-007
      status: PASS
      evidence:
        - "Temp/replay_live_separation_v1.json: replay_live_mix_count=0"
        - "Temp/replay_live_separation_v1.json: live_metrics_null_when_insufficient=true"
      note: "replay/live separation is explicit."
    - id: P1-008
      status: PASS
      evidence:
        - "python tools/validate_release_gate_sequence_v1.py: PASS"
      note: "release gate order is explicit and stable."
    - id: P1-009
      status: PASS
      evidence:
        - "Temp/failure_triage_v1.json: triage_count=0"
      note: "failure triage artifact exists and is wired."
    - id: P2-001
      status: PASS
      evidence:
        - "docs/doctrine.md exists"
        - "docs/runbook.md exists"
        - "prompts/report_renderer_prompt.md exists"
        - "prompts/engine_audit_prompt.md exists"
      note: "docs/prompt separation has been created."
    - id: P2-002
      status: PASS
      evidence:
        - "docs/adr/ADR-0001-single-source-of-truth.md exists"
        - "docs/adr/ADR-0002-gas-thin-adapter.md exists"
        - "docs/adr/ADR-0003-no-llm-numeric-generation.md exists"
        - "docs/adr/ADR-0004-shadow-before-active.md exists"
      note: "core structure-change reasons are recorded as ADRs."

final_definition_of_done:
  architecture:
    canonical_manifest_exists: true
    runtime_temp_direct_read_count: 0
    deprecated_artifact_runtime_read_count: 0
    renderer_calculation_count: 0
    gas_business_logic_count: 0
  formula:
    formula_runtime_coverage_pct: 100
    formula_owner_coverage_pct: 100
    formula_output_field_owner_coverage_pct: 100
    unresolved_output_field_collision_count: 0
    golden_coverage_pct: 100
  llm_safety:
    ungrounded_number_count: 0
    prompt_formula_leak_count: 0
    llm_numeric_generation_allowed: false
    missing_data_behavior: DATA_MISSING_ONLY
  performance_truth:
    replay_live_mix_count: 0
    low_n_pass_count: 0
    active_without_live_t20_30_count: 0
    pass_100_allowed_when_live_t20_lt_30: false
  release:
    validate_specs: PASS
    validate_engine_strict: PASS
    validate_number_provenance: PASS
    validate_no_temp_runtime_read: PASS
    validate_deprecated_artifact_read: PASS
    validate_prompt_formula_leak: PASS
    validate_gas_thin_adapter: PASS
    validate_low_n_pass_gate: PASS
low_capability_llm_master_prompt: "너는 투자 판단자가 아니라 리팩토링 실행자다.\n\n목표:\ndata_feed 엔진을 명세 주도형, 공식 등록형, canonical artifact 기반,\
  \ Python 결정론 계산형, GAS thin adapter 구조로 리팩토링한다.\n\n절대 규칙:\n1. 가격·수량·비율·점수를 새로 만들지 않는다.\n2. spec/13_formula_registry.yaml에\
  \ 없는 공식명을 만들지 않는다.\n3. Temp의 다중 버전 파일을 runtime source로 직접 사용하지 않는다.\n4. canonical_manifest에 지정된 파일만 runtime source로 인정한다.\n\
  5. replay 성과를 live 성과로 말하지 않는다.\n6. live T+20 표본 30건 미만이면 active 또는 PASS_100으로 승격하지 않는다.\n7. 검증 실패를 설명으로 우회하지 않는다.\n8. 파일이\
  \ 없으면 DATA_MISSING으로 표시한다.\n9. 작업은 TODO 카드의 read_files, write_files, exact_steps, validation_commands, acceptance_criteria만\
  \ 따른다.\n10. 각 TODO 완료 후 result YAML만 출력한다.\n\n수행 순서:\nmaster_execution_order에 있는 순서대로 하나씩 수행한다.\n\n각 작업 완료 보고 형식:\nresult:\n\
  \  todo_id:\n  status: PASS | FAIL | BLOCKED\n  files_changed:\n  validation_result:\n  failed_reason:\n  next_required_todo:\n\
  \n금지:\n- 임의 공식 추가\n- 임의 수치 보정\n- 하네스 FAIL 우회\n- deprecated artifact 사용\n- GAS에 신규 투자 판단 로직 추가\n- prompt에 가격·수량·임계값 계산 지시\
  \ 추가"