🎯 OrchestKit Γ— Dynamic Workflows β€” Verified Adoption Plan

Cookbook 08 + last-30-days field research + official CC docs verification Β· mapped to milestone #164 v10.0.0 "Convergence & Correctness" Β· 2026-08-11
πŸ“‹ 9 plan items βœ… 7 verified vs official docs 🟑 1 partial Β· 1 n/a 🏁 v10 #164: 20 open / 71 closed πŸ’° total β‰ˆ 4 days

TLDR

OrchestKit already knows most of what the cookbook teaches and exceeds it on adversarial verification. The real wins are three: an evidence-replay gate aimed at the actual wrong-finding defect (schemas alone guarantee well-shaped wrongness), CC 2.1.224 cross-session edges (the honest core of the "graph engineering" trend, the rest is rebrand), and shipping the 3 committed workflow templates via the official plugin workflows/ directory, which ork does not use today. Everything maps into v10's two lanes: EPIC D adopt-CC-capabilities and the correctness mandate. Nothing here opens a new workstream.

πŸ“‹ The Plan β€” 9 items, ranked, verified, v10-mapped

Every row was checked against a primary source: the official workflows doc, the cross-session messaging doc, or the upstream CHANGELOG.

#ItemTargetVerifiedv10 fitCost
1 πŸ₯‡Evidence-replay gate on producer findings. Every finding schema carries {file,line,quote} or {command,expected_output}; the orchestrator deterministically re-opens the line or re-runs the command BEFORE any verdict. Judgment-only findings route to the existing refutation quorum. Extends citation-verify (Β§3) from refuter verdicts to first-pass findings.shared/rules/ + verify, assess, review-prβœ… field evidencearXiv + SWE-benchCorrectness lane Β· sibling of #3418~1 day
2 πŸ•ΈοΈPattern 10: cross-session edges. ListAgents + SendMessage between sessions/worktrees. Contract notes from the doc: text-only, loop-throttled, 50-unread cap, inbound can be held/refused via crossSessionInbound, -p workers need accept in --settings, bare mode binds no socket. Hard rule: NEVER an edge producerβ†’refuter (blindness Β§9).chain-patterns/SKILL.mdβœ… official doc2.1.224EPIC D #3309~Β½ day
3 πŸ“¦Ship workflow templates via the plugin workflows/ dir β†’ /ork:audit-mapreduce, /ork:skill-fitness, /ork:heal-loop. Official distribution, args supported, replaces the scriptPath ritual. Pre-check claude plugin validate vs #3349.manifests/ork.json + 3 .mjsβœ… official docplugin workflowsEPIC D #3309 + #3313 reachability~Β½ day
4 πŸ“¨swarm-migrate: push, don't poll. Workers message the coordinator on CI state change; .swarm-state.json stays the durable record (doc confirms delivery is NOT guaranteed: hold/refuse). Honors the no-gh-watch-polling rule.swarm-migrate/SKILL.md:126βœ… mechanismheld-msg nuance foldedEPIC C #3308 retire polling loop~1 day
5 πŸ“–Import the official 4-column "who holds the plan" table (subagents / skills / agent teams / workflows) incl. the interruption row: workflow resume is same-session only; ork handoff files resume cross-session. Supersedes the cookbook's 3-column version.chain-patterns/references/dynamic-workflow-patterns.mdβœ… official docdocs correctness15 lines
6 πŸ”Pattern 8 refresh: dynamic /loop (self-paced ScheduleWakeup, long fallback heartbeat, never short-interval polling of harness-tracked work).chain-patterns/SKILL.md:191🟑 harness-known; verify vs /loop doc page when writingEPIC D adjacent Β· M161doc-only
7 5️⃣Spawn-cap-removed note. CHANGELOG 2.1.224 verbatim: "Removed the 200-subagent-per-session spawn cap". Ork's depth-3 budget + refuter cap Β§8 are now the only brake. Fold into #3324, no new issue.chain-patterns/SKILL.md:240βœ… CHANGELOG verbatimcomment on #33241 line
8 🎯Conditional refuter spawn in the mapreduce template: filter in plain JS, refute only confirmed/decision-bearing findings. Composes with the Β§8 spawn cap.audit-full/workflows/audit-full-mapreduce.mjsβœ… cookbook patterncorrectness + cost hygienesmall edit
⏸️SKIP: wrapping implement / verify / swarm-migrate as workflows. Officially reinforced: "No mid-run user input… For sign-off between stages, run each stage as its own workflow." Interactive gates, CI gates, and cross-session resume are load-bearing.β€”βœ… official docEPIC C spirit: no 10th mechanismzero

πŸ•ΈοΈ Graph diff: swarm coordination topology (CC 2.1.224)

The one real thing inside the "graph engineering" buzz: context does not flow between nodes unless you design the edge. Before: the coordinator pulls a shared ledger between waves. After: workers push text edges; the ledger stays as the durable record because inbound delivery can be held or refused.

Before β€” poll the ledger

After β€” message edges + durable ledger

The five diffs, in one place

