name: orchestra-daemon-watcher description: Build Phase 04 daemon workflows with file watching, debounce, launchd integration, and low-latency auto-sync execution.
Objective
Keep agent files continuously synchronized via a resilient background daemon.
Use This Skill When
- Implementing daemon lifecycle commands.
- Wiring file watching and debounce behavior.
- Adding launchd integration for macOS startup.
Procedure
- Start watcher for registry and managed paths.
- Debounce rapid file events per path bucket.
- Trigger sync pipeline and record event/log timing.
- Expose daemon status through socket/CLI command.
- Support install/start/stop/status with safe shutdown.
Guardrails
- Prevent deadlocks between sync and status calls.
- Skip self-generated write events where required.
- Keep event-to-sync latency below product targets.
Done Criteria
- Registry edits auto-sync within target latency.
- Rapid saves collapse into a single effective sync.
- Start/stop/install/status flows are stable and test-covered.