Workfly

Workfly

Use workfly when a procedure worth repeating — a skill, a runbook, a review ritual, a migration sweep — should become a saved workflow that any body runs unmodified. A procedure that needs the user in the middle of the run stays a skill; workfly encodes the part that can run on its own.

Workfly is a saved workflow, not a procedure this skill performs inline. The single source of truth is .claude/workflows/workfly.js in the genie repository's canonical workflow catalog (see .claude/workflows/README.md there); this skill is its front door. On a runtime that runs saved workflows, run the script at <repository root>/.claude/workflows/workfly.js when that file exists, otherwise ~/.claude/workflows/workfly.js (delivered by genie install / genie update); give the runtime that explicit script path, never a bare name — both scopes now carry these names and the order a name resolves in is undocumented. The orchestrator — the session model — specifies the objective and relays the result; the script is written by the workflow's own author agent, never drafted inline in the session.

Invoke

Pass {objective, sources?, name?, catalogDir?, model?, maxRepairs?, timestamp?} through args. Sources are repository-relative paths to whatever already describes the procedure — a runbook, a workflow README, or the review skill's own SKILL.md as it sits in this repository. name is kebab and the workflow checks it against every name already taken; catalogDir defaults to .claude/workflows and is the only directory the contract suite covers, so any other value comes back as a recorded coverage gap rather than a pass; maxRepairs is the repair budget — 2 when unset or not an integer, otherwise clamped to 0-3, so a larger value buys nothing; timestamp is the provenance stamp for the drafted script's header comment, and the workflow has no clock, so the caller is its only source. Everything else keeps its default.

args: {
  objective: "turn the nightly release-ledger sweep into a saved workflow",
  sources:   ["docs/_internal/release-ledger.md"],
  name:      "ledger-sweep",
  model:     "opus",
  timestamp: "2026-09-15T10:00:00Z"
}

Relay

A run that reached verification returns {ok, name, path, spec, readmeRow, frontDoor, parityGuard, verification, repairs, notConvened}. Relay verification unchanged: the static result, both refuters with their blocking and advisory findings intact, and ran, which names the lenses that answered — ok is never true while one of the three is silent. List notConvened — it holds exactly one kind of entry, an agent that returned nothing, counted as unverified and never as a pass; every other stop is reported through error.

A finding naming any file other than the drafted script — the catalog README row, the fronting skill, the parity test — always arrives as advisory, because those are the landing steps below and the repairer may edit only the script, so ok: false always names a defect in the script itself.

Read ok: false twice, because two shapes carry it. A run that stopped early returns {ok: false, error} and no verification: the objective was missing, a required reading did not answer or came back empty (no existing name reported is read as a failed reading, never as "every name is free"), the designer returned nothing or a SPEC with no name or a name that is not a single kebab slug, the author returned nothing, or the name was already taken. When the author returned nothing the error names the target path — check it for a partial write before re-running; every other early stop drafted nothing. Restate the objective, free the name, or re-run. A verified ok: false carries every surviving blocking finding in verification.blocking — including one the workflow synthesizes when a refuter answered refuted: true without naming a defect, so a bare refutation is never silent — and the static gate's own problems, which is where a non-default catalogDir reports that the contract suite never opened the drafted file. Read them, then decide whether to raise maxRepairs, change the objective, or land the fixes by hand.