Files
llm-wiki/docs/superpowers/specs/2026-06-08-spec-f-invest-pipeline-hardening-design.md
T

4.2 KiB

title, source_type, status, confidence, tags, last_reviewed
title source_type status confidence tags last_reviewed
Spec F — 투자 파이프라인 경화 (구체성 + 검증) llm-generated draft medium
invest
harness
hooks
design
automation
2026-06-08

Spec F — 투자 파이프라인 경화

리뷰 발견(체계성 9/10·구체성 7/10): 실제 돈을 움직이는 invest 파이프라인이 우리가 만든 harness(claim_gate traceability + deep-research 적대검증)를 가장 필요로 하나 강제가 안 걸려 있고, 실행 단계 구체성(수수료/환율/세금·프로필·리밸런싱·staleness)이 빔. 두 갈래로 경화.

A. 검증 (Verification)

V1 — claim_gate 를 raw/invest-research/ 로 확장 (백본, 테스트 가능)

wiki_rules.CLAIM_REQUIREMENTS 에 invest-research 항목 추가. hook 강제(쓰기 시):

{"prefix": ("raw/invest-research/",),
 "tables": [("## Claims Extracted",
             ["Claim ID", "Claim", "Evidence quote", "Strength", "적용 조건", "증명 못 하는 것"])],
 "sections": ["## 출처 / Sources", "## 핵심 인용"]},

→ 환각된 금융 claim 이 근거표/출처/verbatim 없이 들어오는 걸 쓰기 시점에 차단. structure_lint 는 template-derived C1 으로 이미 invest 섹션/frontmatter 커버(확인만).

V2 — ledger 근거 traceability

raw/invest-ledger/raw/ prefix 라 structure_lint --pre 가 거래행의 깨진 근거 wikilink 를 이미 차단. invest-decide 산문이 "근거 없으면 기록 거부" 유지. (행-셀 non-empty 의 hook 강제는 over-engineering — 산문+structure_lint 로 충분.)

V3 — deep-research 명시 호출

invest-daily/research 프롬프트 강화: deep-research 스킬 명시 호출 + 수치마다 출처+조사시점(이미 있음). full 적대검증(3표 quorum)은 research-fanout/deep-research Workflow = Spec D opt-in 으로 연결(문서화). 단일 패스 KEEP/CORRECT/REJECT 의 한계 명시.

B. 구체성 (Concreteness)

C1 — 프로필 게이트 (G4)

invest-plan 이 프로필 핵심값(목표금액·기간·MDD·과세소득)을 AskUserQuestion 으로 채움. 사용자가 거부/미입력하면 NEEDS_CONTEXT 로 그 부분만 보류(사용자 주권 — strategy §고지 일관). 민감정보(과세소득)는 강제 안 함.

C2 — 리밸런싱 밴드 (G5)

strategy 에 리밸런싱 밴드 ±5% 기본 추가. 단 근거가 아니라 위험감내 재량UNSUPPORTED_DECISION 라벨 + "이 숫자는 임의값, 본인 재량" 한 줄(그들의 정직성 일관). 사용자 조정 가능.

C3 — 원장 수수료/환율/세금 (G6)

invest-ledger 템플릿 + ledger.md 거래표에 수수료 · 체결환율 컬럼 추가. 해외 ETF 양도세(연 250만 공제 후 22%) + 환율을 P&L 에 반영해야 함을 메모. (실손익 = 단가×수량 − 수수료 ± 환차 − 양도세.)

C4 — staleness 가드 (G3)

invest-decide 가 근거 문서 나이 점검: 일일노트 >24h 또는 조사노트 >90d 면 "재조사 먼저" 플래그(체결가 괴리 위험). 기본값 사용자 조정 가능.

C. 수용 기준

  1. claim_gate: raw/invest-research/x.md 가 Claims Extracted/출처/핵심인용 누락 시 차단. 완비 시 통과. (TDD)
  2. claim_gate --antigravity 동일 경로도 {decision:deny} (3-플랫폼).
  3. 기존 5-prefix 회귀 green + 신규 invest-research 테스트.
  4. ledger 템플릿/문서에 수수료·체결환율 컬럼 존재(grep).
  5. strategy 에 리밸런싱 밴드 + UNSUPPORTED 라벨 존재(grep).
  6. invest-plan 에 프로필 AskUserQuestion 게이트, invest-decide 에 staleness 플래그 존재(grep).
  7. 전체 hook 스위트 green.

D. 비목표

  • full 적대검증 Workflow(3표) = Spec D opt-in.
  • 자동 가격 피드/주문 체결 — 시스템 범위 밖(면허 자문 아님).
  • wiki/invest-strategy/concepts 의 claim_gate 강제 — 우선 invest-research(증거층)만. 후속 확장 가능.

E. 메모

  • invest 는 Claude 전용 파이프라인이나 claim_gate/structure_lint 는 공유 SSOT → invest-research 확장이 3-플랫폼(Claude/Codex/Antigravity) 모두에 자동 적용(invest 명령 자체는 Claude 전용이지만 hook 은 경로 기반).