lecture-live-edit

라이브 편집 운영 규약

브라우저 → 큐 → Claude → 화면 갱신의 루프를 유실 없이, 엉뚱한 슬라이드를 고치지 않고 돌리는 절차.

왜 이 절차를 지켜야 하는가

상태의 진실은 두 파일뿐이다. feedback/queue.jsonl(피드백 원본, 추가 전용)과 feedback/cursor(처리한 줄 수). 미처리 = 줄 수 − 커서라는 산술 하나로만 판정하기 때문에, 알림이 유실되거나 중복돼도, 드레인 도중 새 피드백이 도착해도 아무것도 잃지 않는다. 이 불변식은 lle.py 로만 상태를 바꿀 때 유지된다. 커서를 손으로 고치거나 큐를 편집하면 깨진다.

도구 경로 확인 (세션에서 한 번)

스크립트 4종은 이 스킬 폴더 안 scripts/ 에 있다. 설치 위치는 환경마다 다르므로 한 번 찾아 둔다.

TOOL=$(dirname "$(find ~/.claude -name lle.py -path '*lecture-live-edit/scripts*' 2>/dev/null | head -1)")
echo "$TOOL"     # 이후 python3 "$TOOL"/lle.py … 로 쓴다

찾지 못하면 플러그인이 설치되지 않은 것이다. 사용자에게 설치를 안내한다. 아래 예시의 $TOOL 은 모두 이 경로를 가리킨다.

---

드레인 절차 (알림이 오면 / "ㄱ" 신호를 받으면 / 턴 시작 시 pending>0이면)

1단계 — 꺼내기

python3 $TOOL/lle.py pending --root <프로젝트폴더>

출력의 items 가 처리 대상, cursor_after 를 3단계에 그대로 넘긴다. 이 명령이 편집 직전 스냅샷을 versions/ 에 남기므로 되돌리기가 항상 가능하다. (pending 이 0이면 아무것도 하지 않고 조용히 끝낸다. 중복 알림은 정상이다.)

2단계 — 고치기

항목 하나하나를 다음 순서로 처리한다.

1. 대상 슬라이드 찾기 — sid 로 data-sid="..." 를 찾는다.
2. 대조 검증 (필수) — 그 슬라이드의 제목이 titleExcerpt 와 맞는지 본다. 어긋나면 편집하지 말고 그 항목을 --needs-input 으로 돌린다. 엉뚱한 슬라이드를 조용히 고치는 것이 이 시스템의 최악의 실패다.
3. 정확한 위치 앵커링 — selectedText 를 소스에서 찾는다. 여러 번 나오면 contextBefore / contextAfter 로 좁힌다. elemHint(예: "표 셀 #2")가 있으면 그 요소 안에서 찾는다. scope 가 slide 면 그 장 전체, deck 이면 자료 전체가 대상이다.
4. 지시 반영 — instruction 이 본문, quickActions 는 보조 신호다. 둘이 충돌하면 instruction 이 이긴다. 퀵칩의 뜻: 둘로 쪼개기=슬라이드 분할 / 근거 보강=수치·출처 추가 / 덜 방어적으로=단정적으로 고쳐 씀 / 더 간결하게=문장 수 줄임 / 표를 대비형으로=행 나열을 A vs B 열 구조로 / 시각화 추가=흐름도·카드·통계 블록.
5. 마크업 문법은 lecture-deck-build 스킬의 references/slide-contract.md 를 따른다.

슬라이드를 쪼갤 때 — 앞쪽이 기존 sid 를 승계하고, 뒤쪽은 sNN-2, sNN-3 을 새로 받는다. 절대 전체 재번호를 매기지 않는다. 대기 중인 다른 피드백이 엉뚱한 장을 가리키게 된다. 합칠 때는 앞쪽 sid 를 남긴다. 순서를 바꿔도 sid 는 따라다닌다(표시 번호는 런타임이 계산).

3단계 — 마치기

python3 $TOOL/lle.py done --root <폴더> --cursor <1단계의 cursor_after> \
        --note "무엇을 고쳤는지 한 줄" [--needs-input <id,id>] [--skipped <id>]