Workflow reference

Each workflow is a provider-neutral graph. av run <workflow> --validate proves the graph without contacting any provider; see the graph execution concept for the run lifecycle.

#bugfix-delivery

Root-cause bugfix delivery — Diagnose a defect, obtain bounded change authority, implement the cause-aligned fix, and verify it.

#Legend

• Node kinds: agent, function, human, skill, terminal
• Edge kinds: approval, cancel, failure, handoff, retry, success

#Topology

Entry points — reachable without an inbound edge:

• intake (function)

Terminal states:

• cancelled (terminal)
• complete (terminal)
• failed (terminal)

Flow (from → to):

• approve:
  • → cancelled — cancel
  • → failed — failure
  • → fix — approval
• cancelled — no outbound edges
• complete — no outbound edges
• diagnose:
  • → approve — success
  • → cancelled — cancel
  • → diagnose — retry
  • → failed — failure
• failed — no outbound edges
• fix:
  • → cancelled — cancel
  • → failed — failure
  • → fix — retry
  • → test — success
• inspect:
  • → cancelled — cancel
  • → diagnose — handoff
  • → failed — failure
• intake:
  • → failed — failure
  • → inspect — success
• review:
  • → complete — success
  • → failed — failure
• test:
  • → cancelled — cancel
  • → failed — failure
  • → review — success

#Nodes

Node	Kind	Handler
approve	human	human: change-approval
cancelled	terminal	terminal: cancelled
complete	terminal	terminal: success
diagnose	agent	agent: debugger
failed	terminal	terminal: failure
fix	skill	skill: fix
inspect	skill	skill: scout
intake	function	function: normalize-request
review	skill	skill: code-review
test	skill	skill: test

#Edges

From	To	Type
approve	cancelled	cancel
approve	failed	failure
approve	fix	approval
diagnose	approve	success
diagnose	cancelled	cancel
diagnose	diagnose	retry
diagnose	failed	failure
fix	cancelled	cancel
fix	failed	failure
fix	fix	retry
fix	test	success
inspect	cancelled	cancel
inspect	diagnose	handoff
inspect	failed	failure
intake	failed	failure
intake	inspect	success
review	complete	success
review	failed	failure
test	cancelled	cancel
test	failed	failure
test	review	success

#read-only-delivery

Read-only repository delivery — Inspect a repository, answer from evidence, and verify proof without granting mutation authority.

#Legend

• Node kinds: function, gate, skill, terminal
• Edge kinds: cancel, failure, success

#Topology

Entry points — reachable without an inbound edge:

• intake (function)

Terminal states:

• cancelled (terminal)
• complete (terminal)
• failed (terminal)

Flow (from → to):

• answer:
  • → cancelled — cancel
  • → failed — failure
  • → verify — success
• cancelled — no outbound edges
• complete — no outbound edges
• failed — no outbound edges
• inspect:
  • → answer — success
  • → cancelled — cancel
  • → failed — failure
• intake:
  • → cancelled — cancel
  • → failed — failure
  • → inspect — success
• verify:
  • → cancelled — cancel
  • → complete — success
  • → failed — failure

#Nodes

Node	Kind	Handler
answer	skill	skill: ask
cancelled	terminal	terminal: cancelled
complete	terminal	terminal: success
failed	terminal	terminal: failure
inspect	skill	skill: scout
intake	function	function: normalize-request
verify	gate	gate: evidence-complete

#Edges

From	To	Type
answer	cancelled	cancel
answer	failed	failure
answer	verify	success
inspect	answer	success
inspect	cancelled	cancel
inspect	failed	failure
intake	cancelled	cancel
intake	failed	failure
intake	inspect	success
verify	cancelled	cancel
verify	complete	success
verify	failed	failure

#safe-change-delivery

Safe repository change delivery — Plan, approve, apply, test, and review a bounded workspace change with explicit fallback and idempotency.

#Legend

• Node kinds: agent, function, human, skill, terminal, tool
• Edge kinds: approval, cancel, conditional, failure, handoff, retry, success

#Topology

Entry points — reachable without an inbound edge:

• intake (function)

Terminal states:

• cancelled (terminal)
• complete (terminal)
• decline (terminal)
• failed (terminal)

Flow (from → to):

• apply:
  • → apply — retry
  • → cancelled — cancel
  • → failed — failure
  • → test — success
• approve:
  • → apply — approval
  • → cancelled — cancel
  • → failed — failure
• assess:
  • → approve — conditional
  • → cancelled — cancel
  • → decline — conditional
  • → failed — failure
• cancelled — no outbound edges
• complete — no outbound edges
• decline — no outbound edges
• failed — no outbound edges
• intake:
  • → failed — failure
  • → plan — success
• plan:
  • → assess — handoff
  • → cancelled — cancel
  • → failed — failure
• review:
  • → complete — success
  • → failed — failure
• test:
  • → cancelled — cancel
  • → failed — failure
  • → review — success

#Nodes

Node	Kind	Handler
apply	tool	tool: workspace.apply
approve	human	human: change-approval
assess	agent	agent: code-reviewer
cancelled	terminal	terminal: cancelled
complete	terminal	terminal: success
decline	terminal	terminal: declined
failed	terminal	terminal: failure
intake	function	function: normalize-request
plan	skill	skill: cook
review	skill	skill: code-review
test	skill	skill: test

#Edges

From	To	Type
apply	apply	retry
apply	cancelled	cancel
apply	failed	failure
apply	test	success
approve	apply	approval
approve	cancelled	cancel
approve	failed	failure
assess	approve	conditional
assess	cancelled	cancel
assess	decline	conditional
assess	failed	failure
intake	failed	failure
intake	plan	success
plan	assess	handoff
plan	cancelled	cancel
plan	failed	failure
review	complete	success
review	failed	failure
test	cancelled	cancel
test	failed	failure
test	review	success