Drive one GitHub issue through the full self-driving lifecycle in an isolated
worktree: investigate, plan, implement, verify, review, PR, wait for CI, and
clean up. Every phase is gated and every state transition goes through the
gh_issue_run.py state machine, never a hand edit. Dispatches the implementer
and the four review subagents; does not merge its own PR.
2026-07-23
The top-level self-driving loop. Orients against repo and run state, resumes
an active run or selects the highest-priority unblocked GitHub issue, routes
large issues through /gh-runbook and the rest straight to /gh-issue, drives
the issue to a green PR against dev through gated subagent phases, mirrors the
review locally with /gh-review, records lessons, and squash-merges only after
rechecking the completed run and current GitHub state. One issue per
invocation.
2026-07-23
A local pull-request review that mirrors the CI review criteria so self-review
and CI cannot drift: build, lint, tests, architecture, and the leak scan, run
through the same scripts CI runs. Works on a PR number or on the local diff
dev...HEAD. Sorts the diff into file buckets and ends with exactly one verdict.
2026-07-21
Turn an audit, a scope, or a large issue into a parent runbook plus a set of
grouped child issues. Produces a plan and a child-issue manifest (title, body,
labels, milestone, blocked-by), then creates them with a script that dry-runs
by default and only writes to GitHub when --apply is passed. Feeds /work.
2026-07-21