`lore sync`

전체 워크스페이스를 스캔해 L3 raw facts 를 .lore/draft/<카테고리>.md 로 재생성하고, 카테고리 진입점 .lore/flows/INDEX.md 를 갱신합니다.

lore sync [--project <name>] [--dry-run]

옵션

플래그	설명
`--project <name>`	`lore.config.yaml` 의 단일 project 키만 처리
`--dry-run`	실제 쓰기 없이 계획만 출력

출력 위치

sync 와 synthesize 는 다른 폴더에 씁니다:

.lore/draft/<slug>.md — sync 가 만드는 원천 L3 사실 (기계 생성, 매번 덮어쓰기 OK, 사람이 직접 편집하지 않음)
.lore/flows/<slug>.md — synthesize 가 만드는 사람이 읽는 L2 보고서 (publish · chat · 대시보드가 읽는 곳)
.lore/flows/INDEX.md — 카테고리 진입점 (sync 가 갱신, frontmatter 스펙 + L1/L2/L3 레이어 개념 + 갱신 가이드 포함)

이 분리 덕분에 코드에 변경 없는 상태에서 synthesize 를 돌려도 LLM 비용을 들여 전체 카테고리를 재작성하지 않습니다 — synthesize 는 자기 캐시(.lore/.synth-cache/) 로 변경 감지.

draft 파일 구조

---
slug: signal
title: 시그널
icon: 📘
order: 2
summary: 시그널 카테고리 (23개 심볼)
tags: [talk, realtime, pick]
last_reviewed: 2026-04-25
source_files: 23
---
 
# 📘 시그널 (Draft — raw L3 facts)
 
> 이 파일은 `lore sync` 가 코드 어노테이션에서 자동 생성한 **원천 사실** 입니다.
> 사람이 읽는 보고서는 `lore synthesize` 가 `.lore/flows/signal.md` 로 만들어냅니다.
> 이 draft 를 직접 편집하지 마세요 — 다음 `lore sync` 가 덮어씁니다.
 
## 1. 개요
...
## 2. 심볼 목록
### `SignalTalk`
...

INDEX.md

자동 생성. slug: index 로 마킹되어 사이드바 / RAG 인덱싱에서 빠집니다. 포함되는 것:

카테고리 표 (#, slug, 아이콘, 이름, 문서 링크)
frontmatter 스펙 (대시보드 파서용)
L1 / L2 / L3 레이어 개념
lore sync → lore synthesize → lore review 갱신 흐름

멱등성

같은 git HEAD 에서 두 번 sync → diff 0. CI 에서 git diff --exit-code .lore/draft/ 로 검증할 수 있습니다.

자세히

L1 → .lore/DOMAIN_MAP.md 는 sync 가 건드리지 않음 (사람 큐레이션)
L2 → .lore/flows/<cat>.md 도 sync 가 덮어쓰지 않음 (synthesize 영역)
last_reviewed frontmatter 는 sync 일자가 자동 주입됨
source_files 는 카테고리에 기여한 파일 수

lore check lore synthesize