init: llm-wiki-haness 하네스 설계

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

@@ -0,0 +1,62 @@
+---
+title: "Spec F — 투자 파이프라인 경화 (구체성 + 검증)"
+source_type: llm-generated
+status: draft
+confidence: medium
+tags: [invest, harness, hooks, design, automation]
+last_reviewed: 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 강제(쓰기 시):
+```python
+{"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 은 경로 기반).