p9

name	p9
description	P9 — Broomva productive-wait primitive (the wait optimizer). Convert any blocking external operation — PR CI checks, push-triggered deploys, builds, long-running index ops — into work on the next priority. The reference implementation is a PR CI watcher: drains a context-scoped deferred-work queue while `gh pr checks --watch` runs in the background, classifies failures, and self-heals known categories. Non-PR waits (today) get a single direct check after kicking off next-priority work — wiring those into `p9 watch` is on the roadmap. Merge authorization stays with the existing control metalayer (.control/policy.yaml).
when_to_use	Automatically after every `git push` that opens or updates a PR. After a push that triggers a non-PR deploy: do one direct check after next work, never `sleep`. Hard rule: the agent MUST apply productive-wait discipline before `sleep` is ever an option.

P9 — Productive Wait (Wait-Optimizer Skill)

Cardinal rule

Never sleep on a blocking wait. Whether you're waiting on PR CI, a push-triggered deploy, a long build, or an index sync — convert the wait into productive work on the next priority. For PR CI, p9 watch <pr> spawns the observer in the background and the agent pulls work from the wait-queue. For non-PR waits (today), do one direct check on completion after kicking off next work. Sleep is a footgun — it burns clock time the agent could be using to validate definitions, refresh the knowledge graph, or draft the next slice.

When to invoke

Trigger	Action
git push opens or updates a PR	immediately