Add project-heartbeat skill skeleton

skills/project-heartbeat/references/check-order.md

@@ -0,0 +1,30 @@
+# Heartbeat timeout check order
+
+When the 10-minute timer expires:
+
+1. Check worker/session traces
+   - session history
+   - recent/active subagents
+   - visible logs / evidence points
+
+2. Check task state
+   - CURRENT_STATE.md
+   - planned / dispatching / in_progress / blocked / reviewing / done
+
+3. Check known blocker buckets
+   - launch
+   - model
+   - auth
+   - tool
+   - path/repo
+   - scope
+   - policy/review
+   - external
+
+4. Produce a user-visible update
+   - who
+   - status
+   - output
+   - next
+
+Prefer precise failure language over passive waiting language.

skills/project-heartbeat/references/state-machine.md

@@ -0,0 +1,21 @@
+# Project heartbeat state machine
+
+## States
+- idle
+- armed
+- checking
+- closed
+
+## Normal flow
+1. main sends a project-progress update -> `armed`
+2. 10-minute silence timer runs
+3. meaningful update arrives before timeout -> reset timer, remain `armed`
+4. timeout fires -> `checking`
+5. main inspects workers/project state and sends user-visible update
+6. if still active -> back to `armed`
+7. if done/paused/failed/cancelled -> `closed`
+
+## Failure patterns
+- no worker trace after supposed dispatch -> `blocked (launch failure)`
+- ETA missed with no milestone -> `blocked (stalled)`
+- model/auth/tool/path issues -> `blocked` with explicit reason