llm-wiki/docs/superpowers/specs/2026-06-08-invest-field-map-design.md

# 투자 분야 지식 지도 (Field Map) — 설계

- **날짜**: 2026-06-08
- **상태**: 설계 승인됨 (사용자 승인 2026-06-08)
- **상위 맥락**: `[[docs/superpowers/specs/2026-06-05-investment-wiki-pipeline-design]]` (투자 파이프라인 1차 설계)의 확장. invest 파이프라인은 Claude Code 전용(3-플랫폼 포팅 예외).
- **목적**: 사용자가 *거시 자금흐름을 읽는 "눈/시야"*를 기르도록, 분야(섹터·자산군) 간 인과·상관을 근거와 함께 쌓아가는 **지식 지도(knowledge map)** 문서 구조를 추가한다.

---

## 1. 문제 / Problem

현재 invest 파이프라인은 **캡처(/invest-daily, /invest-research)**·**전략(strategy)**·**계획(plan)**·**원장(ledger)**은 있으나, 다음을 받칠 구조가 **없다**:

- 전체를 **분야(섹터/자산군)로 쪼개 보는** 지도
- 분야 간 **인과·상관** (예: 달러↓→원자재↑, 반도체 사이클→경기, 경기국면별 로테이션)
- **같이 움직이는 종목/분야군**
- 그 흐름을 읽는 *눈의 토대*가 될 거시 지식 — `wiki/invest-concepts/`는 현재 **비어 있음**(.gitkeep만).

`invest-daily`는 "금리·환율·S&P500이 올랐다/내렸다"(자산군 5개 수준)까지만 잡고, *분야·흐름·인과·종목군*은 누적되지 않는다.

## 2. 목표 / Goals

- 분야 간 관계를 **근거(검증) vs 가설**로 구분해 쌓는 canonical 지식 지도.
- 매일 관찰(invest-daily)이 지도를 똑똑하게 만드는 **피드백 루프** = "눈 훈련".
- Obsidian 그래프가 곧 자금흐름 지도가 되도록 **노드(분야 카드) + 엣지(wikilink)** 구조.

## 3. 비목표 / Non-Goals (v1 YAGNI)

| 안 만듦 | 이유 |
|---|---|
| ③ 매수 신호 규칙 ("언제부터 모으나") | 지식 지도(②)가 먼저 쌓여야 신호가 근거를 가짐. 다음 버전 |
| 자동 거래량·자금흐름 수집(API) | v1은 **수동 관찰**만 |
| 전체 산업 섹터 전부 채우기 | 씨앗 8장만, 필요 시 1장씩 추가 |
| 새 슬래시 명령(`/invest-field` 등) | 기존 `/invest-research`+`/invest-ingest` 재사용. 마찰 생기면 그때 |
| 한국 섹터·개별 종목 카드 | 거시+미국 먼저 |

## 4. 설계 결정 (brainstorm 합의)

1. **첫 버전의 심장 = 지식 지도(②)** — 일일 추적(①)·매수 신호(③)는 이 위에 얹음.
2. **지도 단위 = 분야 카드(노드 중심)** — 각 분야 1문서, 관계는 wikilink 엣지.
3. **씨앗 = 2층(거시 자산군 + 관심 섹터 소수)**, 약 8장.
4. **운영 모델 = approach A** — 기존 파이프라인(research·ingest·daily) 재사용 + 카드 템플릿/허브/일일강화 신설. (approach B=너무 얇음, C=단일 거대문서로 wiki 규칙 위반 → 기각.)

## 5. 구성요소 / Components

### 5.1 새로 만드는 것

| # | 산출물 | 경로 |
|---|---|---|
| 1 | 분야 카드 템플릿 | `templates/invest-field-card-template.md` |
| 2 | 지도 허브 (named hub) | `wiki/invest-concepts/field-map.md` |
| 3 | 씨앗 카드 8장 | `wiki/invest-concepts/field-<이름>.md` |
| 4 | invest-daily 템플릿 강화 | `templates/invest-daily-template.md` 에 "분야 관찰" 섹션 추가 |

### 5.2 재사용

- `/invest-research` — 의심 관계를 deep-research 3표로 검증 (raw/invest-research/).
- `/invest-ingest` — 검증된 관계·관찰을 카드에 반영 (raw → wiki/invest-concepts/). 목적지가 invest-concepts라 카드는 ingest 관할.
- Obsidian 그래프 — 카드 간 wikilink = 지도의 엣지.

## 6. 분야 카드 구조 / Field Card Template

```markdown
---
title: [분야명]                      # 예: 미 달러 / USD
source_type: invest-concept          # 기존 canonical 타입 재사용 (taxonomy 무변경)
status: draft                        # draft→reviewed→verified
confidence: low|medium|high
tags: [invest-concept, field-card, macro-asset]   # 섹터면 sector
last_reviewed: YYYY-MM-DD
---

# [분야명]

## Parent
- [[wiki/invest-concepts/field-map]]        # 지도 허브로 upward link (linking-rules)

## 한 줄 정의 / What it is
> 이게 뭔지 한 문장.

## 무엇이 이걸 움직이나 / Drivers            # "이 분야를 위/아래로 미는 힘" (입력 방향)
| 요인 | 방향 | 메커니즘 | [검증/가설] | 근거 |
|---|---|---|---|---|

## 연결 / Linkages                          # 엣지 — "이게 움직이면 따라오는 것" (출력 방향) ★핵심
| 이게 ↑하면 | → 따라 | 메커니즘 | [검증/가설] | 근거 |
|---|---|---|---|---|

## 관찰 지표 / What to watch                 # 매일 invest-daily가 잡을 구체 지표·티커
- ...

## 경기 사이클 위치 / Cycle position
- 회복/확장/둔화/침체 중 언제 강·약

## 검증 상태 / Verification
- [검증] N개 · [가설] M개

## Sources
- [[raw/invest-research/...]]

## Related (= 그래프 엣지)
- [[wiki/invest-concepts/field-...]]
```

