# Scheduler

> Change automatic capture cadence, the 15-minute floor, or system-event triggers. Use when snapshots fire too often, not at all, or nextCaptureDate is wrong.

- Skill: `hoangsonww/scheduler-2` (Agent Skill)
- Install (CLI): `npx get-skill add hoangsonww/scheduler-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hoangsonww/scheduler-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hoangsonww (https://skillmd.com/u/hoangsonww)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/hoangsonww/scheduler-2

---


# Scheduler

`SnapshotScheduler.decide` is a pure function. Platforms supply Timer / BGAppRefresh / WKApplicationRefresh; they must not fork the decision.

- Disabled = cadence `.off` **and** `capturesOnSystemEvents == false`.
- Cadence off with system events still enabled is a valid schedule.
- `minimumInterval` (default 900s) applies to **every** trigger, including wake/unlock.
- First run with no `lastCapture` captures immediately when enabled.
- `skipsWhenUnchanged` is applied later by `SnapshotService.capture(skipIfUnchanged:)`, not by `decide`.

Tests: `Tests/Domain/SchedulerTests.swift` and scheduler invariants.

