볼트 v4 구조도

갱신 정책: 폴더 트리·파이프라인 매핑 섹션은 Cowork Opus가 볼트 구조 변경 감지 시 자동갱신. 핵심 Actor 정의, 권한 테이블, v3→v4 변경사항은 해리만 수정.

폴더 트리

~/knowledge/
├── 000 선언/                      [사람만 편집. 전 Actor 읽기]
│   ├── 001 시스템-계약서.md        ← 최상위 규칙 (이전 루트-시스템-선언 대체)
│   ├── 002 구조도.md               ← 이 파일
│   ├── 003 v4-스키마.md
│   ├── 004 300지식망-방법론.md     ← GICS 기반 300 구조 + 3계층 drill-down 방법론
│   └── 005 분석-시스템-선언.md     ← Analyst 4에이전트 + 퀀트 파이프라인 전체 구조
│
├── 100 수신함/                    [파이프라인 자동 + 사람 캡처]
│   ├── 111 discoveries/
│   ├── 112 blog-insights/
│   ├── 113 twitter-reports/
│   ├── 114 popular-posts/
│   ├── 115 filtered-ideas/
│   ├── 116 croned_data/           ← analyst_channel_collector (증권사·섹터 리포트)
│   ├── 117 newspaper/             ← newspaper_collector (08:00)
│   ├── 118 텔레그램/               ← channel_collector (8개 채널, 날짜폴더 구조)
│   ├── 119 크레딧메일/             ← 크레딧 메일 수신함
│   │   ├── {채널명}/
│   │   │   ├── {YYMMDD}/      ← 일자 서브폴더
│   │   │   │   ├── _daily.md      ← 단순 메시지 인라인 + enriched wikilink
│   │   │   │   └── {slug}.md      ← 세부내용 있는 개별 노트 (enriched만)
│   │   │   └── _attachments/      ← 채널 레벨 첨부
│   ├── 120 지식사랑방/              ← inbox_bridge
│   │   ├── 121 analysis/
│   │   ├── 122 articles/
│   │   ├── 123 insights/
│   │   ├── 124 nepcon/
│   │   ├── 125 x_twitter/
│   │   ├── 126 llm/
│   │   ├── 127 thesis_ideas/
│   │   ├── 129 mentality/
│   │   ├── 131 hermi/
│   │   ├── 132 report/            ← 리포트·분석 토픽
│   │   ├── 133 youtube/           ← YouTube 트랜스크립트 (섹션 구조, 길이제한 없음)
│   │   └── 134 fitness/           ← 건강·운동
│   ├── 121 뉴스레터/               ← 뉴스레터 수신함
│   └── 130 론DM/                  ← 론 DM 수신함
│
├── 200 아토믹/                    [note_atomizer + 사람. Cowork 구조 담당]
│   ├── 210 원자노트/              ← 미분류 원자노트
│   ├── 211 경제성장/
│   ├── 213 물가/                  (인플레 포함)
│   ├── 215 통화/                  (금리 포함)
│   ├── 216 크레딧/
│   ├── 217 원자재/
│   ├── 219 정책/                  (지정학 포함)
│   ├── 220 기업/
│   ├── 222 밸류에이션/
│   ├── 224 산업/
│   ├── 226 기술/
│   ├── 228 공급망수급/
│   ├── 231 기술적분석/
│   ├── 233 자금수급/
│   ├── 237 전략/
│   ├── 241 프로그래밍/
│   └── 243 인사이트/
│
├── 300 지식망/                    [Cowork(구조) + 사람(내용). MOC 중심]
│   │   ← GICS 11섹터 구역 (310~340): 기업·산업별 3계층 drill-down
│   ├── 310 에너지/
│   ├── 313 소재/
│   ├── 316 산업재/
│   ├── 319 경기소비재/
│   ├── 322 필수소비재/
│   ├── 325 헬스케어/
│   ├── 328 금융/
│   ├── 331 정보기술/
│   ├── 334 커뮤니케이션/
│   ├── 337 유틸리티/
│   ├── 340 부동산/
│   │   ← 크로스섹터 분석 구역 (370~397)
│   ├── 370 크로스섹터/            ← 크로스섹터 분석 (실제 폴더명)
│   ├── 373 산업분석/
│   ├── 379 시장/                  (수급 흡수됨)
│   ├── 382 밸류에이션/
│   ├── 388 정책/
│   ├── 391 MOC/
│   ├── 394 방법론/
│   └── 397 온톨로지/
│
├── 400 판단/                      [410·430·440: 사람 판단 전용 / 420: 에이전트 자동 저장 허용]
│   ├── 410 섹터리포트/             ← Analyst 에이전트 생성 (weekly)
│   ├── 420 투자판단/               ← 사람만 (에이전트 검증 완료 가설 승격 허용, source 필수)
│   ├── 430 포트폴리오/             ← 사람만
│   ├── 440 결정로그/               ← 사람만
│   └── 450 에이전트리포트/         ← Analyst 3종 종합 리포트
│
├── 500 시그널/                    [Analyst 3종 에이전트 전용]
│   ├── 510 매크로/                (매크로 에이전트)
│   ├── 520 펀더멘탈/              (펀더멘탈 에이전트)
│   ├── 530 테크니컬/              (테크니컬 에이전트)
│   └── 590 크로스검증/            (3에이전트 합의/불일치 로그)
│
├── 600 데이터/                    [파이프라인 시계열 자동 저장]
│   ├── 610 TIME-ETF/
│   └── 650 재무데이터/
│
├── 700 실험실/                    [Claude Code /ideas /emerge + 사람 실험]
│   ├── 710 참조자료/
│   ├── 720 가설실험/
│   └── 730 도구킷/
│
├── 800 운영/                      [Cowork + OpenClaw 운영 로그]
│   ├── 810 런북/
│   ├── 820 플레이북/
│   ├── 830 정책/
│   ├── 840 리포트/
│   │   ├── 841 아카이브/
│   │   ├── 842 가설/
│   │   ├── 843 시각화/
│   │   └── 844 분석/
│   └── 850 실행/                  (cowork-steering.md, cowork-log.md)
│
├── 900 프롬프트/                   [에이전트 프롬프트, 온톨로지]
│   ├── 901 변경로그/
│   ├── 903 프롬프트팩/
│   ├── 910 온톨로지/
│   ├── 950 프롬프트/
│   └── 960 클로드코드/
│
└── zk/                            [건드리지 말 것]