πŸ₯‡ Pattern 10 β€” chain-patterns/SKILL.md
- Pattern 7: SendMessage resumes agents IN-SESSION only; sibling sessions coordinate via shared files + polling
+ Pattern 10: sessions discover peers via ListAgents and push text edges via SendMessage (CC 2.1.224)
πŸ“¨ swarm push β€” swarm-migrate/SKILL.md:126
- coordinator re-reads .swarm-state.json between waves (pull; latency = poll interval)
+ worker: SendMessage(to=coordinator, "repo X: CI green, PR #42 merged") β€” push; ledger unchanged
πŸ” dynamic /loop β€” chain-patterns/SKILL.md:191
- /loop 5m gh pr checks 42 (fixed interval, user picks cadence)
+ /loop gh pr checks 42 (self-paced: model schedules wakeups, 1200s+ fallback)
πŸ—ΊοΈ edge map β€” implement/SKILL.md:293
- | After Phase 1 | 01-discovery.json | Best practices, task breakdown |
+ | After Phase 1 | 01-discovery.json | Best practices, task breakdown | read by: Phase 2, 4 |
5️⃣ cap note β€” chain-patterns/SKILL.md:240
- CC hard-caps spawns at 200/session (implicit backstop)
+ no upstream cap since 2.1.224 β€” ork budgets are the only brake; respect them

πŸ”¬ Verification diff: how a confident, WRONG finding travels

Today (schema + quorum): a well-shaped wrong verdict validates perfectly and reaches the quorum, where same-model refuters share blind spots β€” roughly the observed ~50% re-verification failure. Ideal (evidence + replay): checkable evidence is mechanically replayed before any verdict; only judgment-only findings carry residual risk, and those go to the quorum.

Before β€” today on main 🟑

After β€” with the replay gate 🟒

⚠️ Caveat, straight from the field: SWE-bench Verified was deprecated in Feb 2026 because 59.4% of its hardest tasks had flawed tests that rejected correct solutions. Replay is only as good as the cited evidence; a wrong test replayed faithfully is still wrong. Pair replay with the cross-model quorum lane (§11) on the evidence itself.

πŸ“Š Cookbook vs OrchestKit delta

DimensionCookbookOrchestKitWinner
Pattern taxonomy1 pattern (fan-out + skeptic)6 patterns + failure-mode selector
chain-patterns/references/dynamic-workflow-patterns.md
🟒 ours
Skeptic pass1 refuter, no gatesBlindness contract, quorum, citation-verify, no-auto-flip
shared/rules/adversarial-refutation.md
🟒 ours
schema usageexplains it, toy exampleshipped in 3 templates + "big schemas flake" scar
audit-full-mapreduce.mjs:89
🟒 ours
Parse safety / model tiers / quarantineabsentdynamic-workflow-patterns.md:16-52, 81-114, 139🟒 ours
State between stagesscript variables (free, in-run)handoff JSON survives session death; workflow resume is same-session only (official doc)
implement/SKILL.md:289 Β· chain-patterns P2/P3
🟑 split
Who-holds-the-plan table3-column tableone-line "5-minute test" β€” and the OFFICIAL doc now has a richer 4-column version to import (plan item 5)πŸ”΄ theirs
Enforced verificationstructural (code sequences it)instruction the model must remember
implement/SKILL.md:396
πŸ”΄ theirs
Interactive / CI gates, ledgersimpossible in background workflows (official: no mid-run input)deliberate + documented
swarm-migrate/SKILL.md:44
🟒 ours

🌐 Field notes β€” last 30 days (2026-07-12 β†’ 2026-08-11)

From the last30days run: 48 items across Reddit, HN, YouTube, GitHub (top voices r/ClaudeCode, r/ClaudeAI, r/ChatGPTCoding) plus web supplements.

FindingSourceValidates
Verification is becoming HARDER than producing solutions; passing tests are a weak proxy ("The Verification Horizon")arXivplan #1 + quorum
SWE-bench Verified deprecated Feb 2026: 59.4% of hardest tasks had flawed tests rejecting CORRECT solutionsTechTimesreplay caveat
Adversarial pairing (Codex ↔ Claude alternating maker/checker) caught DIFFERENT error classes; cross-model beats same-model redundancyAugment Codequorum Β§11 lane
"A $0.02 task becomes a $2.00 task after five or six hops"; agent teams β‰ˆ 7x tokens. Fixes: Haiku sub-agents, scope bounding, token budgetsMindStudioplan #8 + model tiers
~10 agents with sharp descriptions delegate more reliably than 100 with fuzzy onesdev.tocatalog discipline
Prompt-level safety/verification instructions: near-zero returns on strong models (+0.4 / +0.3 / βˆ’0.3). Structure beats instructionsNerd Level Techthe whole plan
"Graph engineering" went viral July 2026 as the sequel to loop engineering; ~80% rebrand of DAG + handoff discipline, benchmark stats borrowed from graph-RAGThe AI Operatorskip the DSL, keep item 2

🧠 The honest answer: schemas vs correctness

Schema enforcement does not fix the wrong-finding defect. The retry loop fires on shape mismatch only; {verdict:"confirmed", quote:"…"} with a misread quote validates perfectly. What schemas do buy: they kill parse-layer wrongness, and they force the agent to commit to falsifiable evidence fields. That second property is only worth something if something then checks the field β€” which is plan item #1. The conversion that matters: "agent asserted X" β†’ "X was mechanically reproduced or adversarially survived."