Skills

Watchdog

Use when configuring `rig watchdog` policies, authoring...

Install

npx skills add mvschwarz/openrig --skill watchdog -g -a claude-code -y
Repository
mvschwarz/openrig8.5k
Category
Engineering
Updated
3d ago
License
Apache-2.0
Context cost
Lightabout 1,261 tokens
Runs scripts
No, instructions only

What it does

Use when configuring `rig watchdog` policies, authoring wake/refocus/alignment-checkpoint messages, or choosing the right intervention level for a stale-owner situation. The 3-level continuity-check stack (wake / refocus / alignment-checkpoint), the discipline that prevents cadence pollution and bureaucracy theater, and the artifact-pool loop-edge pattern for evidence-aware waking.

Watchdog

Continuity checks are timed or evidence-triggered interventions that keep an agent workflow from going idle, drifting, or entering needless bureaucracy. They operationalize the refocus doctrine.

Use this when

  • Authoring a watchdog policy for a long-running rig (artifact-pool edges, stale-owner detection, periodic reminders).
  • Choosing the intervention level for a stale-owner situation: is this a wake, a refocus, or an alignment checkpoint?
  • Drafting wake/refocus/alignment-checkpoint message text that prevents cadence pollution and bureaucracy theater.
  • Deciding cadence, scan vs wake intervals, conservative vs aggressive nudging.

Don't use this when

  • The agent is actively working and closing artifacts. Prefer no-op.
  • The intervention is masking bad startup or workflow design, fix the underlying cause, don't compensate via watchdog.
  • The work has a clear next-action handoff already in queue. Use queue nudges instead of a watchdog policy.

The 3-level intervention stack

LevelGoalWhenWhat it does
WakeRestart motionOwner appears idle, stale, blocked, or missing a next handoffSmall liveness nudge, does NOT reframe the work
RefocusCorrect driftOutput shows mode drift, approval regression, weak stop-condition reasoningMedium alignment nudge, re-centers on role, north star, current approved workstream, coordination mode, stop conditions; does NOT interrupt valid work
Alignment checkpointRebuild shared mapPhase boundary, lifecycle mutation, product-intent decision, confusing contradictionLarger deliberate pause, agent runs full refocus before proceeding

cron, timers, and rig watchdog are scheduling substrates. They should NOT imply that every tick means the same semantic action. The intervention level is chosen by evidence, not cadence.

Current best practice for refocus message text

A well-shaped refocus message:

Read the whole SKILL.md on GitHub

More in Engineering