### 핵심 장치 2개
1. **모든 행에 `[검증]/[가설]` 라벨 강제** — 뇌피셜과 근거 분리. `[가설]`은 외부 사용 금지, research 통과 시 `[검증]` 승격. (CLAUDE.md "출처 없는 단정 금지" 준수.)
2. **drivers(이걸 미는 힘) vs linkages(이게 미는 것) 분리** — 인과 방향 혼동 방지.

## 7. 씨앗 카드 8장 / Seed Set (v1)

거시 자산군 (6):
- `field-dollar` — 달러 (DXY/USD-KRW)
- `field-us-rates` — 미 10Y 금리
- `field-oil` — 원유 (WTI)
- `field-gold` — 금
- `field-us-equity` — 미국 주식 (S&P500) ← 사용자 보유 TIGER 360750과 직결
- `field-bitcoin` — 비트코인

산업 섹터 (2):
- `field-semiconductors` — 반도체 (사용자 관심)
- `field-bigtech-ai` — 빅테크/AI (반도체·금리와 연결 강함)

> 씨앗 카드는 v1에서 **드라이버·연결 일부를 가설(label=[가설])로 채워 시작**해도 됨 — research로 점진 검증. 단 빈 카드 금지(최소 정의+관찰지표+연결 1행).

## 8. invest-daily 강화 / Daily Capture Enrichment

`templates/invest-daily-template.md` 끝에 섹션 추가:

```markdown
## 분야 관찰 / Field Observations
> 오늘 움직인 카드와, 그 카드가 예측한 연결이 실측과 맞았는지 대조. 루프의 엔진.
| 오늘 움직인 카드 | 방향 | 그 카드 예측 연결이 맞았나?(확인/반증) | 새 가설/메모 |
|---|---|---|---|
| [[wiki/invest-concepts/field-dollar]] | ↑0.8% | 예측대로 금↓ ✓ / 원자재 횡보(반증) | "원자재 공급이슈?" |
```

## 9. 작동 루프 / Operating Loop

```text
매일   /invest-daily → 거시 카드 지표 + "분야 관찰"(예측 vs 실측 대조)
수시   패턴 발견 → /invest-research 로 관계 3표 검증
       → /invest-ingest 로 검증 엣지를 카드 "연결표"에 [검증] 라벨로 박음
결과   카드마다 [검증] 누적 = 지도 강화 = 내일 더 잘 보임
```

## 10. 지도 허브 / field-map.md

- `wiki/invest-concepts/field-map.md` (named hub, `index.md` 금지 — CLAUDE.md §12).
- 8장 카드를 2층(거시 자산군 / 산업 섹터)으로 나열 = "한눈에 보는 지도".
- 모든 카드의 `## Parent`가 이 허브를 가리키고, 허브는 cluster로 카드를 나열(양방향).
- `wiki/llm-wiki.md` MOC + invest-hub에 field-map 엔트리 추가.

## 11. 기존 규칙 정합 / Compliance

- **source_type 무변경**: 카드는 `invest-concept` 재사용 → taxonomy 영향 없음. 구분은 `tags: field-card`.
- **claim gate 검증됨 (2026-06-08 코드 확인)**: `wiki_rules.CLAIM_REQUIREMENTS`의 claims-표 강제는 `wiki/concepts/` prefix에만 걸리고 **`wiki/invest-concepts/`에는 적용 안 됨**(startswith 별개 경로). 따라서 카드에 `## Claims Extracted`/`## Claim-backed Knowledge` 표 **강제 없음** → 카드의 근거 장치는 본 설계의 **`[검증/가설]` 라벨 + `## Sources`**로 충분. (단 `raw/invest-research/`는 여전히 claims-표 강제 — 관계 검증은 거기서.)
- **linking-rules**: 카드 Parent→field-map, field-map→invest-hub upward link.
- **CLAUDE.md §15 파생 규칙**: 카드는 canonical(invest-concepts) — 외부 산출물 아님. `[가설]` 행은 외부 derived 사용 금지.

## 12. 성공 기준 / Success Criteria

1. 씨앗 8장 + 허브 + 강화 일일 템플릿이 생성되고 structure-lint/claim-gate 통과.
2. Obsidian 그래프뷰에서 8장이 wikilink로 연결돼 "지도"로 보임.
3. `/invest-daily` 한 번 돌렸을 때 "분야 관찰" 칸이 카드를 참조해 채워짐.
4. 카드의 모든 연결/드라이버 행에 `[검증]/[가설]` 라벨이 있음(빈 라벨 0).

## 13. 향후 (out of scope, 다음 버전)

- 매수 신호 규칙(③) — 카드 [검증] 엣지가 충분히 쌓인 분야부터 누적 트리거 규칙화.
- 산업 섹터·한국 섹터·개별 종목 카드 확장.
- 자금흐름·거래량 반자동 수집.
- 카드 스캐폴딩 전용 명령(`/invest-field`) — ingest 마찰 시.