Ship the issue-sweep pipeline as a runnable workflow script - #59
Merged
Conversation
The skill described the per-item chain in prose and every sweep re-derived a script from it. This commits the harness: a worker pool that holds recon's concurrency cap, each item chained plan, build, review, one fix round, verify, with everything repo- and machine-specific arriving through args. Close of run stays with the orchestrator, as the skill says. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
nonrational
approved these changes
Sep 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
The
issue-sweepskill describes its per-item pipeline (plan → build → review → fix → verify) in prose and a stage-prompt reference, but ships no executable. Every sweep re-derives a Workflow script from that prose, and the script then dies in a session directory on a disposable machine.Motivation
Two sweeps in two nights re-wrote the same harness. The workflow rule added in #21 says a session that produces a reusable executable commits it into the package it serves, parameterized and scrubbed.
risk-sweepalready ships its script this way;issue-sweepshould match.Proposed Solution
Add
scripts/workflow.jsbeside the skill and a Reference bullet pointing at it. The script is a worker pool that holds recon's concurrency cap (each item still walks its own stages end to end, no barrier between items), with the five stage prompts assembled from the skill's recipes. Everything repo- and machine-specific arrives throughargs: repo, checkout path, default branch, the shared context block from recon, the tracker disclaimer line, worker count, the build model's trailer name, and the items with their hints, dependency lists, and optionally a committed plan path plus orchestrator overrides. An item withplanPathswitches stage 1 into "confirm the committed plan and brief the deviations" mode. Close of run (CI judged once, promotion, cleanup check, the report) stays with the orchestrator, as the skill says.Verified by running this exact pipeline shape on a four-item sweep the same night (14 agents, no errors, four reviewed PRs), then parameterizing the repo-specific strings out. Syntax-checked under the same async wrapper the harness applies.
Feedback
Two calls worth a second opinion. First, the worker pool instead of
pipeline(): the harness already caps concurrency, but the pool makes "N items in flight" the orchestrator's number rather than an incidental one, at the cost of a few lines. Second, review and verify inherit the session model by default rather than taking an explicit tier, on the reasoning that the orchestrator runs on the strongest tier available and those two stages must too. Say if you would rather both be explicit args.