300 지식망 방법론

이 문서가 300번대 모든 폴더의 행동 기준이다. 파이프라인/Cowork/Claude Code는 여기를 참조해 파일 위치를 결정한다.

1. 구조 개요

300 지식망/
  ├── 301 INDEX.md              ← 전체 기업 인덱스
  │
  ├── [GICS 섹터 구역 — 310~340]
  │   ├── 310 에너지/
  │   ├── 313 소재/
  │   ├── 316 산업재/
  │   ├── 319 경기소비재/
  │   ├── 322 필수소비재/
  │   ├── 325 헬스케어/
  │   ├── 328 금융/
  │   ├── 331 정보기술/
  │   ├── 334 커뮤니케이션/
  │   ├── 337 유틸리티/
  │   └── 340 부동산/
  │
  └── [크로스섹터 분석 구역 — 370~397]
      ├── 370 기술/
      ├── 373 산업분석/
      ├── 379 시장/              ← 376 수급 흡수됨
      ├── 382 밸류에이션/
      ├── 388 정책/
      ├── 391 MOC/
      ├── 394 방법론/
      └── 397 온톨로지/

삭제된 폴더: 376 수급 (→ 379 시장/수급/ 흡수), 385 포트폴리오 (→ 430 포트폴리오와 중복)

2. GICS 섹터 폴더 내부 구조

2-1. 각 섹터 폴더 구조

331 정보기술/
  INDEX.md          ← 섹터 기업 인덱스 (gics_group별 분류)
  MOC-NVDA.md       ← 기업별 연결 허브 (vault_architect 자동 생성)
  MOC-AMD.md
  프로필/
    NVIDIA-프로필.md
  펀더멘탈/
    NVIDIA-펀더멘탈.md
  이벤트/            ← 200 아토믹에서 승격된 원자노트
    260313_...md

2-2. 서브폴더 역할 정의

`프로필/` — 기업 정체성 카드

항목	내용
담는 것	기업의 "지금 상태" 스냅샷. 투자 테시스, 5차원 레이팅, 6개월 타임라인
담지 않는 것	개별 이벤트 로그 (→ `이벤트/`), 실적 수치 (→ `펀더멘탈/`)
파일 수	1기업 = 1파일 (`{TICKER}-프로필.md`)
갱신 주기	매일 05:00 company_insight_tracker.py 자동 overwrite
작성자	파이프라인 전용 (사람은 테시스 섹션만 편집)

6개월 타임라인 포맷 (LLM 없이 규칙 기반):

## 6개월 타임라인
| 월 | 이벤트 수 | 대표 이벤트 | 방향 |
|------|---------|------------|------|
| 2026-03 | 8건 | GTC 개막, HBM4 납품 확인 | + |
| 2026-02 | 5건 | 4Q25 실적 발표 | + |
| 2026-01 | 3건 | 對중국 수출제한 검토 | - |

`펀더멘탈/` — 정량 시계열

항목	내용
담는 것	실적 발표 수치, 재무 지표, 공시 수치의 시계열
담지 않는 것	시장 반응/정성 분석 (→ `이벤트/`), 투자 판단 (→ 400)
파일 수	1기업 = 1파일 (`{TICKER}-펀더멘탈.md`)
갱신 방식	이벤트 발생 시 append (중복 방지: atomic_link 기준)
작성자	company_insight_tracker.py 자동

2섹션 구조:

## 분기 실적
| 날짜 | 분기 | 내용요약(80자) | 소스링크 |

## 주요 이벤트
| 날짜 | 내용요약(60자) | 소스링크 |

`이벤트/` — 200 아토믹 승격 원자노트

항목	내용
담는 것	200 아토믹에서 승격된 기업 관련 원자노트 원본
담지 않는 것	합성/집약된 정보 (그것은 프로필/펀더멘탈의 몫)
파일명	`{YYMMDD}_{source}_{slug}.md` (날짜 접두사 포함)
갱신 방식	승격 시 새 파일 생성
작성자	vault_architect Phase 3 자동 승격

`MOC-{TICKER}.md` — 기업 연결 허브

vault_architect Phase 10이 자동 생성
원자노트를 테마별(수급/밸류에이션/정책/시장환경) 섹션으로 분류
이벤트/ 폴더의 파일들을 연결하는 네비게이션 역할

2-3. 200 → 300 승격 매핑

frontmatter 조건	대상 서브폴더	처리 방식
`insight_type = "실적"`	`{섹터}/펀더멘탈/`	펀더멘탈 파일에 append
나머지 기업 원자노트	`{섹터}/이벤트/`	새 파일 생성
`zk_type = "moc"`	섹터 루트	새 파일 생성
시장/수급/정책 관련	크로스섹터(370~397)	카테고리 기반 라우팅

3. 크로스섹터 분석 구역 (370~397)

3-1. 폴더별 역할 정의

`370 기술/` — 기술 지형도

