| name | daily-book-update |
| description | Daily automated update of the student's Living Book chapters — scans vault for new memos/imports, bootstraps an empty outline from staging notes, mirrors changes into the matching .canvas, enriches relevant chapter sections, folds in critique inbox items, and writes a daily diff log. Activate when scheduled (cron / launchd / Task Scheduler) or when the user says "update my book", "오늘 책 업데이트", "daily book update". |
| metadata | {"version":"0.3","author":"jykim","created":"2026-05-02T00:00:00.000Z","updated":"2026-05-07T00:00:00.000Z","base":"https://github.com/johnfkoo951/cmds-vault — Living Book scaffolding"} |
daily-book-update
Living Book 의 첫 번째 메커니즘 ("매일 자라는 책") 을 구현하는 스킬. 학생이 매일 손대지 않아도 매일 한 번씩 본인 책 챕터가 보강된다.
When to Use
다음 중 어느 하나에 해당하면 활성화:
- 스케줄러 (cron / launchd / Task Scheduler) 가 주기적으로 호출
- 사용자가 "update my book", "오늘 책 업데이트", "daily book update", "매일 갱신" 등을 말함
- W3 (Session 3) 이후 학생이 워크플로우 가동 검증을 위해 수동 실행
Pipeline
각 실행은 작다 — 한 두 단락 수준 변경. 14일 누적되면 챕터가 눈에 띄게 자란다.
0. PREP
- vault 루트 확인: CMDS.md / 70. Outputs/Book/ 존재
- 70. Outputs/Book/My Book Outline.md 읽기 → core_question, chapter list 추출
- 70. Outputs/Book/My Book Outline.canvas 존재·내용 읽기 (있으면 — JSON 파싱)
- 70. Outputs/Book/<chapter>.md 파일 목록 수집
- 70. Outputs/Book/assets/ 의 cover 후보 이미지 감지 (jpg/png/webp)
- outline template 상태 감지:
- core_question 또는 chapter 행에 "<...>" 플레이스홀더가 남아 있으면 → 0.5 BOOTSTRAP 으로 분기
- 채워져 있으면 → 0.6 CANVAS SYNC (필요 시) → 1. SCAN 으로 진행
0.5 BOOTSTRAP (first-run only — outline 이 template 상태일 때만 실행)
- 1. SCAN 을 먼저 실행해 최근 24h 자료 수집
- 추가로 70. Outputs/Book/ 외부의 가까운 staging note 도 함께 읽음
(e.g. CMDS=📚 101 Interests / 📚 102 Topics 의 inProgress 노트 — book 의도가 명시된 hub note)
a. **CONCEPT INFERENCE** — staging note 가 ingested 책 (예: `10. Raw Sources/13. Books/` 의 prior-art 책) 을 5건 이상 참조하면 → "prior-art tracking" 컨셉 채택. 그 책의 챕터 구조를 1:1 골조로 사용. 그 외에는 opportunity-gap 또는 hub-theme 기반으로 자율 합성.
b. **합성**:
- core_question (1–3 줄) — staging note 의 mission/intent 진술에서 추출 (concept 에 따라 phrasing 조정)
- target_reader — staging note 또는 관련 미팅·경험 기록에서 추출
- chapter candidates 5–7개 — concept 에 따라:
· prior-art tracking → 원작 N장 spine 그대로 + 각 장에 "← spine, → 갱신" annotation
· opportunity-gap → 식별된 gap 들을 챕터로
· hub-theme → staging note 의 sub-theme 들을 챕터로
- Source Materials — 합성에 사용한 노트들의 [[wikilink]] 목록 (그룹별: prior-art ingest / Permanent / Literature / Synthesis)
- Notes — staging note 의 "왜 이 책을 쓰는가" 단락을 발췌
- Cover (있으면) — `70. Outputs/Book/assets/` 의 후보 이미지를 `![[<filename>]]` embed 로
c. **WIKILINK VERIFICATION** (필수): 합성 결과에 들어갈 모든 [[wikilink]] 는 작성 전 filesystem 검증.
- 존재하지 않는 target 은 drop (또는 텍스트 인용으로 demote)
- 이유: `wikilink-rules.md` 에 따라 broken wikilink 클릭 시 `00. Inbox/` 에 빈 placeholder 파일 생성됨 → 인박스 오염
- emoji-prefixed target (📜/📚/🏛/...) 는 정확한 prefix 포함해서 검증
d. **OUTLINE WRITE** — My Book Outline.md 의 해당 섹션만 in-place 치환:
- frontmatter 형식과 다른 섹션은 보존 (refactor 금지)
- YAML 규칙 준수: 2 spaces, 위키링크는 큰따옴표 (CLAUDE.md 참조)
- 추가 섹션 (Concept, Cover) 은 outline 시작부에 삽입 가능
e. **CANVAS SYNC** — `0.6 CANVAS SYNC` 호출하여 outline 변경을 canvas 에도 반영
f. **LOG** — Daily Update Log 에 "bootstrap" 라벨로 한 줄 기록 후 종료
(이번 실행에서 ENRICH/CRITIQUE 는 건너뜀 — chapter 파일 없음)
0.6 CANVAS SYNC (outline ↔ canvas 미러 — BOOTSTRAP 후 또는 수동 호출)
- 70. Outputs/Book/My Book Outline.canvas 가 존재하면 outline 의 변화를 반영하도록 재생성
- 기본 layout (vertical scan):
- cover (`type:file` 노드, 있으면) — far-left anchor
- cover_caption — 표지 출처 메모
- reader / core / sources — header row
- concept (`color:5`) — full-width row, "변하지 않는 본질 vs 새로 필요한 판단력" 같은 high-level framing (prior-art tracking 컨셉일 때 권장)
- chapters (color:4) — single column, top-to-bottom (vertical scan)
- chapter ideas (color:1) — RHS, 1:1 aligned with chapters
- edges:
- cover → concept, reader → core, core → sources
- core → concept → ch1 → ch2 → ... → chN (체인)
- 각 chapter → 해당 ideas 카드 (right side)
- 색상 일관성 규칙:
- 동일한 처리(treatment) 받는 챕터는 같은 색
- reboot/gap 등 의미 카테고리 구분 시에만 색 다양화
- 수동 customization 보존 — 기존 canvas 에 사용자 추가 노드 (예: 연표·인용·메모) 가 있으면 합성 대신 LOG 에 "manual canvas detected, skipping auto-sync" 기록
1. SCAN RECENT ACTIVITY
- 다음 폴더에서 최근 24h 내 modified .md 파일 수집:
- 00. Inbox/ (Daily Notes, Clippings, AI Agent outputs 등)
- 10. CMDS Process/ (Connect/Merge/Develop/Share 작업물)
- 20. Literature Notes/ (외부 자료 임포트)
- 30. Permanent Notes/ (정제된 개인 지식)
- 제외: 00. Inbox/09. Legacy/, 00. Inbox/03. AI Agent/ 의 비-md 산출물 (이미지/영상/코드)
- 빈 결과면 → 4. PROCESS CRITIQUE INBOX 로 점프
2. MATCH TO CHAPTER
- 각 새 entry 마다, chapter list 의 어느 섹션과 가장 관련 있는지 추론
- chapter file 의 헤더 + core_question 을 컨텍스트로
- 매칭 신뢰도 낮으면 (e.g. < 0.6) 스킵하고 로그에 unmatched 로 기록
- 매칭된 entry 별로 1–2 문장 요약 + [[wikilink]] 인용 생성
3. ENRICH SECTION
- 매칭된 chapter 의 해당 섹션 끝에 1–2 문장 append
- 형식: "<요약 문장>. → [[<wikilink>]]"
- 섹션이 비어 있으면: 90. Settings/92. Prompts/Book/Outline-to-Paragraph (OTP).md 호출하여 첫 단락 생성
- **NEVER touch**:
- "## Author Voice / Reflection" 섹션 (read-only)
- "## Critique Received" 의 사람이 추가한 응답 부분
- chapter frontmatter
4. PROCESS CRITIQUE INBOX
- 70. Outputs/Book/Critique Inbox/ 에서 처리되지 않은 .md 파일 수집
- 각 비평 파일에서 대상 chapter 추출 (frontmatter target_chapter 또는 wikilink)
- 대상 chapter 의 "## Critique Received" 섹션에 비평을 timestamp + 출처와 함께 append
- **자동 반영하지 않음** — 사람이 읽고 본문에 반영. 비평은 보관 + 표시만.
- 처리한 비평 파일을 70. Outputs/Book/Critique Inbox/_processed/ 로 이동
5. LOG
- 70. Outputs/Book/Daily Update Log.md 에 한 줄 append:
- "YYYY-MM-DD: <chapter A> +2 sentences from [[<source>]] · <chapter B> empty section seeded · 1 critique queued"
- 빈 날도 기록: "YYYY-MM-DD: no changes (vault idle)"
Constraints
- Read-only 영역: Author Voice / Reflection 섹션, frontmatter (type/created/parent), 사람이 작성한 본문
- Append-only 영역: section 본문 끝, Critique Received, Daily Update Log
- Idempotent:
- 같은 entry 를 이중 인용하지 않는다 (Daily Update Log 또는 chapter 본문에서 wikilink 검색으로 dedupe)
- 채워진 outline 에 BOOTSTRAP 재실행하지 않는다 (template-state 만 트리거; 사용자가 명시적으로 "re-bootstrap" 요청 시 예외)
- 사용자 manual edit 이 들어온 canvas 는 auto-sync 하지 않는다
- Small steps: 한 실행에서 chapter 당 최대 3 sentences 추가. 폭주 방지.
- Wikilink safety: 모든 [[wikilink]] 는 작성 전 filesystem 검증. 미존재 target 은 drop. 이유:
wikilink-rules.md 에 따라 broken link 클릭 시 인박스에 빈 placeholder 파일 생성 → 인박스 오염.
- Status when waiting: outline 채워졌으나 chapter 파일 없음 → 매 run 마다 "waiting for W2: chapter stubs" 라벨로 명시 로그 (silent no-op 금지).
Setup
각 OS 별 스케줄러 등록 — 학생이 W3 실습 단계 2에서 1번 셋업하면 끝.
macOS (launchd, 권장)
launchctl load ~/Library/LaunchAgents/com.cmds.daily-book-update.plist
.plist 템플릿은 references/launchd.plist.template 참조 (TODO: 추가 예정).
macOS / Linux (cron)
crontab -e
0 7 * * * cd ~/Documents/cmds-vault && claude run "use the daily-book-update skill" >> /tmp/daily-book-update.log 2>&1
Windows (Task Scheduler)
- Trigger: Daily 07:00
- Action: Start a program
- Program:
C:\path\to\claude.exe
- Arguments:
run "use the daily-book-update skill"
- Start in:
C:\Users\<you>\Documents\cmds-vault
Verification (first run)
1. Drop dummy memo: 00. Inbox/01. Daily Notes/2026-MM-DD.md
- content 에 본인 챕터 핵심 키워드 1개 포함
2. Manual run: claude run "use the daily-book-update skill"
3. Check:
- 매칭된 chapter 에 1-2 문장 + [[wikilink]] append 됨
- 70. Outputs/Book/Daily Update Log.md 에 한 줄 append 됨
4. Re-run immediately:
- 같은 entry 가 두 번 인용되지 않음 (idempotency check)
Cohort Context
W3 (Session 3) 의 핵심 가동 메커니즘. → [Session 3 docs in jykim's GOBI vault]
TODO (PR welcome)
Changelog
- 0.3 (2026-05-07): 첫 가동 후 lessons-learned 반영.
- BOOTSTRAP 에 CONCEPT INFERENCE 추가 — staging note 가 ingested 책을 다수 참조하면 prior-art tracking 컨셉 자동 채택 (해당 책의 챕터 spine 1:1 사용; 예: HelloDS-Reboot 7-chapter ingest → DS 책 7장 spine).
- WIKILINK VERIFICATION 의무화 — 모든 wikilink 작성 전 filesystem 검증 (인박스 오염 방지). 미존재 target 은 drop 또는 텍스트 인용으로 demote.
- 신규 step 0.6 CANVAS SYNC — outline ↔ canvas 미러; 기본 vertical-scan 레이아웃 (cover 노드 anchor, concept card, chapter chain, RHS ideas cards) 정의. manual-edited canvas 는 보존.
- Cover asset detection —
70. Outputs/Book/assets/ 의 표지 후보 자동 embed (outline + canvas).
- Status logging 강화 — outline 은 채워졌으나 chapter 파일 없는 단계도 명시 로그 ("waiting for W2: chapter stubs"). silent no-op 금지.
- Idempotency 명문화 — filled outline 에 BOOTSTRAP 재실행 금지 (사용자 명시 요청 시 예외); manual-edited canvas 는 auto-sync 스킵.
- 0.2 (2026-05-07): SCAN scope 를
00. Inbox/ ~ 30. Permanent Notes/ 전체로 확장 (이전: Daily Notes + Literature Notes 만). first-run BOOTSTRAP 단계 추가 — outline 이 template 상태면 SCAN 결과 + staging note 로 outline 자동 채움.
- 0.1 (2026-05-02): 초기 구현.
