루프 작동 방식
- 작업을 제공해요 (인라인 텍스트, 기존 메모 UUID, 또는 재개)
- 체크박스가 있는 초록 고정 메모가 만들어져요
- Claude가 첫 작업을 실행하기 시작해요
- Stop 훅이 Claude의 종료를 가로채고 다음 작업을 불러와요
- 완료된 작업마다 SlashNote에서 자동으로 체크돼요
- 모든 작업이 끝나거나 일시정지·중지할 때까지 반복해요
Stop 훅이 핵심 메커니즘이에요 — 작업이 남아 있는 동안 Claude의 종료를 막아요.
모드
새 작업 (인라인)
/note-loop 테스트 작성, 기능 구현, 문서 업데이트체크박스가 있는 초록 고정 메모를 만들고 바로 실행을 시작해요.
기존 메모에서 (UUID)
/note-loop A550DE30-9B73-4CE5-A138-38F848471329기존 메모의 체크되지 않은 체크박스를 읽어 실행을 시작해요.
나중에 예약 (새 Terminal)
/note-loop <uuid> --new-session 2h
/note-loop <uuid> --new-session --sonnet지정한 지연 시간으로 새 Terminal 세션을 열어요. 모델(Opus, Sonnet, Haiku)과 권한 모드(plan, acceptEdits, bypassPermissions)를 선택해요.
재개
/note-loop기존 note-loop 메모를 찾아 체크되지 않은 항목부터 재개해요.
루프 제어
| 명령어 | 효과 |
|---|---|
/note-loop pause | 즉시 일시정지 — 나중에 /note-loop로 재개 |
/note-loop pause after | 부드러운 일시정지 — 현재 작업을 끝낸 뒤 중지 |
/note-loop skip <이유> | 현재 작업을 이유와 함께 건너뛰고 다음으로 이동 |
/note-loop stop <이유> | 루프를 완전히 중지하고 최종 요약을 보여줘요 |
/note-loop list | 모든 활성·예약된 루프를 나열해요 |
/note-loop cancel <uuid> | 예약된 루프를 취소해요 |
모든 일시정지·중지 동작은 진행 요약을 보여줘요: 완료, 건너뜀, 남은 작업과 완료율.
안전 메커니즘
| 안전장치 | 설명 |
|---|---|
| 최대 반복 횟수 | max(30, tasks * 3) — 작업 수에 따라 늘어나요 |
| 작업당 시도 | blocked로 표시되기 전 3회 시도 |
| 일시정지·중지 | 언제든 /note-loop pause 또는 /note-loop stop |
| 상태 파일 | JSON 상태가 세션 재시작 후에도 유지돼요 |
| blocked 작업 | 수동 후속 처리를 위해 체크되지 않은 채로 남아요 |
진행 상황 추적
고정 메모의 실시간 진행 차트가 보여줘요:
- 완료된 작업 (초록)
- 남은 작업 (회색)
Stop 훅이 각 작업을 처리할 때마다 차트가 자동으로 업데이트돼요.
예약 메뉴
--new-session을 시간 없이 쓰면 메뉴가 나타나요:
| 옵션 | 설명 |
|---|---|
| 지금 실행 | 새 Terminal을 열고 바로 시작해요 |
| 1분 뒤 | 설정을 확인할 짧은 지연 |
| 30분 뒤 | 현재 작업을 먼저 마무리 |
| 2시간 뒤 | 나중을 위해 예약 |
직접 시간을 입력할 수도 있어요 (1h 30m, at 18:00).
스마트 디렉토리 감지
새 Terminal 세션에 루프를 예약할 때, 스킬이 작업 디렉토리를 자동 감지해요:
- 실제 디렉토리(예:
/Users/you/project)는 그대로 사용해요 - 가상 디렉토리(예:
/code, Docker 경로)는 감지해서 거부해요 - 디렉토리를 알 수 없으면, SlashNote에서 편집 가능한 설정 패널이 열려 직접 디렉토리를 지정할 수 있어요
덕분에 새 Terminal 세션이 항상 올바른 프로젝트 루트에서 실행돼요.
기존 설정
메모에 이미 예약 설정이 있으면(이전 /note-loop 실행에서), 스킬이 그것을 재사용해요:
- 디렉토리, 모델, 권한 모드가 유지돼요
- 시작 전에 설정 패널에서 어떤 항목이든 편집할 수 있어요
- 설정 패널이 검토용으로 현재 설정을 보여줘요
상태 파일
루프 상태는 .claude/slashnote-loop.local.md(JSON 형식)에 저장돼요. 이 파일은 다음을 추적해요:
- 활성 상태, 현재 작업 인덱스
- 완료된 작업과 blocked 작업 목록
- 반복 횟수와 제한
- 일시정지·중지 이유와 타임스탬프