vault_paths.py 상수 매핑 (v4)

상수	v4 경로	구 v3 경로
CORE / DECLARATION	000 선언	000 코어
INBOX	100 수신함	100 수신함
NOTES / ATOMIC	200 아토믹	200 정리
STRUCTURE / KNOWLEDGE	300 지식망	300 연결
GICS_SECTOR_DIRS	310~340 (11섹터)	310 기업/320 기술/…
DIM_TECHNOLOGY	370 크로스섹터	320 기술
DIM_INDUSTRY	373 산업분석	325 산업
DIM_MARKET	379 시장	335 시장 (수급 흡수)
DIM_VALUATION	382 밸류에이션	340 밸류에이션
DIM_POLICY	388 정책	350 정책
CONN_MOC	391 MOC	359 MOC통합
CONN_METHOD	394 방법론	360 방법론 (포트폴리오 흡수)
CONN_ONTOLOGY	397 온톨로지	380 온톨로지
INSIGHTS	400 판단	400 판단
SIGNAL	500 시그널	—
DATA	600 데이터	—
LAB	700 실험실	700 리소스
OPS	800 운영	800 운영
SYSTEM / PROMPTS	900 프롬프트	900 시스템

INBOX_SOURCES 매핑 (수신함 소스 라우팅)

소스 키	경로	파이프라인
discoveries	111 discoveries/	idea_collector
blog-insights	112 blog-insights/	blog_monitor
twitter-reports	113 twitter-reports/	twitter_collector
popular-posts	114 popular-posts/	popular_posts
filtered-ideas	115 filtered-ideas/	discovery_filter
croned_data	116 croned_data/	analyst_channel_collector
newspaper	117 newspaper/	newspaper_collector
tg-lupang ~ tg-getfeed	118 텔레그램/{채널}/	channel_collector
크레딧메일	119 크레딧메일/	수동
analysis~hermi	120 지식사랑방/121~131/	inbox_bridge
report	120 지식사랑방/132 report/	inbox_bridge
youtube	120 지식사랑방/133 youtube/	inbox_bridge + ingest_topic_media
fitness	120 지식사랑방/134 fitness/	inbox_bridge
뉴스레터	121 뉴스레터/	수동
론DM	130 론DM/	수동

118 텔레그램 생성 패턴: {채널}/{YYYY-MM-DD}/_daily.md + 세부 noте (enriched만)

v3 → v4 변경사항

v3 이름	v4 이름	이유
000 코어	000 선언	계약서 개념 강화
200 정리	200 아토믹	Zettelkasten 원자노트 역할 명확화
300 연결	300 지식망	연결 네트워크 개념 강화
500 (없음)	500 시그널	Analyst 에이전트 공간 신설
590 넥서스 대시보드	590 크로스검증	역할 명확화
700 리소스	700 실험실	/ideas, /emerge 출력 공간으로 전환
900 시스템	900 프롬프트	에이전트 프롬프트 보관 역할 명확화

