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

8.8 KiB

투자 분야 지식 지도 (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

---
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 끝에 섹션 추가:

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

9. 작동 루프 / Operating Loop

매일   /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 마찰 시.