🚀 1주차 - 동작하는 OS 뼈대

[jorippppong]

주식 OS (Stock OS)

"주린이"인 사용자가 Claude Code를 활용해 주식을 배우고, 시장 동향을 매일 받아보고, 사람 승인 하에 자신의 보유 종목을 관리·판단하는 개인 OS.

1. 목표 (Goals)

진짜 목표 (Primary)

• 한 달 뒤, 사용자가 주식 기본 개념을 이해하고 스스로 매매 판단의 근거를 읽을 수 있게 된다.
• 그 과정에서 Claude Code의 핵심 메커니즘(scheduled agents / skills / memory / MCP / hooks / workflow)을 직접 만들어 익힌다. (이번 미션의 상위 목표)

2. 핵심 원칙 (Principles)

1. 사람이 방아쇠를 당긴다 (Human-in-the-loop). Claude는 추천과 근거까지만. 실제 매수/매도 주문은 항상 사용자가 승인/실행.
2. 내 실제 보유가 기준. portfolio/ 원장을 보유의 **단일 출처(single source of truth)**로 삼고, 모든 판단은 실제 보유를 토대로 한다. (현재는 사용자가 직접 기록 — 향후 계좌 정보 자동 조회로 확장 가능.)
3. 근거 없는 추천 금지. 모든 매매 아이디어는 데이터·이유·리스크를 함께 제시.
4. 계좌 정보는 절대 평문/깃 저장 금지. 키는 환경변수/시크릿으로만.
5. 교육 우선. 매일 "왜 그런지"를 설명한다. 종목 찍어주기보다 읽는 법을 가르친다.

3. 설계 구상 (Design)

3.1 매매 권한 — Claude는 자동매매를 하지 않는다

• Claude는 항상 켜진 프로세스가 아니다(호출/스케줄 시에만 동작).
• 시세 조회는 tossctl(토스증권 CLI)로 연동돼 있으나 READ(조회) 전용이다. 주문(order) 계열 명령은 .claude/hooks/block-auto-trade.py 훅이 하네스 차원에서 차단한다(§3.5).
• 실제 주문은 사용자가 증권사 앱/CLI에서 직접 한다.
• 흐름은 항상: Claude 제안 → 사용자 승인 → 사용자 실행.

3.2 계좌

• 사용자가 자신의 보유를 portfolio/ 원장에 기록하고, Claude는 그 기록만 사용한다.
• (증권사 API를 연동할 경우) 자격증명은 .env/시크릿으로 관리, .gitignore 처리.

3.3 매일 브리핑 (Daily Briefing)

• 매 거래일 아침 브리핑을 만든다(파일 기록 순서 = 발송 순서). 현재는 사용자가 /daily-brief로 수동 호출하며, 정시 자동 스케줄 등록은 보류 상태(§5).
  1. 시장 동향 요약(지수, 환율, 주요 이슈)
  2. 관심/보유 종목 — 내 보유 변화·이유 + 유의해서 볼 종목(미보유, 매수 추천 아님 — "왜 봐야 하는지")
  3. 오늘의 주식 기본 지식 1개 (예: PER, 분산투자, 손절 등)
• 결과를 정해진 채널(파일 리포트 + 모바일 알림 — 주제별 3개 메시지)로 전달.

3.4 디렉토리 구조

/                 (repo root)
├─ OS.md          ← 이 문서 (목표/설계의 단일 출처)
├─ MISSION.md     ← 합격 기준(필수/도전)·인벤토리·진행 로그
├─ CLAUDE.md      ← OS.md를 참조하라고 지시
├─ docs/          ← 사람이 보는 구성 문서(week1.html 등)
├─ scripts/       ← notify-telegram.sh · md-to-telegram.sh · tossctl-commands.md(명령 참고)
├─ stock/         ← 주식 도메인 (향후 english/ 등 다른 도메인과 분리)
│  ├─ briefings/  ← 날짜별 데일리 브리핑 기록
│  └─ lessons/    ← curriculum.md (학습 순서 + 진도 체크박스). 용어 설명 본문은 그날 briefings/에 남음
├─ portfolio/     ← 보유 원장(holdings.md) — 단일 출처(개인 금융정보, git 제외)
└─ .claude/
   ├─ skills/     ← /daily-brief · /stock-check · /stock-explain · /portfolio-review · /git-commit
   ├─ agents/     ← 서브에이전트 5(공유 portfolio-reader + daily-brief 전용 4)
   └─ hooks/      ← block-auto-trade.py (자동매매 차단 PreToolUse 훅)

3.5. 스킬 / 에이전트

(docs/week1.html 참조)

미션 달성 현황

필수 (Required)

항목	달성	근거
1. OS 전체 사이클 1회 이상 구동	✅	/daily-brief 전 과정(수집→검증→저장) 구동 → stock/briefings/2026-07-01.md 생성
2. 스킬·서브에이전트 5개 이상	✅	총 10개 (스킬 5 + 서브에이전트 5). 오늘 stock-check·portfolio-review·stock-explain 3개 추가
3. 공유 서브에이전트 1개 이상	✅	portfolio-reader를 /stock-check·/portfolio-review 2개 스킬이 공유

도전 (권장)

항목	달성	근거
1. 훅 적용	✅	block-auto-trade 훅(PreToolUse) — tossctl 실주문 차단, OS 원칙1(자동매매 금지)과 직결
2. 스킬·서브에이전트 10개 이상	✅	스킬 5 + 서브에이전트 5 = 10개
3. 내 OS 실사용	✅