항목	내용
역할	특정 기술 도메인의 구조·동향·기업 연결을 정리하는 기술 테마 허브
담는 것	기술 도메인별 MOC (MOC-AI반도체, MOC-HBM, MOC-광학, MOC-파운드리 등)
담지 않는 것	개별 기업 분석 (→ GICS 섹터), 산업 전체 분석 (→ 373), 방법론 (→ 394)
작성자	vault_architect 자동 생성 + 해리 수동 추가
갱신 주기	vault_architect 매일 04:30
현재 상태	14개 파일. 원문 노트 2개는 GICS 섹터로 재분류 필요

370 vs 391 구분: 370은 "기술 도메인 MOC" (AI반도체, HBM 등 기술 단위). 391은 "기업·산업·시장·테마 MOC" (기업군, 산업 단위, 시장 전략).

`373 산업분석/` — 산업 통합 분석

항목	내용
역할	개별 기업이 아닌 산업 단위의 구조적 분석과 크로스산업 비교
담는 것	산업별 MOC, 산업 구조 분석 노트, 헤게모니 적용 분석
담지 않는 것	기업 개별 분석 (→ GICS), 순수 기술 분석 (→ 370), 정책 분석 (→ 388)
작성자	vault_architect (MOC) + 파이프라인 승격 + 해리
갱신 주기	이벤트 발생 시 (산업 구조 변화, 새 산업 테마)

주의: "정책성 산업 분석" (예: 인도 반도체 지원)은 388 정책으로 이동.

`379 시장/` — 매크로·시황·수급

항목	내용
역할	매크로 지표, 시황, ETF, 수급 데이터의 집약
담는 것	시황 분석, 매크로 데이터, ETF 전략, 수급 데이터, 테크니컬 분석
담지 않는 것	개별 기업 (→ GICS), 산업 구조 (→ 373), 투자 판단 (→ 400)
하위 폴더	`매크로/`, `테크니컬/`, `수급/` (376 흡수)
갱신 주기	거의 매일 (market_indicator, etf 파이프라인)
주의	이미지 파일은 `_attachments/`로 분리. 루트 파일 서브폴더 분류 필요

`382 밸류에이션/` — 밸류에이션 방법론

항목	내용
역할	밸류에이션 방법론과 Multiple 프레임워크
담는 것	밸류에이션 방법론 노트, Multiple 프리미엄 프레임워크
담지 않는 것	시계열 스냅샷 데이터 (→ 379 시장), 투자 결론 (→ 400)
작성자	해리 (방법론), 파이프라인 (데이터 스냅샷)
권고	시계열 데이터 스냅샷(`펀더멘탈-YYYY-MM-DD.md`)은 379로 이동

`388 정책/` — 정책·규제 분석

항목	내용
역할	정책 변화가 산업·시장에 미치는 영향 분석
담는 것	세제/규제 정책 분석, 산업 지원 정책, 지정학 정책 영향
담지 않는 것	순수 경제 지표 (→ 379), 기업 개별 대응 (→ GICS)
갱신 주기	정책 변화 이벤트 시
현재 이슈	1개 파일만 존재. geopolitical_monitor 출력 연결 필요

`391 MOC/` — 주제별 MOC 허브

항목	내용
역할	여러 노트를 묶어주는 네비게이션 MOC
담는 것	기업군 MOC (MOC-기업-반도체 등), 시장 MOC, 테마 MOC
담지 않는 것	가설 계보 (→ memory/hypotheses/), 운영 맵 (→ 800 운영)
작성자	vault_architect Phase 10/11 자동
이슈	가설-계보.md(94KB) → memory/hypotheses/ 이동 완료, ops/ → 800 운영 이동 완료

391 하위 구조 (제안):

391 MOC/
  기업/    ← 기업군 MOC
  산업/    ← 산업 단위 MOC
  시장/    ← 시장 전략 MOC
  테마/    ← 테마 MOC (DRAM-테마 등)

`394 방법론/` — 분석 프레임워크

항목	내용
역할	반복 적용 가능한 투자/분석 방법론 정의
담는 것	헤게모니 4국면 프레임워크, 산업사이클 분석법 등
담지 않는 것	방법론 적용 사례 (→ 373), 개념 정의 (→ 397), 운영 방법론 (→ 800)
작성자	해리 전용 (human_reviewed=true)
갱신 주기	새 방법론 정립 시. 매우 드물게 추가
vault_paths 메모	"프로그래밍" 카테고리는 200 아토믹(241)에도 있으며, 300에서는 394 방법론으로 승격됨

`397 온톨로지/` — 개념 정의

항목	내용
역할	투자 프레임워크 핵심 용어 사전
담는 것	"영업레버리지", "Multiple", "헤게모니", "가격결정력" 등 정의
담지 않는 것	방법론/프레임워크 (→ 394), 적용 사례 (→ 373)
작성자	해리 전용
갱신 주기	새 핵심 개념 정립 시

4. 400 판단 폴더 정의

리트머스: "이 문서 하나만 읽고 투자 결정을 내릴 수 있는가?" → Yes이면 400, No이면 300.

4-1. 300 vs 400 경계