섹터나침반 v3 (17섹터 / 108하위섹터)

볼트 300 지식망은 GICS 11개 섹터 기반이지만, 분석 시스템(섹터나침반)은 한국 시장에 최적화된 17개 섹터로 독립 운영한다. 볼트와 나침반은 매핑 레이어 없이 각자 독립 운영하며, GICS 코드를 폴백 키로 사용해 스마트 추론한다.

17개 섹터 목록

섹터 키	한국어	하위섹터 수	GICS 폴백
semiconductor	반도체	11	정보기술 (45)
display	디스플레이	4	정보기술 (45)
shipbuilding	조선	5	산업재 (20)
shipping_logistics	해운/물류	4	산업재 (20)
energy_refinery	에너지/정유	5	에너지 (10)
petrochemical	석유화학	3	소재 (15)
battery_ev	배터리/EV	7	소재 (15)
defense_space	방산/우주	6	산업재 (20)
nuclear_power	원전/전력인프라	6	유틸리티 (55)
bio_healthcare	바이오/헬스케어	7	헬스케어 (35)
robot_auto	로봇/자율주행	7	산업재 (20)
consumer_discretionary	경기소비재	8	경기소비재 (25)
consumer_staples	필수소비재	4	필수소비재 (30)
financials	금융	12	금융 (40)
comm_platform	플랫폼/미디어	7	커뮤니케이션 (50)
infra_utilities	인프라/유틸리티	6	유틸리티 (55)
materials	소재/철강	6	소재 (15)

데이터 소스

섹터 정의: webapp/blueprints/sector_data.py (_SECTOR_KR, _SUBSECTORS, _LINKAGE)
시그널 합성: signal_synthesizer.py (3축: 주가/산업지표/전후방)
연결 검증: linkage_validator.py (6단계: 그레인저→상관→스프레드→DART→산업연관→전파)

파이프라인 체인

수집 체인:
  idea_collector → discovery_filter → discovery_digest → knowledge_connector
  → hypothesis_engine → experiment_tracker

볼트 관리 체인:
  vault_architect (9Phase) → note_atomizer (5단계)

분석 체인:
  signal_synthesizer (3축 시그널 합성)
  → linkage_validator (6단계 연결 검증)
  → sector_research (섹터 리서치)
  → analyst 4에이전트 (매크로/펀더멘탈/테크니컬/PM)

시스템 체인:
  system_digest → vault_flow_health → daily_system_validator

메모리 구조 (workspace/memory/)

디렉토리	용도	주요 파이프라인
filtered-ideas/	필터링된 아이디어	discovery_filter
hypotheses/	가설 저장	hypothesis_engine
vault-architect/	볼트 아키텍트 이력	vault_architect
vault-flow-health/	볼트 품질 점수	vault_flow_health
system-digest/	전체 진단	system_digest
cowork-history/	Cowork 실행 이력	cowork (LaunchAgent)
error-ledger/	에러 누적 이력	system_digest
analyst-synthesis/	PM 통합 포지셔닝	analyst PM
analyst-quality/	에이전트 품질 평가	analyst_quality_tracker
analyst-backtest/	예측 정확도	analyst_prediction_backfill
quant-signals/	퀀트 신호	quant_signal_generator
sector-signals/	섹터 시그널 합성	signal_synthesizer
sector-research/	섹터 리서치	sector_research
linkage-validation/	연결 검증 결과	linkage_validator
market-indicators/	시장 지표	market_indicator
price-history/	가격 이력	price_history_collector
macro-timeseries/	FRED 매크로	macro_series_collector
alt-data/	대안 데이터	alt_data_collector

Cowork Opus 자동갱신 조건

Cowork Opus는 아래 변경이 감지될 때 폴더 트리·vault_paths.py 매핑 테이블을 이 파일에 자동 반영한다. 핵심 Actor 정의, 권한 테이블, 이 섹션 자체는 수정하지 않는다.

vault_architect.py 실행 후 신규 폴더 생성/삭제 발생 시
vault_paths.py의 경로 상수 변경 감지 시
파이프라인 출력 경로 변경(openclaw.json 또는 크론 수정) 감지 시

갱신 방법: 폴더 트리 섹션과 vault_paths.py 상수 매핑 테이블만 덮어쓰기. date frontmatter 갱신.

볼트 v4 구조도

볼트 v4 구조도

폴더 트리

vault_paths.py 상수 매핑 (v4)

INBOX_SOURCES 매핑 (수신함 소스 라우팅)

v3 → v4 변경사항

섹터나침반 v3 (17섹터 / 108하위섹터)

17개 섹터 목록

데이터 소스

파이프라인 체인

메모리 구조 (workspace/memory/)

Cowork Opus 자동갱신 조건

관련 노트