8.8 KiB
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문서, 관계는 wikilink 엣지.
- 씨앗 = 2층(거시 자산군 + 관심 섹터 소수), 약 8장.
- 운영 모델 = 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개
- 모든 행에
[검증]/[가설]라벨 강제 — 뇌피셜과 근거 분리.[가설]은 외부 사용 금지, research 통과 시[검증]승격. (CLAUDE.md "출처 없는 단정 금지" 준수.) - 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.mdMOC + 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
- 씨앗 8장 + 허브 + 강화 일일 템플릿이 생성되고 structure-lint/claim-gate 통과.
- Obsidian 그래프뷰에서 8장이 wikilink로 연결돼 "지도"로 보임.
/invest-daily한 번 돌렸을 때 "분야 관찰" 칸이 카드를 참조해 채워짐.- 카드의 모든 연결/드라이버 행에
[검증]/[가설]라벨이 있음(빈 라벨 0).
13. 향후 (out of scope, 다음 버전)
- 매수 신호 규칙(③) — 카드 [검증] 엣지가 충분히 쌓인 분야부터 누적 트리거 규칙화.
- 산업 섹터·한국 섹터·개별 종목 카드 확장.
- 자금흐름·거래량 반자동 수집.
- 카드 스캐폴딩 전용 명령(
/invest-field) — ingest 마찰 시.