300에서 끝나는 것	400으로 넘어가는 것
사실, 데이터, 시계열	판단, 결론, 행동 지침
"엔비디아 4Q25 매출 $39.3B"	"엔비디아 비중 30% 유지"
"AI 인프라 투자 사이클 2027까지 지속"	"NVDA 단기 조정 예상, 비중 축소"
기업 프로필, MOC, 스냅샷	투자 가이드, 매수/매도 결정

4-2. 400→400 서브폴더 매핑

폴더	담는 것	작성자	현재 상태
`410 섹터리포트/`	완성된 산업/섹터 분석 보고서 (해양플랜트 수준)	해리 + vault_architect 승격	1개 파일 (정상)
`420 투자판단/`	개별 종목/섹터 매수·보유·매도 판단	해리 전용	비어있음
`430 포트폴리오/`	전체 포트 구성 결정, 비중 논리	해리 전용	비어있음
`440 결정로그/`	날짜 기반 결정 이력, 회고	해리 전용	비어있음
`441 매수/`	매수 집행 근거 기록	해리 전용	비어있음
`442 매도/`	매도 집행 근거 기록	해리 전용	비어있음
`450 에이전트리포트/`	에이전트가 생성한 완성 리포트	에이전트 전용	비어있음

4-3. 300 → 400 자동 승격 조건 (vault_architect)

# zk_type + action keyword 이중 조건
ACTION_KEYWORDS = ["매수", "매도", "비중", "목표가", "buy", "sell", "target", "overweight", "underweight"]

조건 1: maturity = "evergreen"
조건 2: zk_type in ("insight", "judgment", "판단", "인사이트", "analysis_note")
조건 3: zk_type == "insight"인 경우 → body에 ACTION_KEYWORDS 포함 필수

하위 폴더 라우팅:
  synthesized_by 존재 → 450 에이전트리포트
  zk_type in (judgment, 판단) → 420 투자판단
  그 외 → 410 섹터리포트

4-4. 450 에이전트리포트 연결 계획

현재 파이프라인 리포트가 workspace/reports/에만 저장됨. 볼트 연결 미구현.

연결 대상: - semiconductor_report.py 주간 리포트 → 450 에이전트리포트 - petrochemical_report.py 주간 리포트 → 450 에이전트리포트 - daily_report.py 통합 리포트 → 450 에이전트리포트

5. 파일 네이밍 컨벤션

파일 유형	패턴	예시
기업 프로필	`{TICKER}-프로필.md`	`NVIDIA-프로필.md`
기업 펀더멘탈	`{TICKER}-펀더멘탈.md`	`NVIDIA-펀더멘탈.md`
기업 MOC	`MOC-{TICKER}.md`	`MOC-NVDA.md`
이벤트 원자노트	`{YYMMDD}_{source}_{slug}.md`	`260313_sapiens_GTC_Preview.md`
섹터 INDEX	`INDEX.md`	(각 섹터 폴더 루트)
섹터리포트	`{YYMMDD}_{제목}.md`	`260313_고유가-해양플랜트-투자가이드.md`

날짜는 이벤트/리포트 파일에만 포함. 프로필/펀더멘탈은 단일 파일에 시계열을 내장하므로 파일명에 날짜 불필요.

6. 시계열 가시성 — 3계층 drill-down

계층	파일	시간 표현	목적
L1 요약	`{TICKER}-프로필.md`	월별 1줄 (6개월)	빠른 현황 파악
L2 정량	`{TICKER}-펀더멘탈.md`	분기별 1행 + 이벤트	수치 추적
L3 원본	`이벤트/` 개별 파일	YYMMDD 파일명	원문 참조

"파일 하나만 열어도 최근 6개월을 파악": L1 프로필. → L2 펀더멘탈 drill-down → L3 이벤트 원문 참조.

7. vault_paths.py 매핑 (참조)

핵심 상수: - GICS_SECTOR_DIRS[int] — GICS 섹터 코드 → 섹터 폴더 경로 - get_sector_dir(gics_sector) — 섹터 코드로 폴더 반환 - get_company_subdir(gics_sector, subdir) — 섹터 내 서브폴더 반환

완료된 매핑 수정 (2026-03-19): - "인사이트" 카테고리 → 373 산업분석으로 재매핑 완료 (구 394 방법론은 부적절) - "프로그래밍" 카테고리 → 394 방법론 유지 (200 아토믹/241 프로그래밍에도 병존)

8. 구현 이력

날짜	변경	파일
2026-03-15	GICS 섹터 기반 300번대 재구조화	vault_paths.py
2026-03-15	기업 프로필 gics_sector frontmatter 추가	18개 프로필 파일
2026-03-15	company_insight_tracker GICS 동적 경로	company_insight_tracker.py
2026-03-15	이벤트/ 서브폴더 승격 라우팅	vault_architect.py
2026-03-15	프로필 6개월 타임라인 교체	company_insight_tracker.py
2026-03-15	펀더멘탈 2섹션 구조화	company_insight_tracker.py
2026-03-15	테마 Phase DEPRECATED	vault_architect.py
2026-03-15	300→400 승격 action keyword 조건 추가	vault_architect.py

300 지식망 — 폴더 방법론 & 분석 설계