Projects Issue Lifecycle

Projects Issue Lifecycle A lifecycle diagram generated by Archify. 01 / Issue phases 02 / PR loop 03 / Hand-off to Janis Opened · no triage label yet · Issue phases · entry 01 Opened no triage label yet entry Needs Triage · poll labels it, agent verifies · Issue phases · triage 02 Needs Triage poll labels it, agent verifies triage Ready for Agent · Agent Brief is the contract · Issue phases · implement 03 Ready for Agent Agent Brief is the contract implement PR Open · conflicts, then CI, decide · Issue phases · ci 04 PR Open conflicts, then CI, decide ci Delivered · karakuri squash-merges · Issue phases · done 05 Delivered karakuri squash-merges done Resolve Conflicts · main moved — merge it in · PR loop · conflicts Resolve Conflicts main moved — merge it in conflicts Fix Build · CI red — repair and push · PR loop · repair Fix Build CI red — repair and push repair In Review · CI green — review, fix, push · PR loop · review In Review CI green — review, fix, push review Ready for Human · Kongroo asks Janis on Telegram · Hand-off to Janis · hand-off Ready for Human Kongroo asks Janis on Telegram hand-off Needs Approval · outside author, Janis says yes · Hand-off to Janis · hand-off Needs Approval outside author, Janis says yes hand-off Legend start active state waiting decision terminal success failure / exit

Karakuri drives

  • • karakuri reads GitHub and picks the Stage — never the agent
  • • One issue, one Stage, one pristine checkout; unpushed work is gone
  • • Merging is karakuri's: a squash pinned to the reviewed head SHA

Hand-off to Janis

  • • Escalations park as ready-for-human, strangers' as needs-approval
  • • Answering Kongroo swaps the labels back and the machine resumes
  • • Kongroo narrates locally — voice down, the facts still arrive

Loops that end

  • • A branch main outgrew is re-merged first — green CI or not
  • • Two Strikes on a Stage or five Rounds on a PR escalate, never loop
  • • A PR with no CI never merges — it escalates after a 15-minute grace