Skip to content

Lead the README with the workflow engine - #138

Open
wseaton wants to merge 1 commit into
mainfrom
readme-workflow-engine
Open

wseaton wants to merge 1 commit into
mainfrom
readme-workflow-engine

Conversation

@wseaton

@wseaton wseaton commented Sep 22, 2026

Copy link
Copy Markdown
Contributor

The README opened with the optimization loop and called the compiled graph a DAG. Neither is true of v0.3.0: the playbook lane runs the graph once without a judge, and revise plus when make execution cyclic over a task set that is still fixed at compile time.

Lead with the graph, name the playbook and autoresearch lanes, add a routing and a revise example (both compile with crucible plan compile-workflow), retitle the Argo/Tekton section, and add the controller, crux and capability crates to the layout table.

The README described crucible as an optimization loop and mentioned the graph
only as configuration for one. The graph is the thing most runs use, and a
playbook never reaches a judge at all.

The loop-free claim also predates revise rounds and routed branches. The task
set is still fixed at compile time, but execution over it is cyclic: a revise
pair re-dispatches its proposer until the reviewer stops failing, and `when`
decides at runtime whether a branch runs. Both README claims of a DAG were
wrong.

Adds compiled-and-checked route and revise examples, and lists the control
plane crates the layout table missed.

Assisted-by: Claude

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant