🗺️ JW의 클로드 코드 시스템

1년+ 운영하며 만든 개인 비서급 셋업. 전체 그림 + 활용 사례 위주. 자세한 건 따로 물어봐 주세요.

TL;DR

• 클로드 코드를 개인 비서급 시스템으로 운영 (1년+)
• 인터페이스의 70%는 텔레그램 봇 (CLI는 보조)
• 핵심 원칙: 메모리 로그 + 설계-구현 분리 + 실행 중심

🌐 시스템 한눈에 보기

📦 프로젝트 분류

→ 자세히 01-projects

🔄 작업 사이클

[!note] 한 줄 요약 log.md = 단기 캡처 · CLAUDE.md = 장기 규칙 · design/runs/ = 결정 아카이브

⚙️ 공통 운영 패턴 (간략)

• 메모리 — memory/log.md 한 곳에 캡처 → 반복되면 CLAUDE.md 승격
• 텔레그램 봇 — _shared/bin/launcher 경유, 음성·문서 받아 처리
• 슬래시 커맨드 — /r, /signals, /debate, /loop, /status
• 설계-구현 분리 — 큰 결정은 design/runs/에 debate 아카이브

자세히 → 02-how-it-works

📑 인덱스

• 01-projects — 7개 프로젝트별 역할·예시
• 02-how-it-works — 메모리·CLAUDE.md·design (Claude Code를 더 잘 쓰는 법)
• 03-references — 유튜브·도구

🏗️ 프로젝트별 활용

카테고리별로 — 역할 / 언제 / 핵심 / 실제 사용 예시.

💰 투자

🔍 investment-research

• 역할: 회사 1개 자율 딥리서치 → 리포트 생성
• 언제: 종목 깊이 봐야 할 때 (분기 실적·신규 발굴)
• 핵심: 멀티 LLM 리서치 + NotebookLM 통합 + 텔레그램 자동 전달

[!example] 실제 사용 텔레그램에 /r 엔비디아 → 5–10분 후 리포트 (재무·경쟁·카탈리스트·리스크)가 PDF로 텔레그램 도착

🧠 investment-brain

• 역할: 일상 투자 인풋 → Obsidian 볼트에 자동 노트 (source / archive)
• 언제: 매일. 텔레그램에 음성·링크·문서 보낼 때
• 핵심: 관심 벡터(investor-profile.md) 추적 + 유튜브 채널 72개 자동 모니터

[!example] 실제 사용 텔레그램에 "엔비디아 어닝 콜 들었다" 음성 → 전사 → 분류 → 노트 자동 작성 → 관심 벡터 업데이트

🎯 investment-agent

• 역할: investment-brain 위에 얹는 judgment OS (테마·시그널·판단)
• 언제: 투자 판단 정리·테마 큐레이션·의사결정 기록할 때
• 핵심: theme → signal → claim → decision → review 흐름

[!example] 실제 사용 새 테마 발견 → themes.md 추가 → 관련 회사 후보(씨메스·달파) → claim 작성 → decision 기록

📄 문서작성

📝 doc-agent

• 역할: 펀드·투심 보고서 등 원본 양식 위에 데이터 매핑
• 언제: 정형화된 보고서. 양식 충실도가 중요한 경우
• 핵심: 원본 양식 절대 안 바꿈 · 연결 재무제표 기준

[!example] 실제 사용 C Fund 25년 온기 보고서 — ref/원본.docx 위에 데이터 매핑 → draft/ 작업 → final/ PDF 출력

🎯 코딩·디자인

🗣️ design

• 역할: 큰 결정 + 멀티 LLM debate 아카이브 (Claude + openclaw)
• 언제: 신규 아키텍처·되돌리기 어려운 결정 ("3개월 뒤 왜 이렇게 했지" 가능성)
• 핵심: brief → critique → response → final 양 LLM 토론 후 아카이브

[!example] 실제 사용 vc-km 시스템 설계 → 00-brief.md (Claude) → 01-critique.md (openclaw) → 응답 누적 → 06-final.md

📅 일상

📆 life-ops

• 역할: 개인 업무·일정 관리
• 언제: 매일. 텔레그램에 할 일·일정 캡처할 때
• 핵심: Google Calendar 연동 + 텔레그램 봇

[!example] 실제 사용 텔레그램에 "내일 3시 김부장 미팅" → 자동 캘린더 등록 + 30분 전 리마인더

🏢 회사자료

📚 vc-km

• 역할: 크릿벤처스 10명 팀 포트폴리오 문서 관리 시스템
• 언제: VC 업무 중 회사 자료 큐레이션·검색
• 핵심: Google Apps Script + Shared Drive + Chat 봇 + Vertex Gemini AI 자동 분류

[!example] 실제 사용 회사 폴더에 자료 업로드 → AI 자동 분류·태그·요약·Master Field 추출 → Chat 봇으로 검색

✂️ 기타

📚 study-mate

• 역할: 음성 강의 → 전사 → KB 정리 → HTML 리포트
• 언제: 학습 자료 정리 (반도체 등 도메인 학습)
• 핵심: 텔레그램 m4a → 전사 → 지식 추출 → HTML

[!example] 실제 사용 강의 m4a 첨부 → 30초 후 HTML 리포트 (요점·다이어그램·관련 자료) 텔레그램 도착

