Roark · Specimen SheetFolio iii — mmxxvi← Index
01
Chap. I
de operatione
System ⟶ Hello, operator.v 0.1.x

An agent that reads the issue,
drafts the work, & hands the merge
back to you.

Label an issue afk. Roark claims it, drafts a plan, implements the change on a dedicated branch, then submits its own diff to two independent review agents in succession. A configurable number of fix-and-review loops follow.

⁂
Fig. 02 — Specimen of the verbs
Fraunces · soft 100 · wonk 1
fetch.triage.plan.implement.review.fix.ready.verify.ship.
§ Installation

The library is small. The command is shorter than the README. Drive it fromcron, launchd, or Actions.

$bun add -g roark-coding-agentcmd 1
$roark auto --repo owner/repo --limit 1
02
Chap. II
de itinere

The route, in nine stages.


   ┌──────┐    ┌────────┐    ┌──────┐    ┌───────────┐    ┌─────────┐
   │FETCH │──▶│ TRIAGE │──▶│ PLAN │──▶│ IMPLEMENT │──▶│ REVIEW  │──┐
   └──────┘    └────────┘    └──────┘    └───────────┘    └─────────┘  │
                                                                       │
   ┌─────────┐    ┌────────────┐    ┌─────────┐    ┌──────────┐       │
   │ DRAFT-PR│◀──│  VERIFY ⊕  │◀──│READINESS│◀──│   FIX*   │◀─────┘
   └─────────┘    └────────────┘    └─────────┘    └──────────┘
fig. 03 — workflow ⊳ do(issue)⊕ = both gates required
  1. i.FetchFETCHPull issue body, comments, native dependency graph.
  2. ii.TriageTRIAGEVerdict — proceed, blocked, reject, needs-human.
  3. iii.PlanPLANA step-by-step plan, written for the next agent.
  4. iv.ImplementIMPLEMENTEdits land on roark/issue-⟨n⟩, branched from main.
  5. v.ReviewREVIEW × 2Two independent review agents pass over the diff.
  6. vi.FixFIXUp to N cycles, numbered, each one re-reviewed.
  7. vii.ReadinessREADINESSSelf-assessed status: ready-for-pr, or stop.
  8. viii.VerifyVERIFYYour gate command. Exit code zero, or no PR.
  9. ix.Draft PRDRAFT-PRgh pr create --draft. The merge is yours.
§ The gates

Both must open.

i — readiness

readiness.md must declare ## Status: ready-for-pr. Anything else — the gate stays shut.

ii — verify

--verify runs via sh -c. Exit code 0, or no PR is opened, ever.

¶ Manifesto
“The work happens overnight; the judgment, in the morning. We are not in a hurry to take the merge button away from the engineer who must live with it.”
§ Continue

Go afk.

Clone the repositorygithub ↗Read the documentationdocs ↗