다음 → 02-how-it-works

🧠 클로드 코드를 더 잘 쓰는 법

시간 누적해서 점점 좋아지는 시스템을 만드는 3가지. 결국 클로드 코드 효율 = 메모리 + 룰 구조 + 메타 도구.

TL;DR

1. 메모리 — JW 발화 즉시 캡처, 반복되는 것만 영구 규칙으로
2. CLAUDE.md 계층 — 글로벌·룰·프로젝트 3계층, 자동 적용
3. design 프로젝트 — Claude Code 자체 효율을 끌어올리는 메타 시스템

1️⃣ 메모리 설계 — log → 승격

왜 이렇게 했나

• 초기엔 모든 결정·교훈을 auto-memory에 박았다가 컨텍스트 폭주
• 모든 프로젝트가 같은 기록 패턴 안 쓰면 일관성 깨짐
• 반복되는 패턴만 영구화 → 신호/노이즈 자동 분리

흐름

4가지 캡처 트리거

핵심 룰 4개

• Capture는 하나로 — 프로젝트마다 memory/log.md 한 파일
• 트리거 즉시 기록 — 응답 마지막에 Edit 한 줄, 미루지 않음
• Read는 최소로 — 세션 시작 시 그 한 파일만 읽음
• 승격은 JW 승인 후 — 자동 승격 금지

[!example] 누적 효과 1년+ 누적 결과: 한 번 가르친 룰은 다시 안 가르쳐도 됨. 새 프로젝트도 동일 패턴 즉시 적용.

2️⃣ CLAUDE.md 파일 구조·계층

3계층 분리 — 글로벌·룰·프로젝트가 각자 다른 수명·범위 가짐.

어떤 게 어디로 가나

왜 분리했나

• 글로벌에 다 넣으면: 작은 변경도 전 프로젝트 영향, 격리 X
• 프로젝트에만 넣으면: 중복, 일관성 깨짐
• rules/ 중간 계층 — 여러 프로젝트 공유하지만 글로벌엔 너무 구체적인 도메인 룰 분리

[!tip] 승격 흐름 (log → CLAUDE.md) "이 프로젝트에서만 반복" → 프로젝트 CLAUDE.md "여러 프로젝트에서 반복" → rules/{주제}.md 또는 글로벌 CLAUDE.md

3️⃣ design 프로젝트 — Claude Code 자체 효율 도구

왜 존재하나

큰 결정(아키텍처·되돌리기 어려운 선택)은 한 세션·하나의 LLM에선 깊이 못 봄. 그래서:

• 다른 LLM(openclaw)에게 비판받고 응답하는 비동기 토론 → 단일 시각 맹점 보완
• 결정 근거를 코드 밖에 보존 → 코드는 결과만, design은 "왜"를 담음
• 다른 프로젝트가 design 결정을 역참조 → 시스템 전체의 장기 기억

결국 design = 클로드 코드를 더 효율적으로 쓰기 위한 메타 시스템. 투자·문서·일상 프로젝트들이 평소대로 굴러가게 하려면, 큰 결정의 품질이 보장돼야 한다.

활용 흐름 (이미 01-projects에서 본 시퀀스)

임계 기준 — debate vs 바로 구현

[!note] 한 줄 휴리스틱 "3개월 뒤 왜 이렇게 했는지 설명해야 할 가능성이 있으면 design. 없으면 바로 구현."

사후 ADR (경량 옵션)

풀 debate 까진 아니지만 기록은 남기고 싶을 때 → consensus.md 2-3 단락만.

누적 효과

1년+ 누적된 design/runs/ 폴더 = 클로드 코드의 장기 기억. 새 결정 시 비슷한 과거 결정 참조 → 매번 처음부터 생각하지 않음.

다음 → 03-references

📺 참고 자료

📺 유튜브 — 테크·AI 코딩

JW가 구독·모니터링하는 채널 (investment-brain _scripts/youtube-channels.json에서 자동 추적).

🇰🇷 한국어

• 안될공학 — AI·반도체 시황
• 코드팩토리 — 개발 튜토리얼
• 시민개발자 구씨 — 코드 없이 AI 활용
• 김플립 LLM코딩 — Claude·LLM 활용 코딩
• 메이커 에반 — AI 메이커
• 조코딩 — 코딩 튜토리얼
• AI 코리아 커뮤니티 — 한국 AI 커뮤니티
• CONNECT AI LAB — AI 응용

🌍 영어

• ColdFusion — 테크 트렌드 deep dive
• Two Minute Papers — AI 논문 요약
• AI Explained — LLM·AI 분석
• 10X AI Club — AI 활용 워크플로우
• Anthropic — Claude 공식
• OpenAI — GPT 공식

[!tip] 자동 모니터링 investment-brain/_scripts/youtube-monitor.py 가 주기적으로 신규 영상을 가져와 키워드 스코어링(AI·LLM·Claude·반도체 등)으로 우선순위 매겨 텔레그램에 큐레이션.

📝 공식 문서

• Anthropic Docs — Claude API · Claude Code
• Claude Code Best Practices — 공식 베스트 프랙티스

🛠️ 도구

🏠 인덱스로 돌아가기